class Jekyll::Site
Attributes
Public Instance Methods
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 253 def absolute_url_regex(url, disabled = false) regex = '' unless disabled @exclude.each do |x| regex += "(?!#{x})" end @languages.each do |x| regex += "(?!#{x}/)" end end start = disabled ? 'ferh' : 'href' neglookbehind = disabled ? "" : "(?<!hreflang=\"#{@default_lang}\" |rel=\"canonical\" )" %r{#{neglookbehind}#{start}="?#{url}#{@baseurl}/((?:#{regex}[^,'"\s/?.]+\.?)*(?:/[^\]\[)("'\s]*)?)"} end
a regex that matches absolute urls in a html document matches href=“baseurl/foo/bar-baz” and others like it avoids matching excluded files. prepare makes sure that all @exclude dirs have a trailing slash.
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 186 def assignPageLanguagePermalinks(doc, docs) pageId = doc.data['page_id'] if !pageId.nil? && !pageId.empty? unless doc.data['permalink_lang'] then doc.data['permalink_lang'] = {} end permalinkDocs = docs.select do |dd| dd.data['page_id'] == pageId end permalinkDocs.each do |dd| doclang = dd.data['lang'] || derive_lang_from_path(dd) || @default_lang doc.data['permalink_lang'][doclang] = dd.data['permalink'] end end end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 167 def assignPageRedirects(doc, docs) pageId = doc.data['page_id'] if !pageId.nil? && !pageId.empty? redirects = [] docs_with_same_id = docs.select { |dd| dd.data['page_id'] == pageId } # For each document with the same page_id docs_with_same_id.each do |dd| # Add redirect if it's a different permalink if dd.data['permalink'] != doc.data['permalink'] redirects << dd.data['permalink'] end end doc.data['redirect_from'] = redirects end end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 138 def coordinate_documents(docs) regex = document_url_regex approved = {} docs.each do |doc| lang = doc.data['lang'] || derive_lang_from_path(doc) || @default_lang lang_exclusive = doc.data['lang-exclusive'] || [] url = doc.url.gsub(regex, '/') page_id = doc.data['page_id'] || url doc.data['permalink'] = url if doc.data['permalink'].to_s.empty? && !doc.data['lang'].to_s.empty? # skip entirely if nothing to check next if @file_langs.nil? # skip this document if it has already been processed next if @file_langs[page_id] == @active_lang # skip this document if it has a fallback and it isn't assigned to the active language next if @file_langs[page_id] == @default_lang && lang != @active_lang # skip this document if it has lang-exclusive defined and the active_lang is not included next if !lang_exclusive.empty? && !lang_exclusive.include?(@active_lang) approved[page_id] = doc @file_langs[page_id] = lang end approved.each_value do |doc| assignPageRedirects(doc, docs) assignPageLanguagePermalinks(doc, docs) end approved.values end
assigns natural permalinks to documents and prioritizes documents with active_lang
languages over others. If lang is not set in front matter, then this tries to derive from the path, if the lang_from_path
is set. otherwise it will assign the document to the default_lang
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 284 def correct_nonrelativized_absolute_urls(doc, regex, url) return if doc.output.nil? modified_output = doc.output.dup modified_output.gsub!(regex, "href=\"#{url}#{@baseurl}/\\1\"") doc.output = modified_output end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 292 def correct_nonrelativized_urls(doc, regex) return if doc.output.nil? modified_output = doc.output.dup modified_output.gsub!(regex, "href=\"#{@baseurl}/\\1\"") doc.output = modified_output end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 118 def derive_lang_from_path(doc) unless @lang_from_path return nil end segments = split_on_multiple_delimiters(doc.path) # loop through all segments and check if they match the language regex segments.each do |segment| if @languages.include?(segment) return segment end end nil end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 222 def document_url_regex regex = '' (@languages || []).each do |lang| regex += "([/.]#{lang}[/.])|" end regex.chomp! '|' /#{regex}/ end
a regex that matches urls or permalinks with i18n prefixes or suffixes matches /en/foo , .en/foo , foo.en/ and other simmilar default urls made by jekyll when parsing documents without explicitly set permalinks
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 24 def fetch_languages @default_lang = config.fetch('default_lang', 'en') @languages = config.fetch('languages', ['en']).uniq @keep_files += (@languages - [@default_lang]) @active_lang = @default_lang @lang_vars = config.fetch('lang_vars', []) end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 10 def prepare @file_langs = {} fetch_languages @parallel_localization = config.fetch('parallel_localization', true) @lang_from_path = config.fetch('lang_from_path', false) @exclude_from_localization = config.fetch('exclude_from_localization', []).map do |e| if File.directory?(e) && e[-1] != '/' "#{e}/" else e end end end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 33 def process prepare all_langs = ([@default_lang] + @languages).uniq if @parallel_localization nproc = Etc.nprocessors pids = {} begin all_langs.each do |lang| pids[lang] = fork do process_language lang end while pids.length >= (lang == all_langs[-1] ? 1 : nproc) sleep 0.1 pids.map do |pid_lang, pid| next unless waitpid pid, Process::WNOHANG pids.delete pid_lang raise "Polyglot subprocess #{pid} (#{lang}) failed (#{$CHILD_STATUS.exitstatus})" unless $CHILD_STATUS.success? end end end rescue Interrupt all_langs.each do |lang| next unless pids.key? lang puts "Killing #{pids[lang]} : #{lang}" kill('INT', pids[lang]) end end else all_langs.each do |lang| process_language lang end end Jekyll::Hooks.trigger :polyglot, :post_write end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 101 def process_active_language old_dest = @dest old_exclude = @exclude @file_langs = {} @dest = "#{@dest}/#{@active_lang}" @exclude += @exclude_from_localization process_orig @dest = old_dest @exclude = old_exclude end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 95 def process_default_language old_include = @include process_orig @include = old_include end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 201 def process_documents(docs) # return if @active_lang == @default_lang url = config.fetch('url', false) rel_regex = relative_url_regex(false) abs_regex = absolute_url_regex(url, false) non_rel_regex = relative_url_regex(true) non_abs_regex = absolute_url_regex(url, true) docs.each do |doc| unless @active_lang == @default_lang then relativize_urls(doc, rel_regex) end correct_nonrelativized_urls(doc, non_rel_regex) if url unless @active_lang == @default_lang then relativize_absolute_urls(doc, abs_regex, url) end correct_nonrelativized_absolute_urls(doc, non_abs_regex, url) end end end
performs any necessary operations on the documents before rendering them
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 82 def process_language(lang) @active_lang = lang config['active_lang'] = @active_lang lang_vars.each do |v| config[v] = @active_lang end if @active_lang == @default_lang then process_default_language else process_active_language end end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 235 def relative_url_regex(disabled = false) regex = '' unless disabled @exclude.each do |x| regex += "(?!#{x})" end @languages.each do |x| regex += "(?!#{x}/)" end end start = disabled ? 'ferh' : 'href' %r{#{start}="?#{@baseurl}/((?:#{regex}[^,'"\s/?.]+\.?)*(?:/[^\]\[)("'\s]*)?)"} end
a regex that matches relative urls in a html document matches href=“baseurl/foo/bar-baz” href=“/foo/bar-baz” and others like it avoids matching excluded files. prepare makes sure that all @exclude dirs have a trailing slash.
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 276 def relativize_absolute_urls(doc, regex, url) return if doc.output.nil? modified_output = doc.output.dup modified_output.gsub!(regex, "href=\"#{url}#{@baseurl}/#{@active_lang}/\\1\"") doc.output = modified_output end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 268 def relativize_urls(doc, regex) return if doc.output.nil? modified_output = doc.output.dup modified_output.gsub!(regex, "href=\"#{@baseurl}/#{@active_lang}/\\1\"") doc.output = modified_output end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 71 def site_payload payload = site_payload_orig payload['site']['default_lang'] = default_lang payload['site']['languages'] = languages payload['site']['active_lang'] = active_lang lang_vars.each do |v| payload['site'][v] = active_lang end payload end
Source
# File lib/jekyll/polyglot/patches/jekyll/site.rb, line 112 def split_on_multiple_delimiters(string) delimiters = ['.', '/'] regex = Regexp.union(delimiters) string.split(regex) end