本文发表于一年多前。旧文章可能包含过时内容。请检查页面中的信息自发布以来是否已变得不正确。

文档正在从 Jekyll 迁移到 Hugo

更改网站框架

经过近一年的研究如何为Kubernetes文档启用多语言支持,我们决定将网站的静态生成器从Jekyll迁移到Hugo

Hugo 迁移对用户和贡献者意味着什么?

某些功能将会中断

Hugo 的 Markdown 解析器与 Jekyll 的严格程度不同。因此,一些在 Jekyll 中可以正常渲染的 Markdown 格式现在产生了一些意想不到的结果:奇怪的左侧导航顺序消失的教程以及损坏的链接等等。

如果您遇到任何网站异常或格式损坏,请提交问题。您可以查看与 Hugo 迁移相关的特定问题列表。

多语言支持即将到来

我们最初的搜索重点是寻找一个与 Jekyll 配合良好的语言选择器。我们找到的项目并没有得到很好的支持,而且一个插件的原型清楚地表明,Jekyll 的实现会产生技术债务,从而耗尽用于文档质量的资源。

经过数月的研究以及与其他开源翻译项目的交流(特别感谢 Andreas Jaeger 及其在 OpenStack 的经验),我们选择了 Hugo。Hugo 的多语言支持是内置的并且易于使用。

先苦后甜

Hugo 的另一个优势是构建性能在规模上表现良好。当页面数量超过 250 页时,Kubernetes 网站的构建时间在 Jekyll 下会显著延长。我们很高兴能够消除因网站构建时间缓慢而造成的贡献障碍。

再次提醒,如果您遇到任何损坏、缺失或意外内容,请提交问题并告知我们。