31 Jan 2026
Jekyll-Polyglot 1.12.0 has been released! This release focuses on improving redirect handling and includes several community contributions.
redirect improvements
This release includes important improvements to how redirects work with Polyglot:
-
PR #275: Anchor tag preservation in redirects - thanks to a solution from @GruberMarkus, redirect URLs now properly preserve anchor tags, ensuring users land exactly where they intended.
-
PR #293: Sublanguage redirect support for the jekyll-redirect-from plugin - suggested by @rathboma, Polyglot now correctly scopes redirect_from frontmatter across sublanguages, preventing duplicate redirects and ensuring proper routing for non-default language pages.
- PR #283: New
page.rendered_lang variable - contributed by @rathboma, this new liquid variable lets you detect when a page is being rendered as a fallback. When page.rendered_lang != site.active_lang, you know the page content hasn’t been translated yet.
The /about page has been updated with instructions on how to best use this page.rendered_lang convenience liquid variable.
new language support
- PR #280: Italian and Turkish language support has been added to the Polyglot documentation site, expanding our multilingual reach.
Several community members contributed improvements to the project:
-
PR #277: Updated sidebar rich text definitions, improving the site’s multilingual presentation.
-
PR #288: Japanese rich text strings contributed by @manabu-nakamura, enhancing the Japanese language experience.
A special thanks to @PanderMusubi for the jekyll-minimal-mistakes-polyglot demo, showing how to integrate Polyglot with the popular Minimal Mistakes theme.
Thank you to all contributors who made this release possible!
20 Sep 2025
Jekyll Polyglot 1.11.0 has been released. It has fixes for tricky bugs that have been challenging to solve until recently. This release is possible thanks to fellow contributors and users like you.
fixed conflicts with jekyll themes
Other jekyll themes such as miminal-mistakes or chirpy use glob patterns in exclude: configurations which would previously conflict with polyglot processing websites with url relativization. @mattions contributed a fix to regex.escape these values before being applied to the relativization regexes.
This adjustment should help with using polyglot out-of-the-box with other common jekyll themes.
other miscellaneous fixes
support for japanese and arabic
The polyglot website now has translated support versions in arabic and japanese. These site translations were made with the help of AI ; if anything is mistranslated please contribute better corrections!
07 Jul 2025
Jekyll-Polyglot 1.10 is now available. It has vast improvements and changes to the i18n_headers liquid plugin for SEO improvements, and minor adjustments for parallel build idempotency. Community Contributions and Vibe Coding helped with a large portion of these release features, testing and blog post.
This version of polyglot now requires ruby >= 3.1 , which may break in build systems.
the i18n_headers plugin now has extended capabilities as part of this release:
- it will add
<link rel="canonical" ...> for each page language, so indexing is unique across sites.
- it will add
<link rel="alternate" hreflang="x-default" ...> to point to default language version of a site, when no matching language is requested by the browser.
- it will correctly define
<link rel="alternate" hreflang="..." > for pages and posts in collections with custom permalinks.
- the default url will now include the
site.baseUrl if defined
this additionally fixes a bug noticed that caused absolute url relativization to mangle these tags unintentionally.
vibe-coded contributions
Using certain vibe coding tools have helped find, measure and verify bug fixes and features for this release.
This is a new approach for software development, and it created advanced ruby tests against jekyll plugin code running against many built site languages.
The tests written with vibe coding helped ensure the code coverage remained high, and complex features could be added with confidence. Ensuring the test automation was in place ensured tricky features could be built correctly.
Additionally vibe coding tools helped translate this blog post into many languages.
Jekyll-Polyglot has been supported by humans. Human language documentation is contributed by humans who want to see this plugin documented in their native tongue. Humans contributing bug fixes and documentation are what have helped this plugin reach thousands of downloads a release. AI assisted programming, in my hands or yours, will shape the software we use, and in the many languages we write and speak.
ruby >= 3.1 required
Ongoing security updates to jekyll-polyglot build-time dependencies required a major version upgrade to ruby 3.1 . This may affect build systems that build their docs with jekyll-polyglot. But now is a good time to upgrade to the latest ruby major by now. Speak up if these changes cause complications with jekyll builds.
18 Jan 2025
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.
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.
18 Aug 2024
Jekyll-Polyglot 1.8.1 has been released, which has a few feature improvements and recognizes community found bugs and provided fixes.
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.