Class: Jekyll::Site

Inherits:
Object
  • Object
show all
Defined in:
lib/jekyll/polyglot/patches/jekyll/site.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#active_lang ⇒ Object

Returns the value of attribute active_lang.



7
8
9
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 7

def active_lang
  @active_lang
end

#default_lang ⇒ Object (readonly)

Returns the value of attribute default_lang.



6
7
8
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 6

def default_lang
  @default_lang
end

#exclude_from_localization ⇒ Object (readonly)

Returns the value of attribute exclude_from_localization.



6
7
8
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 6

def exclude_from_localization
  @exclude_from_localization
end

#file_langs ⇒ Object

Returns the value of attribute file_langs.



7
8
9
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 7

def file_langs
  @file_langs
end

#lang_vars ⇒ Object (readonly)

Returns the value of attribute lang_vars.



6
7
8
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 6

def lang_vars
  @lang_vars
end

#languages ⇒ Object (readonly)

Returns the value of attribute languages.



6
7
8
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 6

def languages
  @languages
end

Instance Method Details

#absolute_url_regex(url, disabled = false) ⇒ Object

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.



241
242
243
244
245
246
247
248
249
250
251
252
253
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 241

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'
  %r{(?<!hreflang="#{@default_lang}" )#{start}="?#{url}#{@baseurl}/((?:#{regex}[^,'"\s/?.]+\.?)*(?:/[^\]\[)("'\s]*)?)"}
end

#assignPageLanguagePermalinks(doc, docs) ⇒ Object 



174
175
176
177
178
179
180
181
182
183
184
185
186
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 174

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

#assignPageRedirects(doc, docs) ⇒ Object 



160
161
162
163
164
165
166
167
168
169
170
171
172
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 160

def assignPageRedirects(doc, docs)
  pageId = doc.data['page_id']
  if !pageId.nil? && !pageId.empty?
    lang = doc.data['lang'] || derive_lang_from_path(doc) || @default_lang
    langPrefix = lang === @default_lang ? '' : "#{lang}/"
    redirectDocs = docs.select do |dd|
      doclang = dd.data['lang'] || derive_lang_from_path(dd) || @default_lang
      dd.data['page_id'] == pageId && doclang != lang && dd.data['permalink'] != doc.data['permalink']
    end
    redirects = redirectDocs.map { |dd| dd.data['permalink'] }
    doc.data['redirect_from'] = redirects
  end
end

#coordinate_documents(docs) ⇒ Object

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



133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 133

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.values.each {|doc| assignPageRedirects(doc, docs) }
  approved.values.each {|doc| assignPageLanguagePermalinks(doc, docs) }
  approved.values
end

#correct_nonrelativized_absolute_urls(doc, regex, url) ⇒ Object 



271
272
273
274
275
276
277
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 271

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

#correct_nonrelativized_urls(doc, regex) ⇒ Object 



279
280
281
282
283
284
285
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 279

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

#derive_lang_from_path(doc) ⇒ Object 



111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 111

def derive_lang_from_path(doc)
  unless @lang_from_path
    return nil
  end

  segments = doc.relative_path.split('/')
  if doc.relative_path[0] == '_' \
    && segments.length > 2 \
    && segments[1] =~ /^[a-z]{2,3}(:?[_-](:?[A-Za-z]{2}){1,2}){0,2}$/
    return segments[1]
  elsif segments.length > 1 \
    && segments[0] =~ /^[a-z]{2,3}(:?[_-](:?[A-Za-z]{2}){1,2}){0,2}$/
    return segments[0]
  end

  nil
end

#document_url_regex ⇒ Object

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



210
211
212
213
214
215
216
217
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 210

def document_url_regex
  regex = ''
  (@languages || []).each do |lang|
    regex += "([\/\.]#{lang}[\/\.])|"
  end
  regex.chomp! '|'
  /#{regex}/
end

#fetch_languages ⇒ Object 



23
24
25
26
27
28
29
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 23

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

#prepare ⇒ Object 



9
10
11
12
13
14
15
16
17
18
19
20
21
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 9

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

#process ⇒ Object 



32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 32

def process
  prepare
  all_langs = (@languages + [@default_lang]).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 |lang, pid|
            next unless waitpid pid, Process::WNOHANG

            pids.delete lang
            raise "Polyglot subprocess #{pid} (#{lang}) failed (#{$?.exitstatus})" unless $?.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

#process_active_language ⇒ Object 



100
101
102
103
104
105
106
107
108
109
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 100

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

#process_default_language ⇒ Object 



94
95
96
97
98
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 94

def process_default_language
  old_include = @include
  process_orig
  @include = old_include
end

#process_documents(docs) ⇒ Object

performs any necessary operations on the documents before rendering them



189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 189

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

#process_language(lang) ⇒ Object 



81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 81

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

#process_orig ⇒ Object 



31
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 31

alias process_orig process

#relative_url_regex(disabled = false) ⇒ Object

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.



223
224
225
226
227
228
229
230
231
232
233
234
235
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 223

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

#relativize_absolute_urls(doc, regex, url) ⇒ Object 



263
264
265
266
267
268
269
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 263

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

#relativize_urls(doc, regex) ⇒ Object 



255
256
257
258
259
260
261
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 255

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

#site_payload ⇒ Object 



70
71
72
73
74
75
76
77
78
79
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 70

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

#site_payload_orig ⇒ Object 



69
 
# File 'lib/jekyll/polyglot/patches/jekyll/site.rb', line 69

alias site_payload_orig site_payload