Kubernetes Prow Robot
GitHub
commit
0ae1f2e54e
|
|
@ -8,12 +8,11 @@ card:
|
|||
title: 翻译文档
|
||||
---
|
||||
<!--
|
||||
title: Localizing Kubernetes Documentation
|
||||
title: Localizing Kubernetes documentation
|
||||
content_type: concept
|
||||
approvers:
|
||||
- remyleone
|
||||
- rlenferink
|
||||
- zacharysarah
|
||||
weight: 50
|
||||
card:
|
||||
name: contribute
|
||||
|
|
@ -24,7 +23,9 @@ card:
|
|||
<!-- overview -->
|
||||
|
||||
<!--
|
||||
This page shows you how to [localize](https://blog.mozilla.org/l10n/2011/12/14/i18n-vs-l10n-whats-the-diff/) the docs for a different language.
|
||||
This page shows you how to
|
||||
[localize](https://blog.mozilla.org/l10n/2011/12/14/i18n-vs-l10n-whats-the-diff/)
|
||||
the docs for a different language.
|
||||
-->
|
||||
此页面描述如何为其他语言的文档提供
|
||||
[本地化](https://blog.mozilla.org/l10n/2011/12/14/i18n-vs-l10n-whats-the-diff/)版本。
|
||||
|
|
@ -34,7 +35,11 @@ This page shows you how to [localize](https://blog.mozilla.org/l10n/2011/12/14/i
|
|||
<!--
|
||||
## Contribute to an existing localization
|
||||
|
||||
You can help add or improve content to an existing localization. In [Kubernetes Slack](https://slack.k8s.io/) you'll find a channel for each localization. There is also a general [SIG Docs Localizations Slack channel](https://kubernetes.slack.com/messages/sig-docs-localizations) where you can say hello.
|
||||
You can help add or improve the content of an existing localization. In
|
||||
[Kubernetes Slack](https://slack.k8s.io/), you can find a channel for each
|
||||
localization. There is also a general [SIG Docs Localizations Slack
|
||||
channel](https://kubernetes.slack.com/messages/sig-docs-localizations) where you
|
||||
can say hello.
|
||||
-->
|
||||
## 为现有的本地化做出贡献 {#contribute-to-an-existing-localization}
|
||||
|
||||
|
|
@ -45,30 +50,31 @@ You can help add or improve content to an existing localization. In [Kubernetes
|
|||
|
||||
{{< note >}}
|
||||
<!--
|
||||
If you want to work on a localization that already exists, check
|
||||
this page in that localization (if it exists), rather than the
|
||||
English original. You might see extra details there.
|
||||
For extra details on how to contribute to a specific localization,
|
||||
look for a localized version of this page.
|
||||
-->
|
||||
如果你想处理已经存在的本地化，请在该本地化（如果存在）中检查此页面，而不是英文原版。
|
||||
你可能会在那里看到额外的详细信息。
|
||||
有关如何为特定本地化做贡献的更多信息，请参阅本页面的各个本地化版本。
|
||||
{{< /note >}}
|
||||
|
||||
<!--
|
||||
### Find your two-letter language code
|
||||
|
||||
First, consult the [ISO 639-1 standard](https://www.loc.gov/standards/iso639-2/php/code_list.php) to find your localization's two-letter language code. For example, the two-letter code for Korean is `ko`.
|
||||
First, consult the [ISO 639-1
|
||||
standard](https://www.loc.gov/standards/iso639-2/php/code_list.php) to find your
|
||||
localization's two-letter language code. For example, the two-letter code for
|
||||
Korean is `ko`.
|
||||
|
||||
### Fork and clone the repo
|
||||
|
||||
First, [create your own fork](/docs/contribute/new-content/open-a-pr/#fork-the-repo) of the [kubernetes/website](https://github.com/kubernetes/website) repository.
|
||||
|
||||
The website content directory includes sub-directories for each language. The localization you want to help out with is inside `content/<two-letter-code>`.
|
||||
First, [create your own
|
||||
fork](/docs/contribute/new-content/open-a-pr/#fork-the-repo) of the
|
||||
[kubernetes/website](https://github.com/kubernetes/website) repository.
|
||||
-->
|
||||
### 找到两个字母的语言代码 {#find-your-two-letter-language-code}
|
||||
|
||||
首先，有关本地化的两个字母的语言代码，请参考
|
||||
[ISO 639-1 标准](https://www.loc.gov/standards/iso639-2/php/code_list.php)。
|
||||
例如，韩国的两个字母代码是 `ko`。
|
||||
例如，韩语的两个字母代码是 `ko`。
|
||||
|
||||
### 派生（fork）并且克隆仓库 {#fork-and-clone-the-repo}
|
||||
|
||||
|
|
@ -86,7 +92,8 @@ cd website
|
|||
```
|
||||
|
||||
<!--
|
||||
The website content directory includes sub-directories for each language. The localization you want to help out with is inside `content/<two-letter-code>`.
|
||||
The website content directory includes subdirectories for each language. The
|
||||
localization you want to help out with is inside `content/<two-letter-code>`.
|
||||
-->
|
||||
网站内容目录包括每种语言的子目录。你想要助力的本地化位于 `content/<two-letter-code>` 中。
|
||||
|
||||
|
|
@ -96,15 +103,16 @@ The website content directory includes sub-directories for each language. The lo
|
|||
Create or update your chosen localized page based on the English original. See
|
||||
[translating content](#translating-content) for more details.
|
||||
|
||||
If you notice a technical inaccuracy or other problem with the upstream (English)
|
||||
documentation, you should fix the upstream documentation first and then repeat the
|
||||
equivalent fix by updating the localization you're working on.
|
||||
If you notice a technical inaccuracy or other problem with the upstream
|
||||
(English) documentation, you should fix the upstream documentation first and
|
||||
then repeat the equivalent fix by updating the localization you're working on.
|
||||
|
||||
Please limit pull requests to a single localization, since pull requests that change
|
||||
content in multiple localizations could be difficult to review.
|
||||
Limit changes in a pull requests to a single localization. Reviewing pull
|
||||
requests that change content in multiple localizations is problematic.
|
||||
|
||||
Follow [Suggesting Content Improvements](/docs/contribute/suggest-improvements/) to propose changes to
|
||||
that localization. The process is very similar to proposing changes to the upstream (English) content.
|
||||
Follow [Suggesting Content Improvements](/docs/contribute/suggesting-improvements/)
|
||||
to propose changes to that localization. The process is similar to proposing
|
||||
changes to the upstream (English) content.
|
||||
-->
|
||||
### 建议更改 {#suggest-changes}
|
||||
|
||||
|
|
@ -114,7 +122,7 @@ that localization. The process is very similar to proposing changes to the upstr
|
|||
如果你发现上游（英文）文档存在技术错误或其他问题，
|
||||
你应该先修复上游文档，然后通过更新你正在处理的本地化来重复等效的修复。
|
||||
|
||||
请将拉取请求限制为单个本地化，因为在多个本地化中更改内容的拉取请求可能难以审查。
|
||||
请将 PR 限制为单个语言版本，因为多语言的 PR 内容修改可能难以审查。
|
||||
|
||||
按照[内容改进建议](/zh-cn/docs/contribute/suggest-improvements/)提出对该本地化的更改。
|
||||
该过程与提议更改上游（英文）内容非常相似。
|
||||
|
|
@ -122,29 +130,30 @@ that localization. The process is very similar to proposing changes to the upstr
|
|||
<!--
|
||||
## Start a new localization
|
||||
|
||||
If you want the Kubernetes documentation localized into a new language, here's what
|
||||
you need to do.
|
||||
If you want the Kubernetes documentation localized into a new language, here's
|
||||
what you need to do.
|
||||
|
||||
Because contributors can't approve their own pull requests, you need _at least two contributors_
|
||||
to begin a localization.
|
||||
Because contributors can't approve their own pull requests, you need _at least
|
||||
two contributors_ to begin a localization.
|
||||
|
||||
All localization teams must be self-sustaining. The Kubernetes website is happy to host your work, but
|
||||
it's up to you to translate it and keep existing localized content current.
|
||||
All localization teams must be self-sufficient. The Kubernetes website is happy
|
||||
to host your work, but it's up to you to translate it and keep existing
|
||||
localized content current.
|
||||
-->
|
||||
## 开始新的本地化 {#start-a-new-localization}
|
||||
|
||||
如果你希望将 Kubernetes 文档本地化为一种新语言，你需要执行以下操作。
|
||||
|
||||
因为贡献者不能批准他们自己的拉取请求，你需要 _至少两个贡献者_ 来开始本地化。
|
||||
因为贡献者不能批准他们自己的拉取请求，你需要 **至少两个贡献者** 来开始本地化。
|
||||
|
||||
所有本地化团队都必须能够自我维持。
|
||||
Kubernetes 网站很乐意托管你的作品，但要由你来翻译它并使现有的本地化内容保持最新。
|
||||
|
||||
<!--
|
||||
You'll need to know the two-letter language code for your language. Consult the
|
||||
[ISO 639-1 standard](https://www.loc.gov/standards/iso639-2/php/code_list.php) to find your
|
||||
localization's two-letter language code. For example, the two-letter code for Korean is
|
||||
`ko`.
|
||||
[ISO 639-1 standard](https://www.loc.gov/standards/iso639-2/php/code_list.php)
|
||||
to find your localization's two-letter language code. For example, the
|
||||
two-letter code for Korean is `ko`.
|
||||
|
||||
When you start a new localization, you must localize all the
|
||||
[minimum required content](#minimum-required-content) before
|
||||
|
|
@ -166,79 +175,97 @@ SIG Docs 可以帮助你在单独的分支上工作，以便你可以逐步实
|
|||
<!--
|
||||
### Find community
|
||||
|
||||
Let Kubernetes SIG Docs know you're interested in creating a localization! Join the [SIG Docs Slack channel](https://kubernetes.slack.com/messages/sig-docs) and the [SIG Docs Localizations Slack channel](https://kubernetes.slack.com/messages/sig-docs-localizations). Other localization teams are happy to help you get started and answer any questions you have.
|
||||
Let Kubernetes SIG Docs know you're interested in creating a localization! Join
|
||||
the [SIG Docs Slack channel](https://kubernetes.slack.com/messages/sig-docs) and
|
||||
the [SIG Docs Localizations Slack channel](https://kubernetes.slack.com/messages/sig-docs-localizations).
|
||||
Other localization teams are happy to help you get started and answer your
|
||||
questions.
|
||||
-->
|
||||
### 找到社区 {#find-community}
|
||||
|
||||
让 Kubernetes SIG Docs 知道你有兴趣创建本地化！
|
||||
加入 [SIG Docs Slack 频道](https://kubernetes.slack.com/messages/sig-docs)
|
||||
和 [SIG Docs Localizations Slack 频道](https://kubernetes.slack.com/messages/sig-docs-localizations)。
|
||||
其他本地化团队很乐意帮助你入门并回答你的任何问题。
|
||||
其他本地化团队很乐意帮助你入门并回答你的问题。
|
||||
|
||||
<!--
|
||||
Please also consider participating in the [SIG Docs Localization Subgroup meeting](https://github.com/kubernetes/community/tree/master/sig-docs). The mission of the SIG Docs localization subgroup is to work across the SIG Docs localization teams to collaborate on defining and documenting the processes for creating localized contribution guides. In addition, the SIG Docs localization subgroup will look for opportunities for the creation and sharing of common tools across localization teams and also serve to identify new requirements to the SIG Docs Leadership team. If you have questions about this meeting, please inquire on the [SIG Docs Localizations Slack channel](https://kubernetes.slack.com/messages/sig-docs-localizations).
|
||||
Please also consider participating in the
|
||||
[SIG Docs Localization Subgroup meeting](https://github.com/kubernetes/community/tree/master/sig-docs).
|
||||
The mission of the SIG Docs localization subgroup is to work across the SIG Docs
|
||||
localization teams to collaborate on defining and documenting the processes for
|
||||
creating localized contribution guides. In addition, the SIG Docs localization
|
||||
subgroup looks for opportunities to create and share common tools across
|
||||
localization teams and identify new requirements for the SIG Docs Leadership
|
||||
team. If you have questions about this meeting, please inquire on the [SIG Docs
|
||||
Localizations Slack channel](https://kubernetes.slack.com/messages/sig-docs-localizations).
|
||||
|
||||
You can also create a Slack channel for your localization in the `kubernetes/community` repository. For an example of adding a Slack channel, see the PR for [adding a channel for Persian](https://github.com/kubernetes/community/pull/4980).
|
||||
You can also create a Slack channel for your localization in the
|
||||
`kubernetes/community` repository. For an example of adding a Slack channel, see
|
||||
the PR for [adding a channel for Persian](https://github.com/kubernetes/community/pull/4980).
|
||||
-->
|
||||
也请考虑参加
|
||||
[SIG Docs 本地化小组的会议](https://github.com/kubernetes/community/tree/master/sig-docs)。
|
||||
SIG Docs 本地化小组的任务是与 SIG Docs 本地化团队合作，
|
||||
共同定义和记录创建本地化贡献指南的流程。
|
||||
此外，SIG Docs 本地化小组将寻找机会在本地化团队中创建和共享通用工具，
|
||||
并为 SIG Docs 领导团队确定新要求。如果你对本次会议有任何疑问，
|
||||
请在 [SIG Docs Localizations Slack 频道](https://kubernetes.slack.com/messages/sig-docs-localizations)
|
||||
中提问。
|
||||
并为 SIG Docs 领导团队确定新要求。如果你对本次会议有任何疑问，请在
|
||||
[SIG Docs Localizations Slack 频道](https://kubernetes.slack.com/messages/sig-docs-localizations)中提问。
|
||||
|
||||
你还可以在 `kubernetes/community` 仓库中为你的本地化创建一个 Slack 频道。
|
||||
有关添加 Slack 频道的示例，请参阅
|
||||
[为波斯语添加频道](https://github.com/kubernetes/community/pull/4980)的 PR。
|
||||
有关添加 Slack 频道的示例，
|
||||
请参阅[为波斯语添加频道](https://github.com/kubernetes/community/pull/4980)的 PR。
|
||||
|
||||
<!--
|
||||
### Join the Kubernetes GitHub organization
|
||||
|
||||
Once you've opened a localization PR, you can become members of the Kubernetes GitHub organization. Each person on the team needs to create their own [Organization Membership Request](https://github.com/kubernetes/org/issues/new/choose) in the `kubernetes/org` repository.
|
||||
When you've opened a localization PR, you can become members of the Kubernetes
|
||||
GitHub organization. Each person on the team needs to create their own
|
||||
[Organization Membership Request](https://github.com/kubernetes/org/issues/new/choose)
|
||||
in the `kubernetes/org` repository.
|
||||
-->
|
||||
### 加入到 Kubernetes GitHub 组织 {#join-the-kubernetes-github-organization}
|
||||
|
||||
提交本地化 PR 后，你可以成为 Kubernetes GitHub 组织的成员。
|
||||
团队中的每个人都需要在 `kubernetes/org` 仓库中创建自己的
|
||||
[组织成员申请](https://github.com/kubernetes/org/issues/new/choose)。
|
||||
团队中的每个人都需要在 `kubernetes/org`
|
||||
仓库中创建自己的[组织成员申请](https://github.com/kubernetes/org/issues/new/choose)。
|
||||
|
||||
<!--
|
||||
### Add your localization team in GitHub
|
||||
|
||||
Next, add your Kubernetes localization team to [`sig-docs/teams.yaml`](https://github.com/kubernetes/org/blob/main/config/kubernetes/sig-docs/teams.yaml). For an example of adding a localization team, see the PR to add the [Spanish localization team](https://github.com/kubernetes/org/pull/685).
|
||||
Next, add your Kubernetes localization team to
|
||||
[`sig-docs/teams.yaml`](https://github.com/kubernetes/org/blob/main/config/kubernetes/sig-docs/teams.yaml).
|
||||
For an example of adding a localization team, see the PR to add the
|
||||
[Spanish localization team](https://github.com/kubernetes/org/pull/685).
|
||||
|
||||
Members of `@kubernetes/sig-docs-**-owners` can approve PRs that change content within (and only within) your localization directory: `/content/**/`.
|
||||
|
||||
For each localization, The `@kubernetes/sig-docs-**-reviews` team automates review assignment for new PRs.
|
||||
Members of `@kubernetes/sig-docs-**-owners` can approve PRs that change content
|
||||
within (and only within) your localization directory: `/content/**/`. For each
|
||||
localization, The `@kubernetes/sig-docs-**-reviews` team automates review
|
||||
assignments for new PRs. Members of `@kubernetes/website-maintainers` can create
|
||||
new localization branches to coordinate translation efforts. Members of
|
||||
`@kubernetes/website-milestone-maintainers` can use the `/milestone`
|
||||
[Prow command](https://prow.k8s.io/command-help) to assign a milestone to issues or PRs.
|
||||
-->
|
||||
### 在 GitHub 中添加你的本地化团队 {#add-your-localization-team-in-github}
|
||||
|
||||
接下来，将你的 Kubernetes 本地化团队添加到
|
||||
[`sig-docs/teams.yaml`](https://github.com/kubernetes/org/blob/main/config/kubernetes/sig-docs/teams.yaml)。
|
||||
有关添加本地化团队的示例，请参见添加[西班牙本地化团队](https://github.com/kubernetes/org/pull/685) 的 PR。
|
||||
有关添加本地化团队的示例，请参见添加[西班牙本地化团队](https://github.com/kubernetes/org/pull/685)的 PR。
|
||||
|
||||
`@kubernetes/sig-docs-**-owners` 成员可以批准更改对应本地化目录 `/content/**/` 中内容的 PR，并仅限这类 PR。
|
||||
|
||||
对于每个本地化，`@kubernetes/sig-docs-**-reviews` 团队被自动分派新 PR 的审阅任务。
|
||||
|
||||
<!--
|
||||
Members of `@kubernetes/website-maintainers` can create new localization branches to coordinate translation efforts.
|
||||
|
||||
Members of `@kubernetes/website-milestone-maintainers` can use the `/milestone` [Prow command](https://prow.k8s.io/command-help) to assign a milestone to issues or PRs.
|
||||
-->
|
||||
`@kubernetes/website-maintainers` 成员可以创建新的本地化分支来协调翻译工作。
|
||||
|
||||
`@kubernetes/website-milestone-maintainers` 成员可以使用 `/milestone`
|
||||
[Prow 命令](https://prow.k8s.io/command-help)为 issues 或 PR 设定里程碑。
|
||||
|
||||
<!--
|
||||
### Configure the workflow
|
||||
|
||||
Next, add a GitHub label for your localization in the `kubernetes/test-infra` repository. A label lets you filter issues and pull requests for your specific language.
|
||||
Next, add a GitHub label for your localization in the `kubernetes/test-infra`
|
||||
repository. A label lets you filter issues and pull requests for your specific
|
||||
language.
|
||||
|
||||
For an example of adding a label, see the PR for adding the [Italian language label](https://github.com/kubernetes/test-infra/pull/11316).
|
||||
For an example of adding a label, see the PR for adding the
|
||||
[Italian language label](https://github.com/kubernetes/test-infra/pull/11316).
|
||||
-->
|
||||
### 配置工作流程 {#configure-the-workflow}
|
||||
|
||||
|
|
@ -247,15 +274,16 @@ For an example of adding a label, see the PR for adding the [Italian language la
|
|||
|
||||
有关添加标签的示例，请参见添加[意大利语标签](https://github.com/kubernetes/test-infra/pull/11316)的 PR。
|
||||
|
||||
你还可以在 `kubernetes/community` 仓库中为你的本地化创建一个 Slack 频道。
|
||||
有关添加 Slack 频道的示例，请参见[为印尼语和葡萄牙语添加频道](https://github.com/kubernetes/community/pull/3605)的 PR。
|
||||
|
||||
<!--
|
||||
### Modify the site configuration
|
||||
|
||||
The Kubernetes website uses Hugo as its web framework. The website's Hugo configuration resides in the [`config.toml`](https://github.com/kubernetes/website/tree/main/config.toml) file. To support a new localization, you'll need to modify `config.toml`.
|
||||
The Kubernetes website uses Hugo as its web framework. The website's Hugo
|
||||
configuration resides in the
|
||||
[`config.toml`](https://github.com/kubernetes/website/tree/main/config.toml)
|
||||
file. You'll need to modify `config.toml` to support a new localization.
|
||||
|
||||
Add a configuration block for the new language to `config.toml`, under the existing `[languages]` block. The German block, for example, looks like:
|
||||
Add a configuration block for the new language to `config.toml` under the
|
||||
existing `[languages]` block. The German block, for example, looks like:
|
||||
-->
|
||||
### 修改站点配置 {#configure-the-workflow}
|
||||
|
||||
|
|
@ -271,25 +299,36 @@ Kubernetes 网站使用 Hugo 作为其 Web 框架。网站的 Hugo 配置位于
|
|||
title = "Kubernetes"
|
||||
description = "Produktionsreife Container-Verwaltung"
|
||||
languageName = "Deutsch (German)"
|
||||
languageNameLatinScript = "German"
|
||||
languageNameLatinScript = "Deutsch"
|
||||
contentDir = "content/de"
|
||||
weight = 8
|
||||
```
|
||||
|
||||
<!--
|
||||
The value for `languageName` will be listed in language selection bar. Assign "language name in native script (language name in latin script)" to `languageName`, for example, `languageName = "한국어 (Korean)"`. `languageNameLatinScript` can be used to access the language name in latin script and use it in the theme. Assign "language name in latin script" to `languageNameLatinScript`, for example, `languageNameLatinScript ="Korean"`.
|
||||
The language selection bar lists the value for `languageName`. Assign "language
|
||||
name in native script and language (English language name in Latin script)" to
|
||||
`languageName`. For example, `languageName = "한국어 (Korean)"` or `languageName =
|
||||
"Deutsch (German)"`.
|
||||
|
||||
`languageNameLatinScript` can be used to access the language name in Latin
|
||||
script and use it in the theme. Assign "language name in latin script" to
|
||||
`languageNameLatinScript`. For example, `languageNameLatinScript ="Korean"` or
|
||||
`languageNameLatinScript = "Deutsch"`.
|
||||
-->
|
||||
`languageName` 的值将列在语言选择栏中。
|
||||
语言选择栏列出了 `languageName` 的值。
|
||||
将 `languageName` 赋值为“本地脚本中的语言名称（拉丁脚本中的语言名称）”。
|
||||
例如，`languageName = "한국어 (Korean)"`。
|
||||
例如，`languageName = "한국어 (Korean)"` 或 `languageName = "Deutsch (German)"`。
|
||||
|
||||
`languageNameLatinScript` 可用于访问拉丁脚本中的语言名称并在主题中使用。
|
||||
将 `languageNameLatinScript` 赋值为“拉丁脚本中的语言名称”。
|
||||
例如，`languageNameLatinScript ="Korean"`。
|
||||
例如，`languageNameLatinScript ="Korean"` 或 `languageNameLatinScript = "Deutsch"`。
|
||||
|
||||
<!--
|
||||
When assigning a `weight` parameter for your block, find the language block with the highest weight and add 1 to that value.
|
||||
When assigning a `weight` parameter for your block, find the language block with
|
||||
the highest weight and add 1 to that value.
|
||||
|
||||
For more information about Hugo's multilingual support, see "[Multilingual Mode](https://gohugo.io/content-management/multilingual/)".
|
||||
For more information about Hugo's multilingual support, see
|
||||
"[Multilingual Mode](https://gohugo.io/content-management/multilingual/)".
|
||||
-->
|
||||
为你的语言块分配一个 `weight` 参数时，找到权重最高的语言块并将其加 1。
|
||||
|
||||
|
|
@ -298,7 +337,9 @@ For more information about Hugo's multilingual support, see "[Multilingual Mode]
|
|||
<!--
|
||||
### Add a new localization directory
|
||||
|
||||
Add a language-specific subdirectory to the [`content`](https://github.com/kubernetes/website/tree/main/content) folder in the repository. For example, the two-letter code for German is `de`:
|
||||
Add a language-specific subdirectory to the
|
||||
[`content`](https://github.com/kubernetes/website/tree/main/content) folder in
|
||||
the repository. For example, the two-letter code for German is `de`:
|
||||
-->
|
||||
### 添加一个新的本地化目录 {#add-a-new-localization-directory}
|
||||
|
||||
|
|
@ -333,46 +374,52 @@ For example, for German the strings live in `data/i18n/de/de.toml`, and
|
|||
<!--
|
||||
### Localize the community code of conduct
|
||||
|
||||
Open a PR against the [`cncf/foundation`](https://github.com/cncf/foundation/tree/master/code-of-conduct-languages) repository to add the code of conduct in your language.
|
||||
|
||||
Open a PR against the
|
||||
[`cncf/foundation`](https://github.com/cncf/foundation/tree/main/code-of-conduct-languages)
|
||||
repository to add the code of conduct in your language.
|
||||
-->
|
||||
### 本地化社区行为准则 {#localize-the-community-code-of-conduct}
|
||||
|
||||
在 [`cncf/foundation`](https://github.com/cncf/foundation/tree/master/code-of-conduct-languages)
|
||||
在 [`cncf/foundation`](https://github.com/cncf/foundation/tree/main/code-of-conduct-languages)
|
||||
仓库提交 PR，添加你所用语言版本的行为准则。
|
||||
|
||||
<!--
|
||||
### Setting up the OWNERS files
|
||||
|
||||
To set the roles of each user contributing to the localization, create an `OWNERS` file inside the language-specific subdirectory with:
|
||||
To set the roles of each user contributing to the localization, create an
|
||||
`OWNERS` file inside the language-specific subdirectory with:
|
||||
|
||||
- **reviewers**: A list of kubernetes teams with reviewer roles, in this case, the `sig-docs-**-reviews` team created in [Add your localization team in GitHub](#add-your-localization-team-in-github).
|
||||
- **approvers**: A list of kubernetes teams with approvers roles, in this case, the `sig-docs-**-owners` team created in [Add your localization team in GitHub](#add-your-localization-team-in-github).
|
||||
- **labels**: A list of GitHub labels to automatically apply to a PR, in this case, the language label created in [Configure the workflow](#configure-the-workflow).
|
||||
- **reviewers**: A list of kubernetes teams with reviewer roles, in this case,
|
||||
- the `sig-docs-**-reviews` team created in [Add your localization team in GitHub](#add-your-localization-team-in-github).
|
||||
- **approvers**: A list of kubernetes teams with approvers roles, in this case,
|
||||
- the `sig-docs-**-owners` team created in [Add your localization team in GitHub](#add-your-localization-team-in-github).
|
||||
- **labels**: A list of GitHub labels to automatically apply to a PR, in this
|
||||
case, the language label created in [Configure the workflow](#configure-the-workflow).
|
||||
-->
|
||||
### 设置 OWNERS 文件 {#setting-up-the-owners-files}
|
||||
|
||||
要设置每个对本地化做出贡献用户的角色，请在特定于语言的子目录内创建一个 `OWNERS` 文件，其中：
|
||||
|
||||
- **reviewers**: 具有评审人角色的 kubernetes 团队的列表，在本例中为在
|
||||
[在 GitHub 中添加你的本地化团队](#add-your-localization-team-in-github)
|
||||
中创建的 `sig-docs-**-reviews` 团队。
|
||||
- **approvers**: 具有批准人角色的 kubernetes 团队的列表，在本例中为在
|
||||
[在 GitHub 中添加你的本地化团队](#add-your-localization-team-in-github)
|
||||
中创建的 `sig-docs-**-owners` 团队。
|
||||
- **labels**: 可以自动应用于 PR 的 GitHub 标签列表，在本例中为
|
||||
[配置工作流程](#configure-the-workflow)中创建的语言标签。
|
||||
- **reviewers**: 具有评审人角色的 kubernetes 团队的列表，
|
||||
在本例中为在[在 GitHub 中添加你的本地化团队](#add-your-localization-team-in-github)中创建的
|
||||
`sig-docs-**-reviews` 团队。
|
||||
- **approvers**: 具有批准人角色的 kubernetes 团队的列表，
|
||||
在本例中为在[在 GitHub 中添加你的本地化团队](#add-your-localization-team-in-github)中创建的
|
||||
`sig-docs-**-owners` 团队。
|
||||
- **labels**: 可以自动应用于 PR 的 GitHub 标签列表，
|
||||
在本例中为[配置工作流程](#configure-the-workflow)中创建的语言标签。
|
||||
|
||||
<!--
|
||||
More information about the `OWNERS` file can be found at [go.k8s.io/owners](https://go.k8s.io/owners).
|
||||
More information about the `OWNERS` file can be found at
|
||||
[go.k8s.io/owners](https://go.k8s.io/owners).
|
||||
|
||||
The [Spanish OWNERS file](https://git.k8s.io/website/content/es/OWNERS), with language code `es`, looks like:
|
||||
The [Spanish OWNERS file](https://git.k8s.io/website/content/es/OWNERS), with
|
||||
language code `es`, looks like this:
|
||||
-->
|
||||
有关 `OWNERS` 文件的更多信息，请访问[go.k8s.io/owners](https://go.k8s.io/owners)。
|
||||
有关 `OWNERS` 文件的更多信息，请访问 [go.k8s.io/owners](https://go.k8s.io/owners)。
|
||||
|
||||
语言代码为 `es` 的[西班牙语 OWNERS 文件](https://git.k8s.io/website/content/es/OWNERS)看起来像：
|
||||
|
||||
|
||||
```yaml
|
||||
# See the OWNERS docs at https://go.k8s.io/owners
|
||||
|
||||
|
|
@ -390,9 +437,14 @@ labels:
|
|||
```
|
||||
|
||||
<!--
|
||||
After adding the language-specific `OWNERS` file, update the [root `OWNERS_ALIASES`](https://git.k8s.io/website/OWNERS_ALIASES) file with the new Kubernetes teams for the localization, `sig-docs-**-owners` and `sig-docs-**-reviews`.
|
||||
After adding the language-specific `OWNERS` file, update the [root
|
||||
`OWNERS_ALIASES`](https://git.k8s.io/website/OWNERS_ALIASES) file with the new
|
||||
Kubernetes teams for the localization, `sig-docs-**-owners` and
|
||||
`sig-docs-**-reviews`.
|
||||
|
||||
For each team, add the list of GitHub users requested in [Add your localization team in GitHub](#add-your-localization-team-in-github), in alphabetical order.
|
||||
For each team, add the list of GitHub users requested in
|
||||
[Add your localization team in GitHub](#add-your-localization-team-in-github),
|
||||
in alphabetical order.
|
||||
-->
|
||||
添加了特定语言的 OWNERS 文件之后，使用新的 Kubernetes 本地化团队、
|
||||
`sig-docs-**-owners` 和 `sig-docs-**-reviews` 列表更新
|
||||
|
|
@ -425,28 +477,34 @@ For each team, add the list of GitHub users requested in [Add your localization
|
|||
<!--
|
||||
### Open a pull request
|
||||
|
||||
Next, [open a pull request](/docs/contribute/new-content/open-a-pr/#open-a-pr) (PR) to add a localization to the `kubernetes/website` repository.
|
||||
Next, [open a pull request](/docs/contribute/new-content/open-a-pr/#open-a-pr)
|
||||
(PR) to add a localization to the `kubernetes/website` repository. The PR must
|
||||
include all the [minimum required content](#minimum-required-content) before it
|
||||
can be approved.
|
||||
|
||||
The PR must include all of the [minimum required content](#minimum-required-content) before it can be approved.
|
||||
|
||||
For an example of adding a new localization, see the PR to enable [docs in French](https://github.com/kubernetes/website/pull/12548).
|
||||
For an example of adding a new localization, see the PR to enable
|
||||
[docs in French](https://github.com/kubernetes/website/pull/12548).
|
||||
-->
|
||||
### 打开拉取请求 {#open-a-pull-request}
|
||||
### 发起拉取请求 {#open-a-pull-request}
|
||||
|
||||
接下来，[打开拉取请求](/zh-cn/docs/contribute/new-content/open-a-pr/#open-a-pr)（PR）
|
||||
接下来，[发起拉取请求](/zh-cn/docs/contribute/new-content/open-a-pr/#open-a-pr)（PR）
|
||||
将本地化添加到 `kubernetes/website` 存储库。
|
||||
|
||||
PR 必须包含所有[最低要求内容](#minimum-required-content)才能获得批准。
|
||||
|
||||
有关添加新本地化的示例，
|
||||
请参阅 PR 以启用[法语文档](https://github.com/kubernetes/website/pull/12548)。
|
||||
请参阅启用[法语文档](https://github.com/kubernetes/website/pull/12548)的 PR。
|
||||
|
||||
<!--
|
||||
### Add a localized README file
|
||||
|
||||
To guide other localization contributors, add a new [`README-**.md`](https://help.github.com/articles/about-readmes/) to the top level of [kubernetes/website](https://github.com/kubernetes/website/), where `**` is the two-letter language code. For example, a German README file would be `README-de.md`.
|
||||
To guide other localization contributors, add a new
|
||||
[`README-**.md`](https://help.github.com/articles/about-readmes/) to the top
|
||||
level of [kubernetes/website](https://github.com/kubernetes/website/), where
|
||||
`**` is the two-letter language code. For example, a German README file would be
|
||||
`README-de.md`.
|
||||
|
||||
Provide guidance to localization contributors in the localized `README-**.md` file. Include the same information contained in `README.md` as well as:
|
||||
Guide localization contributors in the localized `README-**.md` file.
|
||||
Include the same information contained in `README.md` as well as:
|
||||
|
||||
- A point of contact for the localization project
|
||||
- Any information specific to the localization
|
||||
|
|
@ -463,7 +521,11 @@ Provide guidance to localization contributors in the localized `README-**.md` fi
|
|||
- 任何特定于本地化的信息
|
||||
|
||||
<!--
|
||||
After you create the localized README, add a link to the file from the main English `README.md`, and include contact information in English. You can provide a GitHub ID, email address, [Slack channel](https://slack.com/), or other method of contact. You must also provide a link to your localized Community Code of Conduct.
|
||||
After you create the localized README, add a link to the file from the main
|
||||
English `README.md`, and include contact information in English. You can provide
|
||||
a GitHub ID, email address, [Slack channel](https://slack.com/), or another
|
||||
method of contact. You must also provide a link to your localized Community Code
|
||||
of Conduct.
|
||||
-->
|
||||
创建本地化的 README 文件后，请在英语版文件 `README.md` 中添加指向该文件的链接，
|
||||
并给出英文形式的联系信息。你可以提供 GitHub ID、电子邮件地址、
|
||||
|
|
@ -472,27 +534,31 @@ After you create the localized README, add a link to the file from the main Engl
|
|||
<!--
|
||||
### Launching your new localization
|
||||
|
||||
Once a localization meets requirements for workflow and minimum output, SIG Docs will:
|
||||
When a localization meets the requirements for workflow and minimum output, SIG
|
||||
Docs does the following:
|
||||
|
||||
- Enable language selection on the website
|
||||
- Publicize the localization's availability through [Cloud Native Computing Foundation](https://www.cncf.io/about/) (CNCF) channels, including the [Kubernetes blog](https://kubernetes.io/blog/).
|
||||
- Enables language selection on the website.
|
||||
- Publicizes the localization's availability through
|
||||
[Cloud Native Computing Foundation](https://www.cncf.io/about/)(CNCF)
|
||||
channels, including the [Kubernetes blog](/blog/).
|
||||
-->
|
||||
### 启动你的新本地化 {#add-a-localized-readme-file}
|
||||
|
||||
一旦本地化满足工作流程和最小输出的要求，SIG Docs 将：
|
||||
|
||||
- 在网站上启用语言选择
|
||||
- 通过[云原生计算基金会](https://www.cncf.io/about/)（CNCF）渠道，
|
||||
包括 [Kubernetes 博客](https://kubernetes.io/blog/)，来宣传本地化的可用性。
|
||||
- 通过[云原生计算基金会](https://www.cncf.io/about/)（CNCF）渠道以及
|
||||
[Kubernetes 博客](https://kubernetes.io/zh-cn/blog/)来宣传本地化的可用性。
|
||||
|
||||
<!--
|
||||
## Translating content
|
||||
|
||||
Localizing *all* of the Kubernetes documentation is an enormous task. It's okay to start small and expand over time.
|
||||
Localizing *all* the Kubernetes documentation is an enormous task. It's okay to
|
||||
start small and expand over time.
|
||||
-->
|
||||
## 翻译文档 {#translating-content}
|
||||
|
||||
本地化*所有* Kubernetes 文档是一项艰巨的任务。从小做起，循序渐进。
|
||||
本地化**所有** Kubernetes 文档是一项艰巨的任务。从小做起，循序渐进。
|
||||
|
||||
<!--
|
||||
### Minimum required content
|
||||
|
|
@ -509,7 +575,7 @@ Description | URLs
|
|||
Home | [All heading and subheading URLs](/docs/home/)
|
||||
Setup | [All heading and subheading URLs](/docs/setup/)
|
||||
Tutorials | [Kubernetes Basics](/docs/tutorials/kubernetes-basics/), [Hello Minikube](/docs/tutorials/hello-minikube/)
|
||||
Site strings | [All site strings](#Site-strings-in-i18n) in a new localized TOML file
|
||||
Site strings | [All site strings](#site-strings-in-i18n) in a new localized TOML file
|
||||
Releases | [All heading and subheading URLs](/releases)
|
||||
-->
|
||||
描述 | 网址
|
||||
|
|
@ -517,14 +583,17 @@ Releases | [All heading and subheading URLs](/releases)
|
|||
主页 | [所有标题和副标题网址](/zh-cn/docs/home/)
|
||||
安装 | [所有标题和副标题网址](/zh-cn/docs/setup/)
|
||||
教程 | [Kubernetes 基础](/zh-cn/docs/tutorials/kubernetes-basics/), [Hello Minikube](/zh-cn/docs/tutorials/hello-minikube/)
|
||||
网站字符串 | [所有网站字符串](#Site-strings-in-i18n)
|
||||
发行版本 | [所有标题和副标题 URL](/releases)
|
||||
网站字符串 | [所有网站字符串](#site-strings-in-i18n)
|
||||
发行版本 | [所有标题和副标题 URL](/zh-cn/releases)
|
||||
|
||||
<!--
|
||||
Translated documents must reside in their own `content/**/` subdirectory, but otherwise follow the same URL path as the English source. For example, to prepare the [Kubernetes Basics](/docs/tutorials/kubernetes-basics/) tutorial for translation into German, create a subfolder under the `content/de/` folder and copy the English source:
|
||||
Translated documents must reside in their own `content/**/` subdirectory, but otherwise, follow the
|
||||
same URL path as the English source. For example, to prepare the
|
||||
[Kubernetes Basics](/docs/tutorials/kubernetes-basics/) tutorial for translation into German,
|
||||
create a subfolder under the `content/de/` folder and copy the English source:
|
||||
-->
|
||||
翻译后的文档必须保存在自己的 `content/**/` 子目录中，否则将遵循与英文源相同的 URL 路径。
|
||||
例如，要准备将 [Kubernetes 基础](/zh-cn/docs/tutorials/kubernetes-basics/) 教程翻译为德语，
|
||||
例如，要准备将 [Kubernetes 基础](/zh-cn/docs/tutorials/kubernetes-basics/)教程翻译为德语，
|
||||
请在 `content/de/` 文件夹下创建一个子文件夹并复制英文源：
|
||||
|
||||
```shell
|
||||
|
|
@ -533,44 +602,51 @@ cp content/en/docs/tutorials/kubernetes-basics.md content/de/docs/tutorials/kube
|
|||
```
|
||||
|
||||
<!--
|
||||
Translation tools can speed up the translation process. For example, some editors offers plugins to quickly translate text.
|
||||
Translation tools can speed up the translation process. For example, some
|
||||
editors offer plugins to quickly translate text.
|
||||
-->
|
||||
翻译工具可以加快翻译过程。例如，某些编辑器提供了用于快速翻译文本的插件。
|
||||
|
||||
<!--
|
||||
Machine-generated translation is insufficient on its own. Localization requires extensive human review to meet minimum standards of quality.
|
||||
-->
|
||||
{{< caution >}}
|
||||
<!--
|
||||
Machine-generated translation is insufficient on its own. Localization requires
|
||||
extensive human review to meet minimum standards of quality.
|
||||
-->
|
||||
机器生成的翻译本身是不够的，本地化需要广泛的人工审核才能满足最低质量标准。
|
||||
{{< /caution >}}
|
||||
|
||||
<!--
|
||||
To ensure accuracy in grammar and meaning, members of your localization team should carefully review all machine-generated translations before publishing.
|
||||
To ensure accuracy in grammar and meaning, members of your localization team
|
||||
should carefully review all machine-generated translations before publishing.
|
||||
-->
|
||||
为了确保语法和含义的准确性，本地化团队的成员应在发布之前仔细检查所有由机器生成的翻译。
|
||||
|
||||
<!--
|
||||
### Source files
|
||||
|
||||
Localizations must be based on the English files from a specific release targeted by the localization team.
|
||||
Each localization team can decide which release to target which is referred to as the _target version_ below.
|
||||
Localizations must be based on the English files from a specific release
|
||||
targeted by the localization team. Each localization team can decide which
|
||||
release to target, referred to as the _target version_ below.
|
||||
|
||||
To find source files for your target version:
|
||||
|
||||
1. Navigate to the Kubernetes website repository at https://github.com/kubernetes/website.
|
||||
2. Select a branch for your target version from the following table:
|
||||
Target version | Branch
|
||||
-----|-----
|
||||
Latest version | [`main`](https://github.com/kubernetes/website/tree/main)
|
||||
Previous version | [`release-{{< skew prevMinorVersion >}}`](https://github.com/kubernetes/website/tree/release-{{< skew prevMinorVersion >}})
|
||||
Next version | [`dev-{{< skew nextMinorVersion >}}`](https://github.com/kubernetes/website/tree/dev-{{< skew nextMinorVersion >}})
|
||||
|
||||
The `main` branch holds content for the current release `{{< latest-version >}}`. The release team will create a `{{< release-branch >}}` branch before the next release: v{{< skew nextMinorVersion >}}.
|
||||
Target version | Branch
|
||||
-----|-----
|
||||
Latest version | [`main`](https://github.com/kubernetes/website/tree/main)
|
||||
Previous version | [`release-{{< skew prevMinorVersion >}}`](https://github.com/kubernetes/website/tree/release-{{< skew prevMinorVersion >}})
|
||||
Next version | [`dev-{{< skew nextMinorVersion >}}`](https://github.com/kubernetes/website/tree/dev-{{< skew nextMinorVersion >}})
|
||||
|
||||
The `main` branch holds content for the current release `{{< latest-version >}}`.
|
||||
The release team creates a `{{< release-branch >}}` branch before the next
|
||||
release: v{{< skew nextMinorVersion >}}.
|
||||
-->
|
||||
### 源文件 {#source-files}
|
||||
|
||||
本地化必须基于本地化团队所针对的特定发行版本中的英文文件。
|
||||
每个本地化团队可以决定要针对哪个发行版本，在下文中称作目标版本（target version）。
|
||||
每个本地化团队可以决定要针对哪个发行版本，在下文中称作 **目标版本（target version）**。
|
||||
|
||||
要查找你的目标版本的源文件：
|
||||
|
||||
|
|
@ -590,9 +666,13 @@ The `main` branch holds content for the current release `{{< latest-version >}}`
|
|||
<!--
|
||||
### Site strings in i18n
|
||||
|
||||
Localizations must include the contents of [`data/i18n/en/en.toml`](https://github.com/kubernetes/website/blob/main/data/i18n/en/en.toml) in a new language-specific file. Using German as an example: `data/i18n/de/de.toml`.
|
||||
Localizations must include the contents of
|
||||
[`data/i18n/en/en.toml`](https://github.com/kubernetes/website/blob/main/data/i18n/en/en.toml)
|
||||
in a new language-specific file. Using German as an example:
|
||||
`data/i18n/de/de.toml`.
|
||||
|
||||
Add a new localization directory and file to `data/i18n/`. For example, with German (`de`):
|
||||
Add a new localization directory and file to `data/i18n/`. For example, with
|
||||
German (`de`):
|
||||
-->
|
||||
### i18n/ 中的网站字符串 {#site-strings-in-i18n}
|
||||
|
||||
|
|
@ -608,12 +688,12 @@ cp data/i18n/en/en.toml data/i18n/de/de.toml
|
|||
```
|
||||
|
||||
<!--
|
||||
Revise the comments at the top of the file to suit your localization,
|
||||
then translate the value of each string. For example, this is the German-language
|
||||
Revise the comments at the top of the file to suit your localization, then
|
||||
translate the value of each string. For example, this is the German-language
|
||||
placeholder text for the search form:
|
||||
-->
|
||||
修改文件顶部的注释以适合你的本地化，
|
||||
然后翻译每个字符串的值。例如，这是搜索表单的德语占位符文本：
|
||||
修改文件顶部的注释以适合你的本地化，然后翻译每个字符串的值。
|
||||
例如，这是搜索表单的德语占位符文本：
|
||||
|
||||
```toml
|
||||
[ui_search_placeholder]
|
||||
|
|
@ -621,27 +701,33 @@ other = "Suchen"
|
|||
```
|
||||
|
||||
<!--
|
||||
Localizing site strings lets you customize site-wide text and features: for example, the legal copyright text in the footer on each page.
|
||||
Localizing site strings lets you customize site-wide text and features: for
|
||||
example, the legal copyright text in the footer on each page.
|
||||
-->
|
||||
本地化网站字符串允许你自定义网站范围的文本和特性：例如，每个页面页脚中的合法版权文本。
|
||||
本地化网站字符串允许你自定义网站范围的文本和特性：例如每个页面页脚中的版权声明文本。
|
||||
|
||||
<!--
|
||||
### Language specific style guide and glossary
|
||||
### Language-specific localization guide
|
||||
|
||||
Some language teams have their own language-specific style guide and glossary. For example, see the [Korean Localization Guide](/ko/docs/contribute/localization_ko/).
|
||||
As a localization team, you can formalize the best practices your team follows
|
||||
by creating a language-specific localization guide.
|
||||
-->
|
||||
### 特定语言的样式指南和词汇表 {#language-specific-style-guide-and-glossary}
|
||||
### 特定语言的本地化指南 {#language-specific-localization-guide}
|
||||
|
||||
一些语言团队有自己的特定语言样式指南和词汇表。
|
||||
例如，请参见[中文本地化指南](/zh-cn/docs/contribute/localization_zh/)。
|
||||
作为本地化团队，你可以通过创建特定语言的本地化指南来正式确定团队需遵循的最佳实践。
|
||||
请参见[中文本地化指南](/zh-cn/docs/contribute/localization_zh/)。
|
||||
|
||||
<!--
|
||||
### Language specific Zoom meetings
|
||||
### Language-specific Zoom meetings
|
||||
|
||||
If the localization project needs a separate meeting time, contact a SIG Docs Co-Chair or Tech Lead to create a new reoccurring Zoom meeting and calendar invite. This is only needed when the the team is large enough to sustain and require a separate meeting.
|
||||
|
||||
Per CNCF policy, the localization teams must upload their meetings to the SIG Docs YouTube playlist. A SIG Docs Co-Chair or Tech Lead can help with the process until SIG Docs automates it.
|
||||
If the localization project needs a separate meeting time, contact a SIG Docs
|
||||
Co-Chair or Tech Lead to create a new reoccurring Zoom meeting and calendar
|
||||
invite. This is only needed when the team is large enough to sustain and require
|
||||
a separate meeting.
|
||||
|
||||
Per CNCF policy, the localization teams must upload their meetings to the SIG
|
||||
Docs YouTube playlist. A SIG Docs Co-Chair or Tech Lead can help with the
|
||||
process until SIG Docs automates it.
|
||||
-->
|
||||
|
||||
### 特定语言的 Zoom 会议 {#language-specific-zoom-meetings}
|
||||
|
|
@ -664,24 +750,32 @@ To collaborate on a localization branch:
|
|||
-->
|
||||
### 分支策略 {#branching-strategy}
|
||||
|
||||
因为本地化项目是高度协同的工作，所以我们鼓励团队基于共享的本地化分支工作。
|
||||
- 特别是在开始并且本地化尚未生效时。
|
||||
因为本地化项目是高度协同的工作，
|
||||
特别是在刚开始本地化并且本地化尚未生效时，我们鼓励团队基于共享的本地化分支工作。
|
||||
|
||||
在本地化分支上协作需要：
|
||||
|
||||
<!--
|
||||
1. A team member of [@kubernetes/website-maintainers](https://github.com/orgs/kubernetes/teams/website-maintainers) opens a localization branch from a source branch on https://github.com/kubernetes/website.
|
||||
1. A team member of
|
||||
[@kubernetes/website-maintainers](https://github.com/orgs/kubernetes/teams/website-maintainers)
|
||||
opens a localization branch from a source branch on
|
||||
https://github.com/kubernetes/website.
|
||||
|
||||
Your team approvers joined the `@kubernetes/website-maintainers` team when you [added your localization team](#add-your-localization-team-in-github) to the [`kubernetes/org`](https://github.com/kubernetes/org) repository.
|
||||
Your team approvers joined the `@kubernetes/website-maintainers` team when
|
||||
you [added your localization team](#add-your-localization-team-in-github) to
|
||||
the [`kubernetes/org`](https://github.com/kubernetes/org) repository.
|
||||
|
||||
We recommend the following branch naming scheme:
|
||||
We recommend the following branch naming scheme:
|
||||
|
||||
`dev-<source version>-<language code>.<team milestone>`
|
||||
`dev-<source version>-<language code>.<team milestone>`
|
||||
|
||||
For example, an approver on a German localization team opens the localization branch `dev-1.12-de.1` directly against the kubernetes/website repository, based on the source branch for Kubernetes v1.12.
|
||||
For example, an approver on a German localization team opens the localization
|
||||
branch `dev-1.12-de.1` directly against the `kubernetes/website` repository,
|
||||
based on the source branch for Kubernetes v1.12.
|
||||
-->
|
||||
1. [@kubernetes/website-maintainers](https://github.com/orgs/kubernetes/teams/website-maintainers)
|
||||
中的团队成员从 https://github.com/kubernetes/website 原有分支新建一个本地化分支。
|
||||
|
||||
当你给 `kubernetes/org` 仓库[添加你的本地化团队](#add-your-localization-team-in-github)时，
|
||||
你的团队批准人便加入了 `@kubernetes/website-maintainers` 团队。
|
||||
|
||||
|
|
@ -693,17 +787,22 @@ To collaborate on a localization branch:
|
|||
直接新建了 kubernetes/website 仓库的本地化分支 `dev-1.12-de.1`。
|
||||
|
||||
<!--
|
||||
2. Individual contributors open feature branches based on the localization branch.
|
||||
2. Individual contributors open feature branches based on the localization
|
||||
branch.
|
||||
|
||||
For example, a German contributor opens a pull request with changes to `kubernetes:dev-1.12-de.1` from `username:local-branch-name`.
|
||||
For example, a German contributor opens a pull request with changes to
|
||||
`kubernetes:dev-1.12-de.1` from `username:local-branch-name`.
|
||||
|
||||
3. Approvers review and merge feature branches into the localization branch.
|
||||
|
||||
4. Periodically, an approver merges the localization branch to its source branch by opening and approving a new pull request. Be sure to squash the commits before approving the pull request.
|
||||
4. Periodically, an approver merges the localization branch with its source
|
||||
branch by opening and approving a new pull request. Be sure to squash the
|
||||
commits before approving the pull request.
|
||||
-->
|
||||
2. 个人贡献者基于本地化分支创建新的特性分支
|
||||
2. 个人贡献者基于本地化分支创建新的特性分支。
|
||||
|
||||
例如，一个德语贡献者新建了一个拉取请求，并将 `username:local-branch-name` 更改为 `kubernetes:dev-1.12-de.1`。
|
||||
例如，一个德语贡献者新建了一个拉取请求，
|
||||
并将 `username:local-branch-name` 更改为 `kubernetes:dev-1.12-de.1`。
|
||||
|
||||
3. 批准人审查功能分支并将其合并到本地化分支中。
|
||||
|
||||
|
|
@ -711,55 +810,74 @@ To collaborate on a localization branch:
|
|||
在批准 PR 之前，请确保先 squash commits。
|
||||
|
||||
<!--
|
||||
Repeat steps 1-4 as needed until the localization is complete. For example, subsequent German localization branches would be: `dev-1.12-de.2`, `dev-1.12-de.3`, etc.
|
||||
Repeat steps 1-4 as needed until the localization is complete. For example,
|
||||
subsequent German localization branches would be: `dev-1.12-de.2`,
|
||||
`dev-1.12-de.3`, etc.
|
||||
-->
|
||||
根据需要重复步骤 1-4，直到完成本地化工作。例如，随后的德语本地化分支将是：
|
||||
`dev-1.12-de.2`、`dev-1.12-de.3`，等等。
|
||||
`dev-1.12-de.2`、`dev-1.12-de.3` 等等。
|
||||
|
||||
<!--
|
||||
Teams must merge localized content into the same branch from which the content was sourced.
|
||||
Teams must merge localized content into the same branch from which the content
|
||||
was sourced. For example:
|
||||
|
||||
For example:
|
||||
|
||||
- a localization branch sourced from `main` must be merged into `main`.
|
||||
- a localization branch sourced from `release-{{% skew "prevMinorVersion" %}}` must be merged into `release-{{% skew "prevMinorVersion" %}}`.
|
||||
|
||||
{{< note >}}
|
||||
If your localization branch was created from `main` branch but it is not merged into `main` before new release branch `{{< release-branch >}}` created, merge it into both `main` and new release branch `{{< release-branch >}}`. To merge your localization branch into new release branch `{{< release-branch >}}`, you need to switch upstream branch of your localization branch to `{{< release-branch >}}`.
|
||||
{{< /note >}}
|
||||
- A localization branch sourced from `main` must be merged into `main`.
|
||||
- A localization branch sourced from `release-{{% skew "prevMinorVersion" %}}`
|
||||
must be merged into `release-{{% skew "prevMinorVersion" %}}`.
|
||||
-->
|
||||
团队必须将本地化内容合入到发布分支中，该发布分支是内容的来源。
|
||||
|
||||
例如：
|
||||
团队必须将本地化内容合入到发布分支中，该发布分支是内容的来源。例如：
|
||||
|
||||
- 源于 `main` 分支的本地化分支必须被合并到 `main`。
|
||||
- 源于 `release-{{ skew "prevMinorVersion" }}`
|
||||
的本地化分支必须被合并到 `release-{{ skew "prevMinorVersion" }}`。
|
||||
|
||||
如果你的本地化分支是基于 `main` 分支创建的，但最终没有在新的发行
|
||||
分支 `{{< release-branch >}}` 被创建之前合并到 `main` 中，需要将其
|
||||
同时将其合并到 `main` 和新的发行分支 `{{< release-branch >}}` 中。
|
||||
要将本地化分支合并到新的发行分支 `{{< release-branch >}}` 中，你需要
|
||||
将你本地化分支的上游分支切换到 `{{< release-branch >}}`。
|
||||
|
||||
{{< note >}}
|
||||
<!--
|
||||
At the beginning of every team milestone, it's helpful to open an issue comparing upstream changes between the previous localization branch and the current localization branch. There are two scripts for comparing upstream changes. [`upstream_changes.py`](https://github.com/kubernetes/website/tree/main/scripts#upstream_changespy) is useful for checking the changes made to a specific file. And [`diff_l10n_branches.py`](https://github.com/kubernetes/website/tree/main/scripts#diff_l10n_branchespy) is useful for creating a list of outdated files for a specific localization branch.
|
||||
|
||||
While only approvers can open a new localization branch and merge pull requests, anyone can open a pull request for a new localization branch. No special permissions are required.
|
||||
If your localization branch was created from `main` branch, but it is not merged
|
||||
into `main` before the new release branch `{{< release-branch >}}` created,
|
||||
merge it into both `main` and new release branch `{{< release-branch >}}`. To
|
||||
merge your localization branch into the new release branch
|
||||
`{{< release-branch >}}`, you need to switch the upstream branch of your
|
||||
localization branch to `{{< release-branch >}}`.
|
||||
-->
|
||||
在团队每个里程碑的开始时段，创建一个 issue 来比较先前的本地化分支
|
||||
和当前的本地化分支之间的上游变化很有帮助。
|
||||
现在有两个脚本用来比较上游的变化。
|
||||
[`upstream_changes.py`](https://github.com/kubernetes/website/tree/main/scripts#upstream_changespy)
|
||||
对于检查对某个文件的变更很有用。
|
||||
[`diff_l10n_branches.py`](https://github.com/kubernetes/website/tree/main/scripts#diff_l10n_branchespy)
|
||||
可以用来为某个特定本地化分支创建过时文件的列表。
|
||||
|
||||
虽然只有批准人才能创建新的本地化分支并合并 PR，任何人都可以
|
||||
为新的本地化分支提交一个拉取请求（PR）。不需要特殊权限。
|
||||
如果你的本地化分支是基于 `main` 分支创建的，但最终没有在新的发行分支
|
||||
`{{< release-branch >}}` 被创建之前合并到 `main` 中，需要将其同时将其合并到
|
||||
`main` 和新的发行分支 `{{< release-branch >}}` 中。
|
||||
要将本地化分支合并到新的发行分支 `{{< release-branch >}}` 中，
|
||||
你需要将你本地化分支的上游分支切换到 `{{< release-branch >}}`。
|
||||
{{< /note >}}
|
||||
|
||||
<!--
|
||||
For more information about working from forks or directly from the repository, see ["fork and clone the repo"](#fork-and-clone-the-repo).
|
||||
At the beginning of every team milestone, it's helpful to open an issue
|
||||
comparing upstream changes between the previous localization branch and the
|
||||
current localization branch. There are two scripts for comparing upstream
|
||||
changes.
|
||||
|
||||
- [`upstream_changes.py`](https://github.com/kubernetes/website/tree/main/scripts#upstream_changespy)
|
||||
is useful for checking the changes made to a specific file. And
|
||||
- [`diff_l10n_branches.py`](https://github.com/kubernetes/website/tree/main/scripts#diff_l10n_branchespy)
|
||||
is useful for creating a list of outdated files for a specific localization
|
||||
branch.
|
||||
|
||||
While only approvers can open a new localization branch and merge pull requests,
|
||||
anyone can open a pull request for a new localization branch. No special
|
||||
permissions are required.
|
||||
-->
|
||||
在团队每个里程碑的开始时段，创建一个 issue
|
||||
来比较先前的本地化分支和当前的本地化分支之间的上游变化很有帮助。
|
||||
现在有两个脚本用来比较上游的变化。
|
||||
|
||||
- [`upstream_changes.py`](https://github.com/kubernetes/website/tree/main/scripts#upstream_changespy)
|
||||
对于检查对某个文件的变更很有用。
|
||||
- [`diff_l10n_branches.py`](https://github.com/kubernetes/website/tree/main/scripts#diff_l10n_branchespy)
|
||||
可以用来为某个特定本地化分支创建过时文件的列表。
|
||||
|
||||
虽然只有批准人才能创建新的本地化分支并合并 PR，
|
||||
任何人都可以为新的本地化分支提交一个拉取请求（PR）。不需要特殊权限。
|
||||
|
||||
<!--
|
||||
For more information about working from forks or directly from the repository,
|
||||
see ["fork and clone the repo"](#fork-and-clone-the-repo).
|
||||
-->
|
||||
有关基于派生或直接从仓库开展工作的更多信息，请参见 ["派生和克隆"](#fork-and-clone-the-repo)。
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue