From 473ecaaa5345b999a93b71f9bad378c75389d4d1 Mon Sep 17 00:00:00 2001 From: "xin.li" Date: Sun, 29 Oct 2023 14:51:44 +0800 Subject: [PATCH] [zh-cn] sync contribute/* Signed-off-by: xin.li --- .../generate-ref-docs/prerequisites-ref-docs.md | 9 ++++----- content/zh-cn/docs/contribute/localization.md | 14 +++++++------- .../zh-cn/docs/contribute/style/style-guide.md | 15 +++++++++++++++ 3 files changed, 26 insertions(+), 12 deletions(-) diff --git a/content/zh-cn/docs/contribute/generate-ref-docs/prerequisites-ref-docs.md b/content/zh-cn/docs/contribute/generate-ref-docs/prerequisites-ref-docs.md index 7954f939c0..90da083748 100644 --- a/content/zh-cn/docs/contribute/generate-ref-docs/prerequisites-ref-docs.md +++ b/content/zh-cn/docs/contribute/generate-ref-docs/prerequisites-ref-docs.md @@ -5,9 +5,9 @@ - You need to have these tools installed: - - [Python](https://www.python.org/downloads/) v3.7.x + - [Python](https://www.python.org/downloads/) v3.7.x+ - [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) - - [Golang](https://golang.org/doc/install) version 1.13+ + - [Golang](https://go.dev/dl/) version 1.13+ - [Pip](https://pypi.org/project/pip/) used to install PyYAML - [PyYAML](https://pyyaml.org/) v5.1.2 - [make](https://www.gnu.org/software/make/) @@ -21,9 +21,9 @@ - 你需要安装以下工具： - - [Python](https://www.python.org/downloads/) v3.7.x + - [Python](https://www.python.org/downloads/) v3.7.x+ - [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) - - [Golang](https://golang.org/doc/install) 1.13+ 版本 + - [Golang](https://go.dev/dl/) 1.13+ 版本 - 用来安装 PyYAML 的 [Pip](https://pypi.org/project/pip/) - [PyYAML](https://pyyaml.org/) v5.1.2 - [make](https://www.gnu.org/software/make/) @@ -42,4 +42,3 @@ - 你需要知道如何为一个 GitHub 仓库创建拉取请求（PR）。 这牵涉到创建仓库的派生（fork）副本。 有关信息可进一步查看[基于本地副本开展工作](/zh-cn/docs/contribute/new-content/open-a-pr/#fork-the-repo)。 - diff --git a/content/zh-cn/docs/contribute/localization.md b/content/zh-cn/docs/contribute/localization.md index d03f33aaa0..6978f1faff 100644 --- a/content/zh-cn/docs/contribute/localization.md +++ b/content/zh-cn/docs/contribute/localization.md @@ -5,7 +5,7 @@ weight: 50 card: name: contribute weight: 50 - title: 翻译文档 + title: 本地化文档 --- @@ -717,7 +717,7 @@ have the exact font used in the original SVG. 5. **Reviewing and testing**: After making the necessary translations and converting text to curves, save and review the updated SVG image to ensure the text is properly displayed and aligned. Check -[Preview your changes locally](https://kubernetes.io/docs/contribute/new-content/open-a-pr/#preview-locally). +[Preview your changes locally](/docs/contribute/new-content/open-a-pr/#preview-locally). --> 5. **检查和测试**：完成必要的翻译并将文本转换为曲线后，保存并检查更新后的 SVG 图片，确保文本正确显示和对齐。 参考[在本地预览你的变更](/zh-cn/docs/contribute/new-content/open-a-pr/#preview-locally)。 @@ -755,9 +755,9 @@ 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 >}}. --> -目标版本 | 分支 ------|----- -最新版本 | [`main`](https://github.com/kubernetes/website/tree/main) +目标版本 | 分支 +----------|----- +最新版本 | [`main`](https://github.com/kubernetes/website/tree/main) 上一个版本 | [`release-{{< skew prevMinorVersion >}}`](https://github.com/kubernetes/website/tree/release-{{< skew prevMinorVersion >}}) 下一个版本 | [`dev-{{< skew nextMinorVersion >}}`](https://github.com/kubernetes/website/tree/dev-{{< skew nextMinorVersion >}}) @@ -980,7 +980,7 @@ permissions are required. 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)。 +有关基于派生或直接从仓库开展工作的更多信息，请参见["派生和克隆"](#fork-and-clone-the-repo)。 +适当时在 Markdown 文档中手动换行。由于 git 工具和 GitHub +网站是逐行生成文件差异的，手动换行可以帮助审阅者轻松找到 PR 中所做的更改并提供反馈。 +它还可以帮助下游本地化团队，使其按行跟踪上游更改。例如，换行可以发生在句子或标点符号的末尾。 +一个例外是 Markdown 链接或短代码应位于一行中。 +