[zh]Update contribute pages for links with '/zh/' prefix, using new prefix '/zh-cn/'
This commit is contained in:
howieyuen
@@ -84,9 +84,9 @@ prior to submitting new content. The information details follow.
|
||||
- 使用 Markdown 编写 Kubernetes 文档并使用 [Hugo](https://gohugo.io/) 构建网站。
|
||||
- Kubernetes 文档使用 [CommonMark](https://commonmark.org/) 作为 Markdown 的风格。
|
||||
- 源代码位于 [GitHub](https://github.com/kubernetes/website) 仓库中。
|
||||
你可以在 `/content/zh/docs/` 目录下找到 Kubernetes 文档。
|
||||
你可以在 `/content/zh-cn/docs/` 目录下找到 Kubernetes 文档。
|
||||
某些参考文档是使用位于 `update-imported-docs/` 目录下的脚本自动生成的。
|
||||
- [页面内容类型](/zh/docs/contribute/style/page-content-types/)使用 Hugo 描述文档内容的呈现。
|
||||
- [页面内容类型](/zh-cn/docs/contribute/style/page-content-types/)使用 Hugo 描述文档内容的呈现。
|
||||
|
||||
<!--
|
||||
- You can use [Docsy shortcodes](https://www.docsy.dev/docs/adding-content/shortcodes/) or [custom Hugo shortcodes](/docs/contribute/style/hugo-shortcodes/) to contribute to Kubernetes documentation.
|
||||
@@ -103,15 +103,15 @@ prior to submitting new content. The information details follow.
|
||||
-->
|
||||
|
||||
- 你可以使用 [Docsy 短代码](https://www.docsy.dev/docs/adding-content/shortcodes/)
|
||||
或[定制的 Hugo 短代码](/zh/docs/contribute/style/hugo-shortcodes/)贡献 Kubernetes 文档。
|
||||
或[定制的 Hugo 短代码](/zh-cn/docs/contribute/style/hugo-shortcodes/)贡献 Kubernetes 文档。
|
||||
- 除了标准的 Hugo 短代码外，
|
||||
我们还在文档中使用一些[定制的 Hugo 短代码](/zh/docs/contribute/style/hugo-shortcodes/)来控制内容的呈现。
|
||||
我们还在文档中使用一些[定制的 Hugo 短代码](/zh-cn/docs/contribute/style/hugo-shortcodes/)来控制内容的呈现。
|
||||
- 文档的源代码有多种语言形式，位于 `/content/` 目录下。
|
||||
每种语言都有一个自己的目录，用两个字母表示，这两个字母是基于
|
||||
[ISO 639-1 标准](https://www.loc.gov/standards/iso639-2/php/code_list.php)来确定的。
|
||||
例如，英语文档的源代码位于 `/content/en/docs/` 目录下。
|
||||
- 关于为多语言文档做贡献以及如何开始新翻译的详细信息，
|
||||
可参考[本地化文档](/zh/docs/contribute/localization)。
|
||||
可参考[本地化文档](/zh-cn/docs/contribute/localization)。
|
||||
|
||||
<!--
|
||||
## Before you begin {#before-you-begin}
|
||||
@@ -159,7 +159,7 @@ If you're still not sure which branch to choose, ask in `#sig-docs` on Slack.
|
||||
:---------|:------------
|
||||
针对当前发行版本的，对现有英文内容的修改或新的英文内容 | `main`
|
||||
针对功能特性变更的内容 | 分支对应于功能特性变更的主要和次要版本，分支名称采用 `dev-<version>` 的模式。例如，如果某功能特性在 `v{{< skew nextMinorVersion >}}` 版本发生变化，则对应的文档变化要添加到 `dev-{{< skew nextMinorVersion >}}` 分支。
|
||||
其他语言的内容（本地化） | 基于本地化团队的约定。参见[本地化分支策略](/zh/docs/contribute/localization/#branching-strategy)了解更多信息。
|
||||
其他语言的内容（本地化） | 基于本地化团队的约定。参见[本地化分支策略](/zh-cn/docs/contribute/localization/#branching-strategy)了解更多信息。
|
||||
|
||||
如果你仍不能确定要选择哪个分支，请在 Slack 的 `#sig-docs` 频道上提出问题。
|
||||
|
||||
@@ -196,5 +196,5 @@ contribution journey go more smoothly.
|
||||
|
||||
## 为贡献者提供的工具
|
||||
|
||||
`kubernetes/website` 仓库的[文档贡献者工具](https://github.com/kubernetes/website/tree/main/content/zh/docs/doc-contributor-tools)目录中包含了一些工具，
|
||||
`kubernetes/website` 仓库的[文档贡献者工具](https://github.com/kubernetes/website/tree/main/content/zh-cn/docs/doc-contributor-tools)目录中包含了一些工具，
|
||||
有助于使你的贡献过程更为顺畅。
|
||||
|
||||
@@ -119,7 +119,7 @@ To submit a blog post, follow these steps:
|
||||
- 博客内容不可以是销售用语。
|
||||
- 文章内容必须是对整个 Kubernetes 社区中很多人都有参考意义。
|
||||
例如，所提交的文章应该关注上游的 Kubernetes 项目本身，而不是某个厂商特定的配置。
|
||||
请参阅[文档风格指南](/zh/docs/contribute/style/content-guide/#what-s-allowed)
|
||||
请参阅[文档风格指南](/zh-cn/docs/contribute/style/content-guide/#what-s-allowed)
|
||||
以了解哪些内容是 Kubernetes 所允许的。
|
||||
- 链接应该主要指向官方的 Kubernetes 文档。
|
||||
当引用外部信息时，链接应该是多样的。
|
||||
@@ -217,7 +217,7 @@ SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/s
|
||||
- Do **not** include dots in the filename. A name like `2020-01-01-whats-new-in-1.19.md` causes failures during a build.
|
||||
- The front matter must include the following:
|
||||
-->
|
||||
- [发起一个包含新博文的 PR](/zh/docs/contribute/new-content/open-a-pr/#fork-the-repo)。
|
||||
- [发起一个包含新博文的 PR](/zh-cn/docs/contribute/new-content/open-a-pr/#fork-the-repo)。
|
||||
新博文要创建于 [`content/en/blog/_posts`](https://github.com/kubernetes/website/tree/main/content/en/blog/_posts) 目录下。
|
||||
|
||||
- 确保你的博文遵从合适的命名规范，并带有下面的引言（元数据）信息：
|
||||
|
||||
@@ -64,7 +64,7 @@ the techniques described in
|
||||
在你选定了某个功能特性，为其撰写文档（主笔或辅助），请在 `#sig-docs` Slack 频道、SIG Docs 的每周例会上，
|
||||
或者在功能特性对应的 PR 上提出咨询。
|
||||
如果继续工作是没有问题的，你可以使用
|
||||
[向他人的 PR 中提交](/zh/docs/contribute/review/for-approvers/#commit-into-another-persons-pr)
|
||||
[向他人的 PR 中提交](/zh-cn/docs/contribute/review/for-approvers/#commit-into-another-persons-pr)
|
||||
中描述的技术之一，参与 PR 的编辑工作。
|
||||
|
||||
<!--
|
||||
@@ -257,11 +257,11 @@ table with Alpha and Beta history intact.
|
||||
-->
|
||||
如果你在处理的功能特性处于 Alpha 或 Beta 阶段并由某特性门控控制，
|
||||
请确保在你的 PR 中，该特性门控被添加到
|
||||
[Alpha/Beta 特性门控](/zh/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features)
|
||||
[Alpha/Beta 特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features)
|
||||
表格中。对于新的特性门控选项，需要为该特性门控提供一段描述。
|
||||
如果所处理的功能特性已经进入正式发布（GA）状态或者被废弃，
|
||||
请确保将其从上述表格中迁移到
|
||||
[已毕业或废弃的特性](/zh/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-graduated-or-deprecated-features)
|
||||
[已毕业或废弃的特性](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-graduated-or-deprecated-features)
|
||||
表格中，并确保迁移后保留其 Alpha、Beta 版本变迁历史。
|
||||
|
||||
<!--
|
||||
|
||||
@@ -27,11 +27,11 @@ To contribute new content pages or improve existing content pages, open a pull r
|
||||
-->
|
||||
{{< note >}}
|
||||
**代码开发者们**：如果你在为下一个 Kubernetes 发行版本中的某功能特性撰写文档，
|
||||
请参考[为发行版本撰写功能特性文档](/zh/docs/contribute/new-content/new-features/)。
|
||||
请参考[为发行版本撰写功能特性文档](/zh-cn/docs/contribute/new-content/new-features/)。
|
||||
{{< /note >}}
|
||||
|
||||
要贡献新的内容页面或者改进已有内容页面，请发起拉取请求（PR）。
|
||||
请确保你满足了[开始之前](/zh/docs/contribute/new-content/#before-you-begin)一节中所列举的所有要求。
|
||||
请确保你满足了[开始之前](/zh-cn/docs/contribute/new-content/#before-you-begin)一节中所列举的所有要求。
|
||||
|
||||
<!--
|
||||
If your change is small, or you're unfamiliar with git, read [Changes using
|
||||
@@ -348,9 +348,9 @@ class changes,changes2 white
|
||||
- 针对已有内容的改进，请使用 `upstream/main`。
|
||||
- 针对已有功能特性的新文档内容，请使用 `upstream/main`。
|
||||
- 对于本地化内容，请基于本地化的约定。
|
||||
可参考[本地化 Kubernetes 文档](/zh/docs/contribute/localization/)了解详细信息。
|
||||
可参考[本地化 Kubernetes 文档](/zh-cn/docs/contribute/localization/)了解详细信息。
|
||||
- 对于在下一个 Kubernetes 版本中新功能特性的文档，使用独立的功能特性分支。
|
||||
参考[为发行版本撰写功能特性文档](/zh/docs/contribute/new-content/new-features/)了解更多信息。
|
||||
参考[为发行版本撰写功能特性文档](/zh-cn/docs/contribute/new-content/new-features/)了解更多信息。
|
||||
- 对于很多 SIG Docs 共同参与的，需较长时间才完成的任务，例如内容的重构，
|
||||
请使用为该任务创建的特性分支。
|
||||
|
||||
@@ -493,7 +493,7 @@ You can either build the website's container image or run Hugo locally. Building
|
||||
通过预览你可以发现构建错误或者 Markdown 格式问题。
|
||||
|
||||
你可以构建网站的容器镜像或者在本地运行 Hugo。
|
||||
构建容器镜像的方式比较慢，不过能够显示 [Hugo 短代码（shortcodes）](/zh/docs/contribute/style/hugo-shortcodes/)，
|
||||
构建容器镜像的方式比较慢，不过能够显示 [Hugo 短代码（shortcodes）](/zh-cn/docs/contribute/style/hugo-shortcodes/)，
|
||||
因此对于调试是很有用的。
|
||||
|
||||
{{< tabs name="tab_with_hugo" >}}
|
||||
@@ -685,7 +685,7 @@ GitHub also automatically assigns labels to a PR, to help reviewers. You can add
|
||||
GitHub 也会自动为 PR 分派一些标签，以帮助评阅人。
|
||||
如果有需要，你也可以向 PR 添加标签。
|
||||
欲了解相关详细信息，可以参考
|
||||
[添加和删除 Issue 标签](/zh/docs/contribute/review/for-approvers/#adding-and-removing-issue-labels)。
|
||||
[添加和删除 Issue 标签](/zh-cn/docs/contribute/review/for-approvers/#adding-and-removing-issue-labels)。
|
||||
|
||||
<!--
|
||||
### Addressing feedback locally
|
||||
@@ -1020,5 +1020,5 @@ the templates with as much detail as possible when you file issues or PRs.
|
||||
<!--
|
||||
- Read [Reviewing](/docs/contribute/reviewing/revewing-prs) to learn more about the review process.
|
||||
-->
|
||||
- 阅读[评阅](/zh/docs/contribute/review/reviewing-prs)节，学习评阅过程。
|
||||
- 阅读[评阅](/zh-cn/docs/contribute/review/reviewing-prs)节，学习评阅过程。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user