这篇文章已超过一年。较旧的文章可能包含过时的内容。请检查页面中的信息自发布以来是否已变得不正确。
文档正在从 Jekyll 迁移到 Hugo
更改站点框架
在调查如何为 Kubernetes 文档启用多语言支持将近一年后，我们决定将站点的静态生成器从 Jekyll 迁移到 Hugo。
Hugo 迁移对用户和贡献者意味着什么？
事情会出错
Hugo 的 Markdown 解析器比 Jekyll 的解析器 严格得多。 因此，一些在 Jekyll 中渲染良好的 Markdown 格式现在产生了一些意想不到的结果：奇怪的左侧导航顺序、消失的教程以及断开的链接等等。
如果您遇到任何站点异常或格式错误，请提交问题。 您可以查看 特定于 Hugo 迁移的问题列表。
多语言支持即将到来
我们最初的搜索重点是寻找一个能够很好地与 Jekyll 配合的语言选择器。 我们发现的项目没有得到很好的支持，并且一个插件的原型清楚地表明，Jekyll 的实现会产生技术债务，从而耗费资源，使其无法用于提高文档质量。
在经过数月的研究和与其他开源翻译项目的对话后，我们选择了 Hugo。（特别感谢 Andreas Jaeger 及其在 OpenStack 的经验）。 Hugo 的 多语言支持是内置的并且易于使用。
现在痛苦，稍后轻松
Hugo 的另一个优点是， 构建性能 可以很好地随着规模扩展。 在超过 250 个页面时，Kubernetes 网站的构建时间在 Jekyll 上会显着增加。我们很高兴能够消除因网站构建时间缓慢而造成的贡献障碍。
再次，如果您遇到任何损坏、缺失或意外的内容，请提交问题并告知我们。