[zh] Resync tasks/tools pages

Author: tengqm

content/zh-cn/docs/home/_index.md

@@ -18,11 +18,13 @@ menu:
 #   Kubernetes is an open source container orchestration engine for automating deployment, scaling, and management of containerized applications. The open source project is hosted by the Cloud Native Computing Foundation.
 description: >
   Kubernetes 是一个开源的容器编排引擎，用来对容器化应用进行自动部署、 扩缩和管理。此开源项目由云原生计算基金会（CNCF）托管。
+
 # overview:
 #  Kubernetes is an open source container orchestration engine for automating deployment, scaling, and management of containerized applications. The open source project is hosted by the Cloud Native Computing Foundation (<a href="https://www.cncf.io/about">CNCF</a>).
 overview:
   Kubernetes 是一个开源的容器编排引擎，用来对容器化应用进行自动化部署、 扩缩和管理。该项目托管在 <a href="https://www.cncf.io/about">CNCF</a>。
-# cards:
+
+cards:
 # - name: concepts
 #   title: "Understand Kubernetes"
 #   description: "Learn about Kubernetes and its fundamental concepts."
@@ -33,6 +35,16 @@ overview:
 #   description: "Follow tutorials to learn how to deploy applications in Kubernetes."
 #   button: "View Tutorials"
 #   button_path: "/docs/tutorials"
+- name: concepts
+  title: "了解 Kubernetes"
+  description: "了解 Kubernetes 及其基础概念。"
+  button: "查看概念"
+  button_path: "/zh-cn/docs/concepts"
+- name: tutorials
+  title: "尝试 Kubernetes"
+  description: "按照教程学习如何在 Kubernetes 上部署应用。"
+  button: "查看教程"
+  button_path: "/zh-cn/docs/tutorials"
 # - name: setup
 #   title: "Set up a K8s cluster"
 #   description: "Get Kubernetes running based on your resources and needs."
@@ -43,6 +55,16 @@ overview:
 #   description: "Look up common tasks and how to perform them using a short sequence of steps."
 #   button: "View Tasks"
 #   button_path: "/docs/tasks"
+- name: setup
+  title: "安裝 K8s 集群"
+  description: "基于你的资源情况和需要运行 Kubernetes。"
+  button: "安装 Kubernetes"
+  button_path: "/zh-cn/docs/setup"
+- name: tasks
+  title: "了解如何使用 Kubernetes"
+  description: "查看常见任务以及如何使用简单步骤执行它们。"
+  button: "查看任务"
+  button_path: "/zh-cn/docs/tasks"
 # - name: training
 #   title: "Training"
 #   description: "Get certified in Kubernetes and make your cloud native projects successful!"
@@ -53,40 +75,6 @@ overview:
 #   description: Browse terminology, command line syntax, API resource types, and setup tool documentation.
 #   button: View Reference
 #   button_path: /docs/reference
-# - name: contribute
-#   title: Contribute to the docs
-#   description: Anyone can contribute, whether you’re new to the project or you’ve been around a long time.
-#   button: Contribute to the docs
-#   button_path: /docs/contribute
-# - name: release-notes
-#   title: K8s Release Notes
-#   description: If you are installing Kubernetes or upgrading to the newest version, refer to the current release notes.
-#   button: "Download Kubernetes"
-#   button_path: "/zh-cn/docs/setup/release/notes"
-# - name: about
-#   title: About the documentation
-#   description: This website contains documentation for the current and previous 4 versions of Kubernetes.
-cards:
-- name: concepts
-  title: "了解 Kubernetes"
-  description: "了解 Kubernetes 和其基础概念。"
-  button: "查看概念"
-  button_path: "/zh-cn/docs/concepts"
-- name: tutorials
-  title: "尝试 Kubernetes"
-  description: "按照教程学习如何在 Kubernetes 上部署应用。"
-  button: "查看教程"
-  button_path: "/zh-cn/docs/tutorials"
-- name: setup
-  title: "设置 K8s 集群"
-  description: "按照你的资源情况和需求运行 Kubernetes。"
-  button: "设置 Kubernetes"
-  button_path: "/zh-cn/docs/setup"
-- name: tasks
-  title: "了解如何使用 Kubernetes"
-  description: "查看常见任务以及如何使用简单步骤执行它们。"
-  button: "查看任务"
-  button_path: "/zh-cn/docs/tasks"
 - name: training
   title: "培训"
   description: "通过 Kubernetes 认证，助你的云原生项目成功！"
@@ -97,16 +85,29 @@ cards:
   description: 浏览术语、命令行语法、API 资源类型和安装工具文档。
   button: 查看参考
   button_path: /zh-cn/docs/reference
+# - name: contribute
+#   title: Contribute to the docs
+#   description: Anyone can contribute, whether you’re new to the project or you’ve been around a long time.
+#   button: Contribute to the docs
+#   button_path: /docs/contribute
+# - name: release-notes
+#   title: K8s Release Notes
+#   description: If you are installing Kubernetes or upgrading to the newest version, refer to the current release notes.
+#   button: "Download Kubernetes"
+#   button_path: "/zh-cn/docs/setup/release/notes"
 - name: contribute
   title: 为文档作贡献
   description: 任何人，无论对该项目熟悉与否，都能贡献自己的力量。
   button: 为文档作贡献
   button_path: /zh-cn/docs/contribute
-- name: release-notes
-  title: K8s 发布说明
-  description: 如果你正在安装或升级 Kubernetes，最好参考最新的发布说明。
+- name: Download
+  title: 下载 Kubernetes
+  description: 安装 Kubernetes 或将其升级到最新版本。
   button: "下载 Kubernetes"
   button_path: "/releases/download"
+# - name: about
+#   title: About the documentation
+#   description: This website contains documentation for the current and previous 4 versions of Kubernetes.
 - name: about
   title: 关于文档
   description: 本网站包含了当前及前 4 个版本的 Kubernetes 文档。

content/zh-cn/docs/tasks/tools/_index.md

@@ -47,7 +47,7 @@ kubectl 可安装在各种 Linux 平台、 macOS 和 Windows 上。
 ## kind
 
 <!--
-[`kind`](https://kind.sigs.k8s.io/docs/) lets you run Kubernetes on
+[`kind`](https://kind.sigs.k8s.io/) lets you run Kubernetes on
 your local computer. This tool requires that you have
 [Docker](https://docs.docker.com/get-docker/) installed and configured.
 
@@ -56,10 +56,10 @@ shows you what you need to do to get up and running with kind.
 
 <a class="btn btn-primary" href="https://kind.sigs.k8s.io/docs/user/quick-start/" role="button" aria-label="View kind Quick Start Guide">View kind Quick Start Guide</a>
 -->
-[`kind`](https://kind.sigs.k8s.io/docs/) 让你能够在本地计算机上运行 Kubernetes。
+[`kind`](https://kind.sigs.k8s.io/) 让你能够在本地计算机上运行 Kubernetes。
 `kind` 要求你安装并配置好 [Docker](https://docs.docker.com/get-docker/)。
 
-kind [快速入门](https://kind.sigs.k8s.io/docs/user/quick-start/)页面展示了开始使用
+kind 的 [Quick Start](https://kind.sigs.k8s.io/docs/user/quick-start/) 页面展示开始使用
 `kind` 所需要完成的操作。
 
 <a class="btn btn-primary" href="https://kind.sigs.k8s.io/docs/user/quick-start/"
@@ -81,8 +81,8 @@ on getting the tool installed.
 -->
 与 `kind` 类似，[`minikube`](https://minikube.sigs.k8s.io/) 是一个工具，
 能让你在本地运行 Kubernetes。
-`minikube` 在你的个人计算机（包括 Windows、macOS 和 Linux PC）上运行一个一体化（all-in-one）或多节点的本地
-Kubernetes 集群，以便你来尝试 Kubernetes 或者开展每天的开发工作。
+`minikube` 在你的个人计算机（包括 Windows、macOS 和 Linux PC）上运行一个一体化（all-in-one）
+或多节点的本地 Kubernetes 集群，以便你来尝试 Kubernetes 或者开展每天的开发工作。
 
 如果你关注如何安装此工具，可以按官方的
 [Get Started!](https://minikube.sigs.k8s.io/docs/start/)指南操作。
@@ -125,3 +125,4 @@ Once installed, you can use it to [create a cluster](/docs/setup/production-envi
 
 <a class="btn btn-primary" href="/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm/"
   role="button" aria-label="查看 kubeadm 安装指南">查看 kubeadm 安装指南</a>
+

content/zh-cn/docs/tasks/tools/included/_index.md

@@ -3,12 +3,18 @@ title: "内含的工具"
 description: "在页面 kubectl-installs-*.md 中包含的代码片段"
 headless: true
 toc_hide: true
+_build:
+  list: never
+  render: never
+  publishResources: false
 ---
 <!-- 
----
 title: "Tools Included"
 description: "Snippets to be included in the main kubectl-installs-*.md pages."
 headless: true
 toc_hide: true
----
+_build:
+  list: never
+  render: never
+  publishResources: false
 -->

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

@@ -3,15 +3,17 @@ title: "kubectl-convert 概述"
 description: >-
   一个 kubectl 插件，允许你将清单从一个 Kubernetes API 版本转换到不同的版本。
 headless: true
+_build:
+  list: never
+  render: never
+  publishResources: false
 ---
 <!--
----
 title: "kubectl-convert overview"
 description: >-
   A kubectl plugin that allows you to convert manifests from one version
   of a Kubernetes API to a different version.
 headless: true
----
 -->
 
 <!--
@@ -21,4 +23,4 @@ For more info, visit [migrate to non deprecated apis](/docs/reference/using-api/
 -->
 一个 Kubernetes 命令行工具 `kubectl` 的插件，允许你将清单在不同 API 版本间转换。
 这对于将清单迁移到新的 Kubernetes 发行版上未被废弃的 API 版本时尤其有帮助。
-更多信息请访问 [迁移到非弃用 API](/zh-cn/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis)
+更多信息请访问[迁移到非弃用 API](/zh-cn/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis)

content/zh-cn/docs/tasks/tools/included/kubectl-whats-next.md

@@ -2,13 +2,15 @@
 title: "后续内容"
 description: "安装 kubectl 之后，还可以做些什么？"
 headless: true
+_build:
+  list: never
+  render: never
+  publishResources: false
 ---
 <!-- 
----
 title: "What's next?"
 description: "What's next after installing kubectl."
 headless: true
----
 -->
 
 <!-- 
@@ -19,9 +21,10 @@ headless: true
   [Sharing Cluster Access document](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
 * Read the [kubectl reference docs](/docs/reference/kubectl/kubectl/)
 -->
-* [安装 Minikube](https://minikube.sigs.k8s.io/docs/start/)
-* 有关创建集群的更多信息，请参阅[入门指南](/zh-cn/docs/setup/).
-* [学习如何启动并对外公开你的应用程序。](/zh-cn/docs/tasks/access-application-cluster/service-access-application-cluster/)
-* 如果你需要访问其他人创建的集群，请参阅
-  [共享集群接入文档](/zh-cn/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
-* 阅读 [kubectl 参考文档](/zh-cn/docs/reference/kubectl/kubectl/)
+* [安装 Minikube](https://minikube.sigs.k8s.io/docs/start/)。
+* 有关创建集群的更多信息，请参阅[入门指南](/zh-cn/docs/setup/)。
+* [学习如何启动并对外公开你的应用程序](/zh-cn/docs/tasks/access-application-cluster/service-access-application-cluster/)。
+* 如果你需要访问其他人创建的集群，
+  请参阅[共享集群接入文档](/zh-cn/docs/tasks/access-application-cluster/configure-access-multiple-clusters/)。
+* 阅读 [kubectl 参考文档](/zh-cn/docs/reference/kubectl/kubectl/)。
+

content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-bash-linux.md

@@ -2,6 +2,11 @@
 title: "Linux 系统中的 Bash 自动补全功能"
 description: "Linux 系统中 Bash 自动补全功能的一些可选配置。"
 headless: true
+_build:
+  list: never
+  render: never
+  publishResources: false
+
 ---
 <!-- 
 title: "bash auto-completion on Linux"
@@ -96,11 +101,11 @@ bash-completion 负责导入 `/etc/bash_completion.d` 目录中的所有补全
 
 <!-- 
 Both approaches are equivalent. After reloading your shell, kubectl autocompletion should be working.
-To enable bash autocompletion in current session of shell, run `exec bash`:
+To enable bash autocompletion in current session of shell, source the ~/.bashrc file:
 -->
 两种方式的效果相同。重新加载 Shell 后，kubectl 自动补全功能即可生效。
-若要在当前 Shell 会话中启用 Bash 补全功能，需要运行 `exec bash` 命令：
+若要在当前 Shell 会话中启用 Bash 补全功能，源引 `~/.bashrc` 文件：
 
 ```bash
-exec bash
+source ~/.bashrc
 ```

content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md

@@ -2,23 +2,25 @@
 title: "PowerShell 自动补全"
 description: "powershell 自动补全的一些可选配置。"
 headless: true
+_build:
+  list: never
+  render: never
+  publishResources: false
 ---
 <!--
----
 title: "PowerShell auto-completion"
 description: "Some optional configuration for powershell auto-completion."
 headless: true
----
 -->
 
 <!--
 The kubectl completion script for PowerShell can be generated with the command `kubectl completion powershell`.
 
 To do so in all your shell sessions, add the following line to your `$PROFILE` file:
 -->
-使用命令 `kubectl completion powershell` 生成 PowerShell 的 kubectl 自动补全脚本。
+你可以使用命令 `kubectl completion powershell` 生成 PowerShell 的 kubectl 自动补全脚本。
 
-如果需要自动补全在所有 shell 会话中生效，请将以下命令添加到 `$PROFILE` 文件中：
+如果需要自动补全在所有 Shell 会话中生效，请将以下命令添加到 `$PROFILE` 文件中：
 
 ```powershell
 kubectl completion powershell | Out-String | Invoke-Expression
@@ -32,7 +34,7 @@ This command will regenerate the auto-completion script on every PowerShell star
 <!--
 To add the generated script to your `$PROFILE` file, run the following line in your powershell prompt:
 -->
-如果需要将自动补全脚本直接添加到 `$PROFILE` 文件中，请在 PowerShell 终端运行以下命令：
+如果需要将自动补全脚本直接添加到 `$PROFILE` 文件中，请在 PowerShell 命令行运行以下命令：
 
 ```powershell
 kubectl completion powershell >> $PROFILE
@@ -41,4 +43,4 @@ kubectl completion powershell >> $PROFILE
 <!--
 After reloading your shell, kubectl autocompletion should be working.
 -->
-完成上述操作后重启 shell，kubectl的自动补全就可以工作了。
+完成上述操作后重启 Shell，kubectl 的自动补全就可以工作了。

content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-zsh.md

@@ -2,13 +2,15 @@
 title: "zsh 自动补全"
 description: "zsh 自动补全的一些可选配置"
 headless: true
+_build:
+  list: never
+  render: never
+  publishResources: false
 ---
 <!-- 
----
 title: "zsh auto-completion"
 description: "Some optional configuration for zsh auto-completion."
 headless: true
----
 -->
 
 <!-- 
@@ -17,9 +19,9 @@ The kubectl completion script for Zsh can be generated with the command `kubectl
 To do so in all your shell sessions, add the following to your `~/.zshrc` file:
 -->
 kubectl 通过命令 `kubectl completion zsh` 生成 Zsh 自动补全脚本。
-在 shell 中导入（Sourcing）该自动补全脚本，将启动 kubectl 自动补全功能。
+在 Shell 中导入（Sourcing）该自动补全脚本，将启动 kubectl 自动补全功能。
 
-为了在所有的 shell 会话中实现此功能，请将下面内容加入到文件 `~/.zshrc` 中。
+为了在所有的 Shell 会话中实现此功能，请将下面内容加入到文件 `~/.zshrc` 中。
 
 ```zsh
 source <(kubectl completion zsh)
@@ -36,10 +38,13 @@ After reloading your shell, kubectl autocompletion should be working.
 If you get an error like `complete:13: command not found: compdef`, then add the following to the beginning of your `~/.zshrc` file:
 If you get an error like `2: command not found: compdef`, then add the following to the beginning of your `~/.zshrc` file:
 -->
-重新加载 shell 后，kubectl 自动补全功能将立即生效。
+重新加载 Shell 后，kubectl 自动补全功能将立即生效。
+
+如果你收到 `2: command not found: compdef` 这样的错误提示，那请将下面内容添加到
+`~/.zshrc` 文件的开头：
 
-如果你收到 `2: command not found: compdef` 这样的错误提示，那请将下面内容添加到 `~/.zshrc` 文件的开头：
 ```zsh
 autoload -Uz compinit
 compinit
 ```
+

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

@@ -58,6 +58,7 @@ The following methods exist for installing kubectl on macOS:
 - [可选的 kubectl 配置和插件](#optional-kubectl-configurations-and-plugins)
   - [启用 shell 自动补全功能](#enable-shell-autocompletion)
   - [安装 `kubectl convert` 插件](#install-kubectl-convert-plugin)
+
 <!-- 
 ### Install kubectl binary with curl on macOS
 -->
@@ -426,3 +427,4 @@ kubectl 为 Bash、Zsh、Fish 和 PowerShell 提供自动补全功能，可以
 ## {{% heading "whatsnext" %}}
 
 {{< include "included/kubectl-whats-next.md" >}}
+