1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
|
<!DOCTYPE html>
<html lang="en-us">
<head>
<link href="http://gmpg.org/xfn/11" rel="profile">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="title" content="Home · Polyglot">
<meta name="description" content="A i18n support plugin for Jekyll that makes multi-language support fast and intuitive, for blogs big and small.">
<meta name="keywords" content="multilingual, i18n, jekyll, polyglot, fast, intuitive, untra, github, pages, blog, plugin, ruby, gem, internationalization, localization, translation, language, support, multi-language, multi-lingual">
<meta http-equiv="Content-Language" content="en">
<link rel="alternate" hreflang="en" href="https://polyglot.untra.io/"/>
<link rel="alternate" hreflang="es" href="https://polyglot.untra.io/es/"/>
<link rel="alternate" hreflang="de" href="https://polyglot.untra.io/de/"/>
<link rel="alternate" hreflang="fr" href="https://polyglot.untra.io/fr/"/>
<link rel="alternate" hreflang="ru" href="https://polyglot.untra.io/ru/"/>
<link rel="alternate" hreflang="nl" href="https://polyglot.untra.io/nl/"/>
<link rel="alternate" hreflang="he" href="https://polyglot.untra.io/he/"/>
<link rel="alternate" hreflang="ko" href="https://polyglot.untra.io/ko/"/>
<link rel="alternate" hreflang="zh-CN" href="https://polyglot.untra.io/zh-CN/"/>
<link rel="alternate" hreflang="pt-BR" href="https://polyglot.untra.io/pt-BR/"/>
<title>
Polyglot · Straightforward I18n for Jekyll Blogs
</title>
<!-- CSS -->
<link rel="stylesheet" href="/public/css/poole.css">
<link rel="stylesheet" href="/public/css/syntax.css">
<link rel="stylesheet" href="/public/css/hyde.css">
<link rel="stylesheet" href="/public/css/custom.css">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=PT+Sans:400,400italic,700|Abril+Fatface">
<!-- Icons -->
<link rel="apple-touch-icon-precomposed" sizes="144x144" href="/public/apple-touch-icon-144-precomposed.png">
<link rel="shortcut icon" href="/public/favicon.ico">
<!-- RSS -->
<link rel="alternate" type="application/rss+xml" title="RSS" href="/atom.xml">
</head>
<body theme-base-08>
<div class="sidebar">
<div class="container sidebar-sticky">
<div class="sidebar-about">
<p class="speech">Hello!</p>
</br>
<h1>
<a href="">
Polyglot
</a>
</h1>
<p class="lead">A i18n support plugin for <a href="http://jekyllrb.com" target="_blank">Jekyll</a> that makes multi-language support fast and intuitive, for blogs big and small. Made by <a href="https://github.com/untra" target="_blank">@untra</a>.</p>
</div>
<nav class="sidebar-nav">
<a class="sidebar-nav-item" href="/">Home</a>
<a class="sidebar-nav-item" href="/about/">About</a>
<a class="sidebar-nav-item" href="/a-really-long/permalink/">A really long permalink</a>
<a class="sidebar-nav-item" href="/sample/">Sample rich text data</a>
<a class="sidebar-nav-item" href="/seo/">SEO Recipes</a>
<a class="sidebar-nav-item" href=""></a>
<a class="sidebar-nav-item" href="https://rubygems.org/gems/jekyll-polyglot">Ruby Gem</a>
<a class="sidebar-nav-item" href="https://github.com/untra/polyglot">GitHub project</a>
<a class="sidebar-nav-item" href="https://github.com/untra/polyglot/tree/master/site/index.html"><small>view this page source on github</small></a>
<small class="sidebar-nav-item">Currently v1.9.0</small>
</nav>
<p><small>© 2025 Samuel Volin</small><br/><small>MIT Licensed</small></p>
<p>
<!-- jekyll-polyglot will process ferh= into href= through the static_href liquid block tag without relativizing the url; useful for making language navigation switchers -->
<a style="font-weight: bold;" href="/page3/" >en</a> •
<a href="/es/page3/" >es</a> •
<a href="/de/page3/" >de</a> •
<a href="/fr/page3/" >fr</a> •
<a href="/ru/page3/" >ru</a> •
<a href="/nl/page3/" >nl</a> •
<a href="/he/page3/" >he</a> •
<a href="/ko/page3/" >ko</a> •
<a href="/zh-CN/page3/" >zh-CN</a> •
<a href="/pt-BR/page3/" >pt-BR</a>
</p>
</div>
</div>
<div class="content container">
<div class="posts">
<div class="post">
<h1 class="post-title">
<a href="/2021/04/18/polyglot-1.4.1/">
Polyglot 1.4.1
</a>
</h1>
<span class="post-date">18 Apr 2021</span>
<p>Bonus patch release of Polyglot <a href="https://rubygems.org/gems/jekyll-polyglot/versions/1.4.1">version 1.4.1</a> is out!</p>
<h2 id="small-fix-for-i18n_headers">small fix for i18n_headers</h2>
<p>Fallout from cleanup led to a small fix and some tests</p>
<h2 id="say-привет-to-our-russian-friends">say Привет to our russian friends</h2>
<p>Russian language site pages have been added!</p>
<h2 id="want-to-see-your-language-featured">Want to see your language featured?</h2>
<p>I am looking for any volunteers that would like to see the <a href="https://polyglot.untra.io/">Jekyll-Polyglot homepage</a> represented in your language of origin! If you find this software helpful and want to see your language represented, just reach out on the <a href="https://github.com/untra/polyglot/issues">github issues</a>.</p>
</div>
<div class="post">
<h1 class="post-title">
<a href="/2021/02/07/polyglot-1.4.0/">
Polyglot 1.4.0
</a>
</h1>
<span class="post-date">07 Feb 2021</span>
<p>Polyglot <a href="https://rubygems.org/gems/jekyll-polyglot/versions/1.4.0">version 1.4.0</a> is out!</p>
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">gem install jekyll-polyglot</span></code></pre></figure>
<h2 id="static-unrelativized-href">static unrelativized <code class="language-plaintext highlighter-rouge">href</code></h2>
<p>This release provides a new liquid block tag {% static_href %}href=”…”{% endstatic_href %} which can be used to create href attributes in anchor tags that are not relativized by Polyglot.</p>
<p>Jekyll-Polyglot is fairly greedy and naive in it’s relativization, and so if you want a url that is explicitly static (such as for <a href="https://github.com/untra/polyglot/blob/master/site/_includes/sidebar.html#L40-L42">making a language switcher</a>, hint hint), this liquid tag will help you construct that unmangled href=”…” tag in anchor elements.</p>
<h2 id="exclusive-site-language-generation">Exclusive site language generation</h2>
<p>Polyglot 1.4.0 adds support for <code class="language-plaintext highlighter-rouge">lang-exclusive: [ ]</code> frontmatter in documents. If added to a document, this frontmatter will limit generation of the document to that specific language.</p>
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="nn">---</span>
<span class="na">lang-exclusive</span><span class="pi">:</span> <span class="pi">[</span><span class="s1">'</span><span class="s">en'</span><span class="pi">]</span>
<span class="nn">---</span></code></pre></figure>
<p>This is a way to control which languages may see a document, even if that document may not have an equivalent in the default language site.</p>
<h2 id="renaming-a-few-liquid-tags">Renaming a few liquid tags</h2>
<p>The {% static_href %} tag is also available as {% Static_Href %} , and the existing {% I18n_Headers %} tag now can be called as {% i18n_headers %}</p>
<h2 id="want-to-see-your-language-featured">Want to see your language featured?</h2>
<p>I am looking for any volunteers that would like to see the <a href="https://polyglot.untra.io/">Jekyll-Polyglot homepage</a> represented in your language of origin! If you find this software helpful and want to see your language represented, just reach out on the <a href="https://github.com/untra/polyglot/issues">github issues</a>.</p>
</div>
<div class="post">
<h1 class="post-title">
<a href="/2020/07/19/polyglot-1.3.3/">
Polyglot 1.3.3
</a>
</h1>
<span class="post-date">19 Jul 2020</span>
<p>Polyglot <a href="https://rubygems.org/gems/jekyll-polyglot/versions/1.3.3">version 1.3.3</a> is out! It includes a minor fix for when running <code class="language-plaintext highlighter-rouge">jekyll serve --incremental</code> with polyglot installed on a <a href="https://github.com/untra/polyglot/issues/89">fresh build</a>.</p>
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">gem install jekyll-polyglot</span></code></pre></figure>
<p>This release was made possible with the support of the following github user!</p>
<ul>
<li><a href="https://github.com/alexanderadam">alexanderadam</a></li>
</ul>
</div>
<div class="post">
<h1 class="post-title">
<a href="/2020/04/29/polyglot-1.3.2/">
Polyglot 1.3.2
</a>
</h1>
<span class="post-date">29 Apr 2020</span>
<p>Polyglot <a href="https://rubygems.org/gems/jekyll-polyglot/versions/1.3.1">version 1.3.2</a> has been released! Give it a try!</p>
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">gem install jekyll-polyglot</span></code></pre></figure>
<p>This release was made possible with the support of the following github user</p>
<ul>
<li><a href="https://github.com/eighthave">eighthave</a></li>
</ul>
<h3 id="lang_from_path-setting-to-derive-document-lang-from-relative-path"><code class="language-plaintext highlighter-rouge">lang_from_path</code> setting to derive document lang from relative path</h3>
<p>This release adds a new boolean configuration setting <code class="language-plaintext highlighter-rouge">lang_from_path</code>. When set to true, this option tells polyglot to derive the base language from a matching subpath if the lang frontmatter is not set. This setting works well in conjunction with other translation maintenance tools such as <a href="https://po4a.org/">po4a</a>.</p>
<h3 id="relative-and-absolute-url-relativization-improved-logic">relative and absolute url relativization improved logic</h3>
<p><code class="language-plaintext highlighter-rouge">excluded_from_localization</code> files will have trailing slashes added to their paths if they are directories. In addition, these files will be matched differently in the relativize and absolute url regex matchers. This will improve the accuracy of url relativization based on user feedback.</p>
</div>
<div class="post">
<h1 class="post-title">
<a href="/2017/07/23/Polyglot-1.3.0/">
Polyglot 1.3.0
</a>
</h1>
<span class="post-date">23 Jul 2017</span>
<p>A new version of Polyglot has been released! Give it a try!</p>
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">gem install jekyll-polyglot</span></code></pre></figure>
<p>This release was made possible with the support of the following github users:</p>
<ul>
<li><a href="https://github.com/vlsi">vlsi</a></li>
<li><a href="https://github.com/pserwylo">pserwylo</a></li>
</ul>
<h3 id="recursively-merge-language-specific-sitedata">Recursively merge language specific <code class="language-plaintext highlighter-rouge">site.data</code></h3>
<p>Language specific content defined in your <code class="language-plaintext highlighter-rouge">site.data</code> directory will now be recursively merged together, so that <code class="language-plaintext highlighter-rouge">active_lang</code> content gets precedence over <code class="language-plaintext highlighter-rouge">default_lang</code> content, gets precedence over language non-specific content. (<a href="https://github.com/untra/polyglot/pull/59">#59</a>)</p>
<h3 id="still-build-unassigned-files-to-the-default_lang-site-root">Still build unassigned files to the <code class="language-plaintext highlighter-rouge">default_lang</code> site root</h3>
<p>If the <code class="language-plaintext highlighter-rouge">default_lang</code> is not defined in the <code class="language-plaintext highlighter-rouge">languages</code>, this ensures that language unassigned files (such as those excluded from localization) are still written out to the site root. (<a href="https://github.com/untra/polyglot/pull/65">#65</a>)</p>
<h3 id="performance-improvements-and-fixes-for-i18n_headers-tag">Performance improvements and fixes for <code class="language-plaintext highlighter-rouge">i18n_headers</code> tag</h3>
<p>Document processing is now faster, and fixes were made to the i18n_headers for when the site.url is defined. (<a href="https://github.com/untra/polyglot/pull/67">#67</a>)</p>
<h3 id="custom-keys-for-active_lang-site-payload">Custom keys for <code class="language-plaintext highlighter-rouge">active_lang</code> site payload</h3>
<p>This allows custom keys to be defined with the <code class="language-plaintext highlighter-rouge">active_lang</code>, giving interoperability between polyglot and other plugins and themes. (<a href="https://github.com/untra/polyglot/pull/68">#68</a>)</p>
</div>
</div>
<div class="pagination">
<a class="pagination-item older" href="/page4">Older</a>
<a class="pagination-item newer" href="/page2">Newer</a>
</div>
</div>
</body>
<script async src="https://www.googletagmanager.com/gtag/js?id=G-HWC3D32MT8"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-HWC3D32MT8');
</script>
</html>
|
