[zh] translation for kubectl install section #29509

steven-my · 2021-08-23T06:17:28Z

related: #29329
Translation for the 'kubectl install' section in issue 29329.
Modified:
content/zh/docs/tasks/tools/install-kubectl-linux.md
content/zh/docs/tasks/tools/install-kubectl-macos.md
content/zh/docs/tasks/tools/install-kubectl-windows.md

howieyuen · 2021-08-23T06:31:45Z

oops, you need trigger the checks again by push -f

steven-my · 2021-08-23T06:35:27Z

OK, i will try push -f

howieyuen · 2021-08-23T06:35:22Z

content/zh/docs/tasks/tools/install-kubectl-linux.md

+<!--
+   If the check fails, `sha256` exits with nonzero status and prints output similar to:
+-->
+   验证失败时，`sha256` 将以非零值退出，并打印如下输出：


验证失败时，sha256 将以非零值退出，并打印输出类似于：

howieyuen · 2021-08-23T06:38:03Z

content/zh/docs/tasks/tools/install-kubectl-macos.md


 ### Enable shell autocompletion {#enable-shell-autocompletion}
 -->
-## 可选的 kubectl 配置 {#optional-kubectl-configurations}
+## 可选的 kubectl 配置和插件 {#optional-kubectl-configurations}


{#optional-kubectl-configurations-and-plugins}

howieyuen · 2021-08-23T06:40:58Z

content/zh/docs/tasks/tools/install-kubectl-macos.md

+<!--
+   Validate the kubectl-convert binary against the checksum file:
+-->
+   基于校验和文件，验证 kubectl-convert 的可执行文件：


基于校验和，验证 kubectl-convert 二进制文件：

已修改，但保留了“可执行文件”

howieyuen · 2021-08-23T06:41:34Z

content/zh/docs/tasks/tools/install-kubectl-linux.md

+<!--
+   Download the same version of the binary and checksum.
+-->
+   下载相同版本的可执行文件与校验和文件。


下载相同版本的二进制文件和校验和。

已修改，但保留了“可执行文件”

howieyuen · 2021-08-23T06:42:28Z

content/zh/docs/tasks/tools/install-kubectl-macos.md

+<!--
+   If the check fails, `shasum` exits with nonzero status and prints output similar to:
+-->
+   验证失败时，`sha256` 将以非零值退出，并打印如下输出：


验证失败时，sha256 将以非零值退出，并打印输出类似于：

howieyuen · 2021-08-23T06:42:53Z

content/zh/docs/tasks/tools/install-kubectl-macos.md

+<!--
+   Download the same version of the binary and checksum.
+-->
+   下载相同版本的可执行文件与校验和文件。


下载相同版本的二进制文件和校验和。

已修改，但保留了“可执行文件”

howieyuen · 2021-08-23T06:43:21Z

content/zh/docs/tasks/tools/install-kubectl-macos.md

+<!--
+1. Make kubectl-convert binary executable
+-->
+1. 给 kubectl-convert 可执行文件提供执行权限


使 kubectl-convert 二进制文件可执行

howieyuen · 2021-08-23T06:44:02Z

content/zh/docs/tasks/tools/install-kubectl-macos.md

+<!--
+1. Move the kubectl-convert binary to a file location on your system `PATH`.
+-->
+1. 将 kubectl-convert 可执行文件移动到系统 `PATH` 环境变量中的一个位置。


将 kubectl-convert 二进制文件移动到系统 PATH 环境变量中的一个位置。

保留了“可执行文件”

howieyuen · 2021-08-23T07:02:25Z

content/zh/docs/tasks/tools/install-kubectl-windows.md

+
+1. Verify plugin is successfully installed
+-->
+1. 将可执行文件添加到你的 `PATH` 环境变量。


将二级制文件添加到你的 PATH 环境变量。

保留了“可执行文件”

tengqm · 2021-08-23T13:51:24Z

binary 是可以意译成“可执行文件”的，译为“二进制文件”反而生硬。

howieyuen · 2021-08-24T02:15:53Z

binary 是可以意译成“可执行文件”的，译为“二进制文件”反而生硬。

我一开始也是这么认为的，直到看到这句“make binary executable”，“binary”是格式，“executable”是属性，二进制文件也可因为没有“+x”属性，而不可执行。那就让 @steven-my 自己斟酌吧。

steven-my · 2021-08-24T02:39:25Z

binary 是可以意译成“可执行文件”的，译为“二进制文件”反而生硬。

我一开始也是这么认为的，直到看到这句“make binary executable”，“binary”是格式，“executable”是属性，二进制文件也可因为没有“+x”属性，而不可执行。那就让 @steven-my 自己斟酌吧。

我是看到其他已经翻译的部分是把 binary 翻译成“可执行文件”，所以为了保持一致我也译成了“可执行文件”

tengqm · 2021-08-24T06:02:21Z

我一开始也是这么认为的，直到看到这句“make binary executable”，“binary”是格式，“executable”是属性，二进制文件也可因为没有“+x”属性，而不可执行。那就让 @steven-my 自己斟酌吧。

了解了。同意根据上下文来斟酌。

tengqm · 2021-08-24T06:12:41Z

content/zh/docs/tasks/tools/install-kubectl-linux.md

+-->
+### 安装 `kubectl convert` 插件
+
+{{< include "included/kubectl-convert-overview.md" >}}


This line is blocking the CI. We don't have the file yet.

should I remove this line from doc?

No. That file should be copied from the English upstream and translated.

OK, I copied this file from en to zh and translated it.

tengqm · 2021-08-24T06:13:00Z

content/zh/docs/tasks/tools/install-kubectl-macos.md

+-->
+### 安装 `kubectl convert` 插件
+
+{{< include "included/kubectl-convert-overview.md" >}}


拷贝并翻译了这个文件

tengqm · 2021-08-24T06:14:44Z

content/zh/docs/tasks/tools/install-kubectl-windows.md

+-->
+### 安装 `kubectl convert` 插件
+
+{{< include "included/kubectl-convert-overview.md" >}}


拷贝并翻译了这个文件

reylejano · 2021-08-24T19:54:44Z

/retitle [zh] translation for kubectl install section

netlify · 2021-08-26T09:12:31Z

✔️ Deploy Preview for kubernetes-io-main-staging ready!

🔨 Explore the source changes: 6e61a2b

🔍 Inspect the deploy log: https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/612c401060cff600077f1279

😎 Browse the preview: https://deploy-preview-29509--kubernetes-io-main-staging.netlify.app

howieyuen · 2021-08-26T11:50:01Z

content/zh/docs/tasks/tools/included/kubectl-convert-overview.md

+For more info, visit [migrate to non deprecated apis](/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis)
+-->
+一个 Kubernetes 命令行工具 `kubectl` 的插件，允许你将清单在不同 API 版本间转换。
+在将清单迁移到一个更新的 Kubernetes 发布中的非弃用 api 版本时，这个插件会特别有帮助。


在将清单迁移到具有较新 Kubernetes 版本的未弃用 API 版本时，这个插件特别有用。

howieyuen · 2021-08-26T11:51:23Z

content/zh/docs/tasks/tools/included/kubectl-convert-overview.md

+-->
+一个 Kubernetes 命令行工具 `kubectl` 的插件，允许你将清单在不同 API 版本间转换。
+在将清单迁移到一个更新的 Kubernetes 发布中的非弃用 api 版本时，这个插件会特别有帮助。
+更多信息请访问 [迁移到非弃用 api](/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis)


api -> API
中文本地化，需要将链接加上"/zh"前缀：/zh/docs/xxxxxx

已经修改

tengqm · 2021-08-27T12:58:04Z

content/zh/docs/tasks/tools/install-kubectl-linux.md

+   curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"
+   ```
+
+<!--


请考考虑将320和322行都缩进三个空格，避免缩进问题。

已经修改320和322行，并且修改了本文件和其他几个文件中类似的行。

howieyuen · 2021-08-30T02:23:05Z

/lgtm

k8s-ci-robot · 2021-08-30T02:23:19Z

LGTM label has been added.

Git tree hash: cdd404f1982bd99a60cc7a6665af89a32d9efe6b

tengqm · 2021-08-31T02:33:30Z

/approve

k8s-ci-robot · 2021-08-31T02:33:45Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: tengqm

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

~~content/zh/OWNERS~~ [tengqm]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 23, 2021

k8s-ci-robot requested review from howieyuen and idealhack August 23, 2021 06:17

k8s-ci-robot added the sig/docs Categorizes an issue or PR as relevant to SIG Docs. label Aug 23, 2021

steven-my force-pushed the 29329-translation-for-kubectl-install branch from e4c324a to 5e63f34 Compare August 23, 2021 06:51

howieyuen suggested changes Aug 23, 2021

View reviewed changes

steven-my force-pushed the 29329-translation-for-kubectl-install branch from 5e63f34 to 7284699 Compare August 24, 2021 02:47

tengqm reviewed Aug 24, 2021

View reviewed changes

k8s-ci-robot changed the title ~~translation for kubectl install section~~ [zh] translation for kubectl install section Aug 24, 2021

steven-my force-pushed the 29329-translation-for-kubectl-install branch from 7284699 to 0c10077 Compare August 26, 2021 08:54

howieyuen suggested changes Aug 26, 2021

View reviewed changes

steven-my force-pushed the 29329-translation-for-kubectl-install branch from 0c10077 to 2678ee5 Compare August 26, 2021 15:08

tengqm reviewed Aug 27, 2021

View reviewed changes

steven-my force-pushed the 29329-translation-for-kubectl-install branch from 2678ee5 to e72db39 Compare August 30, 2021 02:15

translation for kubectl install section

6e61a2b

steven-my force-pushed the 29329-translation-for-kubectl-install branch from e72db39 to 6e61a2b Compare August 30, 2021 02:18

k8s-ci-robot assigned howieyuen Aug 30, 2021

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 30, 2021

k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 31, 2021

k8s-ci-robot merged commit 5c316c2 into kubernetes:main Aug 31, 2021

tengqm mentioned this pull request Sep 26, 2021

[zh] Tasks files to sync for 1.22 #29329

Closed

14 tasks

steven-my mentioned this pull request Nov 8, 2021

REQUEST: New membership for steven-my kubernetes/org#3085

Closed

7 tasks

[zh] translation for kubectl install section #29509

[zh] translation for kubectl install section #29509

Conversation

steven-my commented Aug 23, 2021

howieyuen commented Aug 23, 2021

steven-my commented Aug 23, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

tengqm commented Aug 23, 2021

howieyuen commented Aug 24, 2021

steven-my commented Aug 24, 2021

tengqm commented Aug 24, 2021

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

reylejano commented Aug 24, 2021

netlify bot commented Aug 26, 2021 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

howieyuen commented Aug 30, 2021

k8s-ci-robot commented Aug 30, 2021

tengqm commented Aug 31, 2021

k8s-ci-robot commented Aug 31, 2021

netlify bot commented Aug 26, 2021 •

edited

Loading