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