Polyglot

Polyglot 1.13 - 新的 liquid 变量、SEO 与重定向改进

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

Jekyll-Polyglot 1.13.0 已发布！本次发布得益于 @rathboma 和 Beekeeper Studio 的支持与诸多贡献。

更好的 hreflang 生成

PR #282：@rathboma 合并了对 hreflang 标签生成的改进，为未配置的语言添加了回退选项。这提升了多语言站点上生成的头部的 SEO 与正确性。

对不匹配语言代码的警告

PR #287：@rathboma 添加了构建时警告，当一篇文章的 lang: 值与任何已配置的站点语言都不匹配时会发出提示。语言匹配现在不区分大小写，因此 EN 和 en 会被视为相同。
PR #290：@rathboma 的筛选现在能正确排除以未在 languages: 配置中的语言编写的文章，防止未配置的内容泄漏到构建中。

本地化 Netlify _redirects

PR #285：@rathboma 添加了新的 localize_redirects 选项。启用后，Polyglot 会自动为 Netlify 的 _redirects 规则生成带语言前缀的副本，因此像 /github 这样的重定向也可用于 /fr/github、/de/github 等等。设置细节请参见 SEO 配方页面。

用于翻译状态的新 liquid 变量

PR #305：两个新的 liquid 变量 —— page.missing_languages 和 page.available_languages —— 让你的模板可以看到某个页面已被翻译为哪些语言，以及哪些语言尚未翻译。可用于构建更丰富的语言切换器和侧边栏。

新语言翻译

PR #303：Polyglot 文档站点现在借助 AI 辅助翻译，提供了乌克兰语（uk）和印地语（hi）翻译。欢迎提交修订！
PR #297：@manabu-nakamura 对日语（ja）站点翻译做出了修订贡献。感谢！

AI 开发工具支持

PR #298：Polyglot 现在为 GitHub Copilot、Claude Code 以及共享的 AGENTS.md 约定提供了一流的工程支持。AI 现在已是工作流的一部分，欢迎使用这些工具完成的贡献。
还增加了其他 CI 质量检查，包括 htmlproofer 与 rubocop 调整。

侧边栏显示缺失的翻译

文档站点的侧边栏现在会标记尚未翻译为当前活动语言的页面，让读者和贡献者更容易发现翻译缺口。

感谢 @rathboma 以及为本次发布做出贡献的每一位！

Polyglot 1.12 - 重定向改进和社区贡献

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

Jekyll-Polyglot 1.12.0 已发布！此版本专注于改进重定向处理，并包含多项社区贡献。

重定向改进

此版本包含了 Polyglot 重定向工作方式的重要改进：

PR #275：重定向中的锚点标签保留 - 感谢 @GruberMarkus 的解决方案，重定向 URL 现在可以正确保留锚点标签，确保用户准确到达他们想要的位置。
PR #293：jekyll-redirect-from 插件的子语言重定向支持 - 由 @rathboma 建议，Polyglot 现在可以正确地在子语言之间限定 redirect_from frontmatter 的范围，防止重复重定向并确保非默认语言页面的正确路由。

使用 page.rendered_lang 检测回退页面

PR #283：新的 page.rendered_lang 变量 - 由 @rathboma 贡献，这个新的 liquid 变量可以让您检测页面何时作为回退呈现。当 page.rendered_lang != site.active_lang 时，您知道页面内容尚未翻译。

/about 页面已更新，提供了如何最好地使用这个 page.rendered_lang 便利 liquid 变量的说明。

新语言支持

PR #280：意大利语和土耳其语支持已添加到 Polyglot 文档站点，扩展了我们的多语言覆盖范围。

社区贡献

多位社区成员为项目贡献了改进：

PR #277：更新了侧边栏富文本定义，改善了站点的多语言展示。
PR #288：@manabu-nakamura 贡献了日语富文本字符串，增强了日语体验。

特别感谢 @PanderMusubi 提供的 jekyll-minimal-mistakes-polyglot 演示，展示了如何将 Polyglot 与流行的 Minimal Mistakes 主题集成。

感谢所有使此版本成为可能的贡献者！

Polyglot 1.11 - 杂项修复版本

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

Jekyll Polyglot 1.11.0 已发布。它包含了对最近才得以解决的棘手错误的修复。这个版本得益于像您这样的贡献者和用户。

修复了与 jekyll 主题的冲突

其他 jekyll 主题如 minimal-mistakes 或 chirpy 在 exclude: 配置中使用 glob 模式，这些模式之前会与使用 URL 相对化的网站的 polyglot 处理产生冲突。@mattions 贡献了一个修复，在将这些值应用到相对化正则表达式之前使用 regex.escape 处理它们。

这个调整应该有助于与其他常见 jekyll 主题开箱即用地使用 polyglot。

其他杂项修复

支持日语和阿拉伯语

polyglot 网站现在有阿拉伯语和日语的翻译支持版本。这些网站翻译是在 AI 的帮助下完成的；如果有任何翻译错误，请贡献更好的修正！

Polyglot 1.10 - i18n_headers 优化

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

Jekyll-Polyglot 1.10 现已发布。本次发布对 liquid 插件 i18n_headers 进行了大量优化和改动以提升 SEO 效果，并对并行构建的幂等性做了些许调整。社区贡献者和 Vibe Coding 在本次发布的诸多功能、测试，以及博客撰写中发挥了重要作用。

现版本的 polyglot 需要更新 ruby 至 3.1 及以上版本，可能会破坏您现有的构建系统。

i18n_headers 改进

i18n_headers 插件现已具备更多功能：

其会为每种语言的页面添加 <link rel="canonical" ...>，以确保各站点的索引唯一。
其会添加 <link rel="alternate" hreflang="x-default" ...>。当浏览器未请求匹配语言时，该标签会指向默认站点语言版本。
对于具有自定义永久链接的集合中的页面和文章，该插件会正确地生成 <link rel="alternate" hreflang="...">。
如果 site.baseUrl 具有定义值，默认 URL 也会包含该变量。

此外还修复了一个会导致绝对 URL 相对化时意外破坏这些标签的 bug。

vibe-coded 贡献

在本次更新发现、衡量，以及验证 bug 修复和新功能的过程中，使用了某些 vibe coding 工具。vibe coding 是一种全新的软件开发方式，有它的助力，我们创建了可以在多个已构建的多语言站点中针对 jekyll 插件代码进行的高级 ruby 测试。

通过 vibe coding 的方式编写的测试还保持了高测试覆盖率。自动化测试有了保障，我们由此得以自信地添加复杂的新功能和特性。

此外，vibe coding 工具还帮助将这篇博客文章翻译成了多种语言。

社区贡献

一直以来，Jekyll-Polyglot 得到了社区里的人类用户的大力支持。本项目的人类语言文档均由那些希望能看到本插件以自己母语获得文档记录的人类用户贡献。是人类用户们贡献了 bug 修复和文档，本插件因而得以在每次新版本发布时都获得数千次下载。而 AI 辅助编程——无论是经由在下之手还是诸君之手——都将以我们书写和交流的各种语言，塑造我们所使用的这款软件。

ruby 版本更新需求

jekyll-polyglot 构建时依赖的持续安全更新需要将 ruby 升级到 3.1 及以上主版本。这一更新可能会影响使用了 jekyll-polyglot 构建文档的构建系统。不过，现在也是升级到最新 ruby 主版本的绝好时机。如果这些更改导致了 Jekyll 构建出现问题，请及时反馈。

Polyglot 1.9.0 - 教程优化

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

Jekyll-Polyglot 1.9.0 现已发布。更新内容包括少许依赖项更新，以及助您充分利用多语言网站特性的优化版教程。

社区提供的教程改进

感谢 aturret 帮助维护现有的简体中文 (zh-CN) 网站页面。谢谢！

george-gca 优化了可选的 derive_lang_from_path 配置。其可以更好地从路径推断中识别文档语言。他实用的功能优化 PR 中还包括了测试。此项改进有助于推断缺少 lang 前页内容字段的帖子和页面的语言，这些语言来自文档文件路径的任何部分。

Github 用户 yunseo-kim 提交了一份优化网站地图生成的教程。为适配 SEO 有关规范，一个网站应该只有一个根目录下的 sitemap.xml，其他语言的子站点内不应包含该文件的副本。请务必将 sitemap.xml 添加到 exclude_from_localization 配置中。

Polyglot 1.8.1 - 社区 Bug 修复发布

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

Jekyll-Polyglot 1.8.1 版本已经发布，其中包含了一些功能改进，并修复了社区发现的 Bug。

社区提供的 Bug 修复

hacketiwack 提供了用于更严格检查设置文档永久链接的代码，防止因空的前置字段导致的下游问题。

Github 用户 blackpill 提交了针对 i18n headers 标签的单字符错误修复，用于渲染默认语言链接的替代链接（href）。

Polyglot 1.8.0 - 社区贡献发布

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

非常兴奋地宣布 Jekyll-Polyglot 1.8.0 版本发布了，这个版本增加了一些功能改进，并认可了来自社区的文档和贡献！

不同语言的专属永久链接

Polyglot 1.8.0 版本增加了一些新功能，可以为页面设置特定于语言的永久链接，并保留它们与其他相关页面的关联。这个新功能由一位绅士和学者—— antoniovazquezblanco 提供。

网站地图生成和 i18n SEO

这个版本还认可了 jerturowetz 提供的高质量 sitemap.xml 和 robots.txt 解决方案。本网站现在通过这些文件更好地展示和捕获了搜索引擎提供的 SEO 力量。可以在这里查看示例网站的文件。

jekyll :polyglot :post_write 钩子

GitHub 用户 obfusk 在几年前贡献了一个微小的 PR：

通过多语言 :site, :post_write 钩子，像这样为每个子进程运行：

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

这个版本增加了一个自定义 :post_write 钩子，它在所有语言处理完成后运行一次（无论是否使用 parallel_localization）：

Jekyll::Hooks.register :polyglot, :post_write do |site|
  # do something amazing here!
end

这一特性对于使用了 Jekyll hook 插件的复杂的 Jekyll 静态站点非常有用。

她还为语言子进程崩溃时的额外日志记录提供了修复。感谢这个贡献！

本地化变量和葡萄牙语翻译

george-gca 是一个才华横溢的、很棒的家伙，他为如何最好地从站点数据本地化富文本贡献了一整篇博客文章。他还提供了本站的葡萄牙语翻译。

本地化变量

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

Polyglot 允许您在 Jekyll 站点中为不同语言拥有不同的页面。例如，一个人可以在英语中有一个 about.md 页面，在西班牙语中有另一个 about.md 页面，它们具有完全不同的布局。但是，如果您希望为这两个页面使用相同的布局，您可以使用本地化变量。这是一种在 Jekyll 站点中为不同语言拥有不同数据的方法，但对所有语言使用相同的布局。

下面我将使用一个使用 Polyglot 创建的模板站点作为示例。

在页面之间共享布局

在这个网站中，他们为每种语言的每个页面都有一个关于页面。其中，英语版本在 _pages/en-us/about.md，而巴西葡萄牙语版本在 _pages/pt-br/about.md 中。在这两个页面中，我们可以看到它们的前置元数据中有相同的键，但有些值不同。这两个文件都指向相同的布局：关于页面模板，并且此页面模板使用前置元数据中的值来渲染页面。

例如，英语页面的 subtitle 键的值为 subtitle: <a href='#'>Affiliations</a>. Address. Contacts. Moto. Etc.，而巴西葡萄牙语页面的值为 subtitle: <a href='#'>Afiliações</a>. Endereço. Contatos. Lema. Etc.。要在布局中使用此信息，可以这样使用：

{{ page.subtitle }}

这两个文件中前置元数据下方的内容也是一样的，可以在布局中这样使用：

{{ content }}

Polyglot 会自动使用当前语言的正确值渲染页面。

在页面之间共享布局和本地化数据

对于页面的 subtitle，他们在前置元数据中使用了 key: value 键值对，但有时我们希望在站点的不同部分中使用这些相同的对。例如，如果我们想在 about.md 和另一个页面中使用相同的 subtitle，我们将不得不在这两个页面的前置元数据中重复相同的对。这并不是我们想要的，因为如果我们需要更改 subtitle，我们将不得不在两个地方更改它。这就是本地化数据的用武之地。您可以创建一个文件，例如 _data/:lang/strings.yml，每种语言一个，Polyglot 将这些键带到 site.data[:lang].strings 下。

比如说，在模板站点中有两个文件，_data/en-us/strings.yml 和 _data/pt-br/strings.yml。在第一个文件中，前置元数据内容包括：

latest_posts: latest posts

而在第二个文件中，前置元数据内容包括：

latest_posts: últimas postagens

这样，他们可以在布局中使用 latest_posts 键，如下所示：

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

这样一来，latest_posts 变量的值将正确获取到当前语言的 _data/:lang/strings.yml 文件中定义的值。

在前置元数据中定义要使用的变量

现在，如果您想在页面的前置元数据中定义这个变量，这就有点棘手了。一个可能的解决方案是检查变量的值中是否有 .，如果有，就使用文件 _data/:lang/strings.yml 中的值。你可以这么进行操作：

{% 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 }}

如果 frontmatter_var = blog.title ，这段代码就会生效。 This will work, for example, if frontmatter_var = blog.title.

现在，如果您需要在使用它之前检查本地化字符串（该案例情况下是 blog.title）是否实际存在于文件 _data/:lang/strings.yml 中，您将不得不创建一个插件来检查变量是否存在于文件 _data/:lang/strings.yml 中，如果存在，则使用它，否则回退到任何您想要的值。我不会详细介绍如何做到这一点，但我会向您展示如何使用它。您可以在这里参阅该插件的代码。

{% 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 以及使用 page_id 前置元数据区分不同语言的永久链接

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

我很兴奋地宣布 Jekyll-Polyglot 1.7.0 版本发布了。这个版本增加了一个新功能，可以为页面设置特定于语言的永久链接，并保留它们与其他相关页面的关联。

这项新功能由 antoniovazquezblanco 提供，他是一位绅士和学者。

使用 `page_id` 前置元数据将页面与不同永久链接关联

Polyglot 通过匹配永久链接或文件名来关联页面。然而，有些站点翻译可能希望页面具有独特的永久链接。

Polyglot 已经协调了不同语言的同一文档的多个副本。因此，基于 page_id 这样的新属性来协调相似页面，与基于永久链接协调没有任何区别。

使用 page_id 来协调具有不同永久链接的相似页面，确保了自定义永久链接仍然可以在特定语言的站点上看到。

为独特永久链接设置重定向

独特永久链接的挑战在于相对化地生成的 URL。Polyglot 通过建议使用一致的永久链接完全避免了这个问题。

为了解决这个问题，Polyglot 在这些页面上设置了 redirect_from 隐藏前置元数据，列出了相应页面的唯一永久链接。

在使用 jekyll-redirect-from 插件时，将会读取这些前置元数据，并智能地将页面重定向到自定义的独特永久链接。

要查看此功能的实际效果，请访问这个不同语言的长永久链接的页面。

其他 bug 修复

本次发布应该修复了 #151 和 #184，防止在调用其他 jekyll 命令时启动时崩溃。

Polyglot 1.6.0 以及简体中文支持

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

Polyglot 网站现已更新支持中文！

本次更新由 aturret 带来。他做出了包括插件 bug 修正、网站 bug 修正，以及整个网站的中文完全翻译在内的诸多贡献。

此外，现在可以通过 RubyGems 下载 jekyll-polyglot 1.6.0 了。

修复对冻结字符串进行相对化时的问题

Polyglot 先前使用 String::gsub! 进行字符串修正，导致在修正 .frozen? 字符串时出现错误。现在已通过在修改之前复制一份克隆的字符串修复此问题。

修复站点导航未被翻译的问题

之前，网站布局中 html 中存在拼写错误，导致无法正确翻译之前的翻页导航。现已修复。

中文语言支持

要向 aturret 的支持和欣赏说声大大的谢谢, polyglot.untra.io 现在支持 zh-CN 简体中文翻译了！

Polyglot

Polyglot 1.13 - 新的 liquid 变量、SEO 与重定向改进

更好的 hreflang 生成

对不匹配语言代码的警告

本地化 Netlify _redirects

用于翻译状态的新 liquid 变量

新语言翻译

AI 开发工具支持

侧边栏显示缺失的翻译

Polyglot 1.12 - 重定向改进和社区贡献

重定向改进

使用 page.rendered_lang 检测回退页面

新语言支持

社区贡献

Polyglot 1.11 - 杂项修复版本

修复了与 jekyll 主题的冲突

其他杂项修复

支持日语和阿拉伯语

Polyglot 1.10 - i18n_headers 优化

i18n_headers 改进

vibe-coded 贡献

社区贡献

ruby 版本更新需求

Polyglot 1.9.0 - 教程优化

社区提供的教程改进

Polyglot 1.8.1 - 社区 Bug 修复发布

社区提供的 Bug 修复

Polyglot 1.8.0 - 社区贡献发布

不同语言的专属永久链接

网站地图生成和 i18n SEO

jekyll :polyglot :post_write 钩子

本地化变量和葡萄牙语翻译

本地化变量

在页面之间共享布局

在页面之间共享布局和本地化数据

在前置元数据中定义要使用的变量

Polyglot 1.7.0 以及使用 page_id 前置元数据区分不同语言的永久链接

使用 page_id 前置元数据将页面与不同永久链接关联

为独特永久链接设置重定向

其他 bug 修复

Polyglot 1.6.0 以及简体中文支持

修复对冻结字符串进行相对化时的问题

修复站点导航未被翻译的问题

中文语言支持

使用 `page_id` 前置元数据将页面与不同永久链接关联