贡献新内容

    flowchart LR subgraph second[开始之前] direction TB S[ ] -.- A[签署 CNCF CLA] —> B[选择 Git 分支] B —> C[每个 PR 一种语言] C —> F[检查贡献者工具] end subgraph first[基本知识] direction TB T[ ] -.- D[用 markdown 编写文档
    并用 Hugo 构建网站] —- E[GitHub 源代码] E —- G[‘/content/../docs’ 文件夹包含
    多语言文档] G —- H[评审 Hugo 页面内容
    类型和短代码] end first ——> second classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px; classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000 class A,B,C,D,E,F,G,H grey class S,T spacewhite class first,second white

    必须启用 JavaScript 才能查看此页内容

    插图 - 贡献新内容准备工作

    • 使用 Markdown 编写 Kubernetes 文档并使用 Hugo 构建网站。
    • Kubernetes 文档使用 作为 Markdown 的风格。

    • 页面内容类型使用 Hugo 描述文档内容的呈现。

    • 你可以使用 或定制的 Hugo 短代码贡献 Kubernetes 文档。

    • 除了标准的 Hugo 短代码外， 我们还在文档中使用一些来控制内容的呈现。
    • 文档的源代码有多种语言形式，位于 /content/ 目录下。 每种语言都有一个自己的目录，用两个字母表示，这两个字母是基于 ISO 639-1 标准来确定的。 例如，英语文档的源代码位于 目录下。
    • 关于为多语言文档做贡献以及如何开始新翻译的详细信息， 可参考。

    所有 Kubernetes 贡献者必须阅读贡献者指南 并。

    在发起 PR 时，你需要预先知道基于哪个分支来开展工作。

    如果你仍不能确定要选择哪个分支，请在 Slack 的 频道上提出问题。

    说明： 如果你已经提交了 PR，并且发现所针对的分支选错了，你（且只有作为提交人的你）可以更改分支。

    kubernetes/website 仓库的目录中包含了一些工具， 有助于使你的贡献过程更为顺畅。