文档正在从Jekyll迁移到Hugo

作者: 扎克·科莱森(Zach Corleissen) (CNCF)

更改网站框架

在研究了如何为Kubernetes文档启用多语言支持近一年之后,我们决定将网站的静态生成器从Jekyll迁移到 雨果.

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

事情会破裂

雨果的Markdown解析器是 与杰基尔的严格程度不同。因此,在Jekyll中可以正常显示的某些Markdown格式现在会产生一些意外的结果: 奇怪的左导航顺序, 消失的教程断开的链接等等。

如果您遇到任何网站怪异或格式损坏的情况,请 打开一个问题。您可以看到的问题列表 特定于雨果移民.

多语言支持即将到来

我们最初的搜索重点是寻找与Jekyll搭配使用的语言选择器。我们发现的项目没有得到很好的支持,并且一个插件的原型清楚地表明,Jekyll实现会产生技术债务,使资源浪费掉,导致文档质量下降。

经过数月的研究和与其他开源翻译项目的对话,我们选择了Hugo。 (特别感谢 安德烈亚斯·杰格(Andreas Jaeger) 和他在OpenStack的经验)。雨果的 多语言支持 内置且简单。

现在疼痛,稍后缓解

雨果的另一个优点是 建立绩效 可以很好地缩放大小。在Jekyll的帮助下,Kubernetes网站的构建时间超过250页。我们很高兴消除缓慢的网站构建时间造成的贡献障碍。

同样,如果遇到任何损坏,丢失或意外的内容,请 打开一个问题 让我们知道