Polyglot

Polyglot 1.13 - new liquid vars, SEO and redirect improvements

2026-05-13T00:00:00-06:00

Jekyll-Polyglot 1.13.0 has been released! This release is made possible thanks to support and many contributions from @rathboma and Beekeeper Studio.

better hreflang generation

PR #282: @rathboma merged improvements to hreflang tag generation, adding a fallback option for unconfigured languages. This improves SEO and correctness of the generated headers on multilingual sites.

warnings on mismatched language codes

PR #287: @rathboma added build-time warnings when a post’s lang: value does not match any configured site language. Language matching is now case-insensitive, so EN and en are treated the same.
PR #290: @rathboma filtering now properly excludes posts written in languages that are not in the languages: config, preventing unconfigured content from leaking into builds.

localize Netlify _redirects

PR #285: @rathboma added a new localize_redirects option. When enabled, Polyglot automatically generates language-prefixed copies of the Netlify _redirects rules, so a redirect like /github also works for /fr/github, /de/github, and so on. See the SEO recipes page for setup details.

new liquid variables for translation status

PR #305: Two new liquid variables — page.missing_languages and page.available_languages — let your templates see which languages a page has been translated into, and which are still missing. Useful for building richer language switchers and sidebars.

new language translations

PR #303: The Polyglot documentation site now has Ukrainian (uk) and Hindi (hi) translations, with help from AI-assisted translation. Corrections are welcome!
PR #297: @manabu-nakamura contributed corrections to the Japanese (ja) site translations. Thank you!

AI development tooling support

PR #298: Polyglot now ships with first-class engineering support for GitHub Copilot, Claude Code, and the shared AGENTS.md convention. AI is part of the workflow now, and contributions made with these tools are welcome.
Additional CI quality checks were added, including htmlproofer and rubocop adjustments.

The documentation site sidebar now flags pages that do not yet have a translation in the active language, making gaps easier to spot for readers and contributors.

Thank you to @rathboma and everyone who contributed to this release!

Polyglot 1.12 - Weiterleitungsverbesserungen und Community-Beiträge

2026-01-31T00:00:00-07:00

Jekyll-Polyglot 1.12.0 wurde veröffentlicht! Diese Version konzentriert sich auf die Verbesserung der Weiterleitungsbehandlung und enthält mehrere Community-Beiträge.

Weiterleitungsverbesserungen

Diese Version enthält wichtige Verbesserungen bei der Funktionsweise von Weiterleitungen mit Polyglot:

PR #275: Anker-Tag-Erhaltung bei Weiterleitungen - dank einer Lösung von @GruberMarkus erhalten Weiterleitungs-URLs jetzt korrekt Anker-Tags, sodass Benutzer genau dort landen, wo sie hinwollten.
PR #293: Untersprachen-Weiterleitungsunterstützung für das jekyll-redirect-from Plugin - vorgeschlagen von @rathboma, begrenzt Polyglot jetzt korrekt redirect_from Frontmatter über Untersprachen hinweg, verhindert doppelte Weiterleitungen und stellt korrektes Routing für Nicht-Standard-Sprachseiten sicher.

Fallback-Seiten mit page.rendered_lang erkennen

PR #283: Neue page.rendered_lang Variable - beigetragen von @rathboma, ermöglicht diese neue Liquid-Variable zu erkennen, wenn eine Seite als Fallback gerendert wird. Wenn page.rendered_lang != site.active_lang, wissen Sie, dass der Seiteninhalt noch nicht übersetzt wurde.

Die /about Seite wurde mit Anweisungen aktualisiert, wie diese page.rendered_lang Komfort-Liquid-Variable am besten verwendet wird.

neue Sprachunterstützung

PR #280: Italienische und türkische Sprachunterstützung wurde zur Polyglot-Dokumentationsseite hinzugefügt und erweitert unsere mehrsprachige Reichweite.

Community-Beiträge

Mehrere Community-Mitglieder haben Verbesserungen zum Projekt beigetragen:

PR #277: Aktualisierte Seitenleisten-Rich-Text-Definitionen, die die mehrsprachige Präsentation der Website verbessern.
PR #288: Japanische Rich-Text-Strings beigetragen von @manabu-nakamura, die das japanische Spracherlebnis verbessern.

Ein besonderer Dank geht an @PanderMusubi für die jekyll-minimal-mistakes-polyglot Demo, die zeigt, wie Polyglot mit dem beliebten Minimal Mistakes Theme integriert werden kann.

Vielen Dank an alle Mitwirkenden, die diese Version möglich gemacht haben!

Polyglot 1.11 - Release mit verschiedenen Korrekturen

2025-09-20T00:00:00-06:00

Jekyll Polyglot 1.11.0 wurde veröffentlicht. Es enthält Korrekturen für knifflige Bugs, die bis vor kurzem schwer zu lösen waren. Diese Veröffentlichung ist dank Mitwirkenden und Benutzern wie dir möglich.

behobene Konflikte mit jekyll-Themes

Andere jekyll-Themes wie minimal-mistakes oder chirpy verwenden Glob-Muster in exclude:-Konfigurationen, die zuvor mit der Polyglot-Verarbeitung von Websites mit URL-Relativierung in Konflikt standen. @mattions trug eine Korrektur bei, um diese Werte mit regex.escape zu versehen, bevor sie auf die Relativierungs-Regexe angewendet werden.

Diese Anpassung sollte bei der Verwendung von Polyglot out-of-the-box mit anderen gängigen jekyll-Themes helfen.

andere verschiedene Korrekturen

Unterstützung für Japanisch und Arabisch

Die Polyglot-Website hat jetzt übersetzte Support-Versionen auf Arabisch und Japanisch. Diese Website-Übersetzungen wurden mit Hilfe von KI erstellt; falls etwas falsch übersetzt ist, trage bitte bessere Korrekturen bei!

Polyglot 1.10 - Verbesserungen an i18n_headers

2025-07-07T00:00:00-06:00

Jekyll-Polyglot 1.10 ist jetzt verfügbar. Es gibt große Verbesserungen und Änderungen am i18n_headers Liquid-Plugin für SEO-Verbesserungen sowie kleinere Anpassungen für die Idempotenz beim parallelen Bauen. Community-Beiträge und Vibe Coding haben einen großen Teil dieser Release-Features, Tests und Blogposts beigesteuert.

Verbesserungen an i18n_headers

Das i18n_headers-Plugin hat in dieser Version erweiterte Fähigkeiten:

Es fügt für jede Sprachversion einer Seite ein <link rel="canonical" ...> hinzu, sodass das Indexieren für jede Seite eindeutig ist.
Es fügt <link rel="alternate" hreflang="x-default" ...> hinzu, um auf die Standardsprachversion einer Seite zu verweisen, wenn keine passende Sprache vom Browser angefordert wird.
Es definiert <link rel="alternate" hreflang="..."> korrekt für Seiten und Beiträge in Kollektionen mit benutzerdefinierten Permalinks.
Die Standard-URL enthält jetzt site.baseUrl, falls definiert.

Außerdem wurde ein Fehler behoben, der dazu führte, dass die Relativierung absoluter URLs diese Tags unbeabsichtigt verfälschte.

Vibe-Coded-Beiträge

Der Einsatz bestimmter Vibe Coding-Werkzeuge hat geholfen, Fehler und Features für dieses Release zu finden, zu messen und zu verifizieren. Dies ist ein neuer Ansatz in der Softwareentwicklung und ermöglichte fortschrittliche Ruby-Tests gegen Jekyll-Plugin-Code, der auf vielen gebauten Site-Sprachen läuft.

Die mit Vibe Coding geschriebenen Tests halfen, eine hohe Testabdeckung sicherzustellen und komplexe Features mit Vertrauen zu implementieren. Die Automatisierung der Tests sorgte dafür, dass auch schwierige Features korrekt gebaut werden konnten.

Zusätzlich halfen Vibe Coding Tools, diesen Blogpost in viele Sprachen zu übersetzen.

Community-Beiträge

Jekyll-Polyglot wird von Menschen unterstützt. Menschliche Sprachdokumentation wird von Menschen beigetragen, die dieses Plugin in ihrer Muttersprache dokumentiert sehen möchten. Menschen, die Fehlerbehebungen und Dokumentation beitragen, haben dazu beigetragen, dass dieses Plugin bei jeder Veröffentlichung tausende Downloads erreicht. KI-gestützte Programmierung, in meinen oder Ihren Händen, wird die Software, die wir nutzen, und die vielen Sprachen, in denen wir schreiben und sprechen, prägen.

Ruby >= 3.1 erforderlich

Laufende Sicherheitsupdates für die Build-Abhängigkeiten von jekyll-polyglot machten ein großes Upgrade auf Ruby 3.1 erforderlich. Dies kann Build-Systeme betreffen, die ihre Dokumentation mit jekyll-polyglot erstellen. Jetzt ist ein guter Zeitpunkt, auf die neueste Ruby-Hauptversion zu aktualisieren. Melden Sie sich, falls diese Änderungen Komplikationen beim Jekyll-Build verursachen.

Polyglot 1.9.0 - Instructional Improvements

2025-01-18T00:00:00-07:00

Jekyll-Polyglot 1.9.0 has been released, which has minor dependency updates, and instructional improvements for getting the most from your multi-language website.

Community provided instructional improvements

Thank you to aturret for helping to maintain the existing zh-CN site pages. 谢谢！

george-gca improved the optional derive_lang_from_path configuration to better identify document language from the path inference. Tests were added for his helpful feature improvement PR. This improvement helps infer the language of posts and pages missing lang frontmatter, from any part of the document filepath.

Github user yunseo-kim submitted a instructions to improve sitemap generation . To help with SEO, a website should have only one root sitemap.xml , and not have duplicates for each sub-language site. Be sure to add the sitemap.xml to the exclude_from_localization configuration.

Polyglot 1.8.1 - Community Bug Fixes Release

2024-08-18T00:00:00-06:00

Jekyll-Polyglot 1.8.1 has been released, which has a few feature improvements and recognizes community found bugs and provided fixes.

Community provided bugfixes

hacketiwack provided a stricter check for setting a doc permalink, preventing downstream problems with empty frontmatter fields.

Github user blackpill submitted a one character bugfix for the i18n headers tag when rendering the default language link alternative href.

Polyglot 1.8.0 - Community-Beiträge-Veröffentlichung

2024-03-17T00:00:00-06:00

Freuen Sie sich auf Jekyll-Polyglot 1.8.0, das einige Funktionsverbesserungen bietet und Beiträge und Dokumentationen der Community anerkennt!

Sprachspezifische Permalinks

Eine neue Funktion besteht darin, Seiten sprachspezifische Permalinks zu geben und ihre Verknüpfung mit anderen relativen Seiten beizubehalten. Diese neue Funktion wurde erneut von antoniovazquezblanco verbessert antoniovazquezblanco, ein wahrer Gentleman und Gelehrter.

Sitemap-Generierung & Mehrsprachiges SEO

Diese Version erkennt außerdem die Qualität sitemap.xml und robots.txt solution provided by jerturowetz. Diese Website demonstriert und nutzt jetzt mehr SEO-Leistung, indem sie diese Einstellungen verwendet, um von Suchmaschinen als statische Jekyll-Website gecrawlt werden zu können. Sehen Sie sich die Beispiel-Website-Dateien hier.

jekyll :polyglot :post_write hook

Github-Benutzer obfusk hat vor einigen Jahren PR einen winzigen Beitrag geleistet a:

Mit polyglot :site, :post_write diese Funktion wird einmal pro untergeordnetem Prozess ausgeführt:

Jekyll::Hooks.register :site, :post_write do |site|
  ...
end

Diese Version fügt einen benutzerdefinierten Hook :post_write hinzu, der genau einmal ausgeführt wird, nachdem alle Sprachen verarbeitet wurden (ob parallel_localization verwendet wird):

Jekyll::Hooks.register :polyglot, :post_write do |site|
  # Mach hier etwas Großartiges!
end

Diese Funktion ist hilfreich für komplexe statische Jekyll-Websites, die zusätzlich genutzt werden jekyll hook plugins.

Sie hat außerdem einen Fix für zusätzliche Protokollierung bei Abstürzen von Sprach-Subprozessen. Vielen Dank für diesen Beitrag!

Lokalisierte Variablen und portugiesische Übersetzung

george-gca ist ein talentierter und großartiger Kerl, Er hat einen ganzen Blogbeitrag beigesteuert zum Thema, wie man Rich Text aus Website-Daten am besten lokalisiert. Er hat außerdem die Brasilianische Portugiesisch Website-Übersetzung.

Localized variables

2024-02-29T00:00:00-07:00

Polyglot allows you to have different pages for different languages in your Jekyll site. For example, one could have a page about.md in English and another about.md in Spanish with completely different layouts. But if you want to have the same layout for both pages, you can use localized variables. This is a way to have different data for different languages in your Jekyll site, but using the same layout for all languages.

As an example I will use a template site created with Polyglot.

In that site they have an about page for every language, in their case english in _pages/en-us/about.md and brazilian portuguese in _pages/pt-br/about.md. In both pages we can see that they have the same keys in the frontmatter, but some with different values. Both files point to the same layout, about, and this layout uses the values in the frontmatter to render the page.

For example, the subtitle key in the english page has the value subtitle: <a href='#'>Affiliations</a>. Address. Contacts. Moto. Etc. and in the brazilian portuguese page it has subtitle: <a href='#'>Afiliações</a>. Endereço. Contatos. Lema. Etc.. To use this information in the layout, it is used like this:

{{ page.subtitle }}

The same goes for the content below the frontmatter in both files, which is simply used in the layout like this:

{{ content }}

Polyglot will automatically render the page with the correct values for the current language.

For the subtitle of the page they used key: value pairs in the frontmatter, but sometimes we want to use these same pairs in different parts of the site. For example, if we want to use the same subtitle in the about.md and in another page, we would have to repeat the same pair in the frontmatter of both pages. This is not ideal because if we want to change the subtitle we would have to change it in two places. This is where localized data comes in. You can create a file like _data/:lang/strings.yml, one for each language, and Polyglot will bring those keys under site.data[:lang].strings.

For example, in the template site there are two files, _data/en-us/strings.yml and _data/pt-br/strings.yml. In the first file they have:

latest_posts: latest posts

And in the second file they have:

latest_posts: últimas postagens

This way, they can use the latest_posts key in the layout like this:

{{ site.data[site.active_lang].strings.latest_posts }}

Which will correctly get the value for the latest_posts variable defined in the file _data/:lang/strings.yml for the current language.

Defining which variable to use in the frontmatter

Now if you want to define this variable in the frontmatter of the page, this gets a little bit trickier. One possible solution is to check if the value of the variable has a . in it, and if it does use the value in the file _data/:lang/strings.yml. This is how you would do it:

{% if frontmatter_var contains '.' %}
  {% assign first_part = frontmatter_var | split: '.' | first %}
  {% assign last_part = frontmatter_var | split: '.' | last %}
  {% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% endif %}

{{ result }}

This will work, for example, if frontmatter_var = blog.title.

Now, if you need to check if the localization string (in this case blog.title) actually exists in the file _data/:lang/strings.yml before using it, you’ll have to create a plugin to check if the variable exists in the file _data/:lang/strings.yml and if it does, use it, otherwise fallback to any value you want. I will not go into detail on how to do this, but I will show you how to use it. You can see the code for the plugin here.

{% if frontmatter_var contains '.' %}
  {% capture contains_localization %}{% localization_exists {{ frontmatter_var }} %}{% endcapture %}
  {% if contains_localization == 'true' %}
    {% assign first_part = frontmatter_var | split: '.' | first %}
    {% assign last_part = frontmatter_var | split: '.' | last %}
    {% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
  {% else %}
    {% capture result %}fallback value{% endcapture %}
  {% endif %}
{% endif %}

{{ result }}

Polyglot 1.7.0 and page_id front-matter for different permalinks by language

2023-10-29T00:00:00-06:00

I’m excited to announce Jekyll-Polyglot 1.7.0, which has a new feature to give pages language specific permalinks and to retain their association to other relative pages.

This new feature is provided by antoniovazquezblanco, who is a gentleman and a scholar.

use `page_id` frontmatter to associate pages with different permalinks

Polyglot associates pages by matching their permalinks or filenames. However some site translations may instead desire pages with unique permalinks.

Polyglot already coordinates multiple copes of the same document across different languages. So keying off of a different property like page_id is no different than keying off of the permalink.

Using a page_id to coordinate similar pages with different permalinks ensures that custom permalinks can still be seen on language specific sites.

redirects for unique permalinks

The challenge with unique permalinks comes with relativizing those urls. Polyglot avoids this problem entirely by suggesting consistent permalinks.

To help with this, polyglot sets redirect_from hidden frontmatter on these pages, listing the unique permalinks of corresponding pages.

When using the jekyll-redirect-from plugin, that frontmatter will be picked up, and intelligent redirects made to the page’s custom permalink.

To see this in action, visit this page with a long permalink in different languages.

Other bug fixes

This release should have a fix for #151 and #184, preventing crashes on startup when calling other jekyll commands.

Polyglot 1.6.0 and Simplified Chinese language support

2023-06-08T00:00:00-06:00

The Polyglot website has been updated with support for Chinese!

This is made possible by aturret, who contributed numerous bugfixes to the plugin, the website, and an entirely new site translation.

Additionally, jekyll-polyglot 1.6.0 is now available from rubygems.

Fix for relativization of frozen strings

Polyglot used String::gsub! which mutates a .frozen? string. This has now been fixed to duplicate the cloned string before modifying it.

A typo in the html on the site layout prevented the previous page navigation from being translated correctly.

Support for Chinese Language

With a big 谢谢 of support and appreciation to aturret, polyglot.untra.io now supports a zh-CN Simplified Chinese translation!

Polyglot

Polyglot 1.13 - new liquid vars, SEO and redirect improvements

better hreflang generation

warnings on mismatched language codes

localize Netlify _redirects

new liquid variables for translation status

new language translations

AI development tooling support

sidebar shows missing translations

Polyglot 1.12 - Weiterleitungsverbesserungen und Community-Beiträge

Weiterleitungsverbesserungen

Fallback-Seiten mit page.rendered_lang erkennen

neue Sprachunterstützung

Community-Beiträge

Polyglot 1.11 - Release mit verschiedenen Korrekturen

behobene Konflikte mit jekyll-Themes

andere verschiedene Korrekturen

Unterstützung für Japanisch und Arabisch

Polyglot 1.10 - Verbesserungen an i18n_headers

Verbesserungen an i18n_headers

Vibe-Coded-Beiträge

Community-Beiträge

Ruby >= 3.1 erforderlich

Polyglot 1.9.0 - Instructional Improvements

Community provided instructional improvements

Polyglot 1.8.1 - Community Bug Fixes Release

Community provided bugfixes

Polyglot 1.8.0 - Community-Beiträge-Veröffentlichung

Sprachspezifische Permalinks

Sitemap-Generierung & Mehrsprachiges SEO

jekyll :polyglot :post_write hook

Lokalisierte Variablen und portugiesische Übersetzung

Localized variables

Sharing a layout between pages

Sharing a layout between pages with localized data

Defining which variable to use in the frontmatter

Polyglot 1.7.0 and page_id front-matter for different permalinks by language

use page_id frontmatter to associate pages with different permalinks

redirects for unique permalinks

Other bug fixes

Polyglot 1.6.0 and Simplified Chinese language support

Fix for relativization of frozen strings

Fix for site navigation not being translated

Support for Chinese Language

use `page_id` frontmatter to associate pages with different permalinks