Merge pull request #35782 from windsonsea/pagecon

[zh-cn] updated style-guide & page-content-types

Author: k8s-ci-robot

content/zh-cn/docs/contribute/style/page-content-types.md

@@ -88,7 +88,7 @@ For example, to create a `whatsnext` heading, add the heading shortcode with the
 - seealso
 - options
 
-例如，要创建一个 `whatsnext` 标题，添加 heading 短代码并指定 "whatsnext" 字符串：
+例如，要创建一个 `whatsnext` 标题，添加 `heading` 短代码并指定 "whatsnext" 字符串：
 
 ```none
 ## {{%/* heading "whatsnext" */%}}
@@ -163,16 +163,16 @@ Concept pages are divided into three sections:
 中的 Deployment 对象，解释其作为应用的角色如何部署、扩缩和更新。
 通常，概念页面不需要包含步骤序列，但包含指向任务或教程的链接。
 
-要编写一个新的概念页面，在 `/content/en/docs/concepts` 目录下面的子目录中新建
-一个 Markdown 文件。该文件具有以下特点。
+要编写一个新的概念页面，在 `/content/en/docs/concepts` 目录下面的子目录中新建一个 Markdown 文件。
+该文件具有以下特点。
 
 概念页面分为三个章节：
 
 | 页面章节           |
 |--------------------|
-| overview （概述）  |
-| body (主体）       |
-| whatsnext (接下来）|
+| overview（概述）  |
+| body（正文）      |
+| whatsnext（接下来）|
 
 <!--
 The `overview` and `body` sections appear as comments in the concept page.
@@ -193,13 +193,12 @@ published example of a concept page.
 
 在为每个章节撰写内容时，遵从一些规定：
 
-- 使用二级和三级标题（H2、H3）来组织内容
-- 在 `overview` 节中，使用一段文字来为主体部分铺陈上下文；
+- 使用二级和三级标题（H2、H3）来组织内容；
+- 在 `overview` 节中，使用一段文字概括当前主题的上下文；
 - 在 `body` 节中，详细解释对应概念；
-- 对于 `whatsnext` 节，提供一个项目符号列表（最多 5 个），帮助读者进一步学习掌握概念
+- 对于 `whatsnext` 节，提供一个项目符号列表（最多 5 个），帮助读者进一步学习掌握概念。
 
-[注解](/zh-cn/docs/concepts/overview/working-with-objects/annotations/)页面是一个已经
-上线的概念页面的例子。
+[注解](/zh-cn/docs/concepts/overview/working-with-objects/annotations/)页面是一个已经上线的概念页面的例子。
 
 <!--
 ### Task
@@ -222,19 +221,18 @@ To write a new task page, create a Markdown file in a subdirectory of the
 ### 任务（Task）  {#task}
 
 任务页面讲解如何完成某项工作，通常包含由为数不多的几个步骤组成的序列。
-任务页面的讲解文字很少，不过通常会包含指向概念主题的链接，以便读者
-能够了解相关的背景和知识。
+任务页面的讲解文字很少，不过通常会包含指向概念主题的链接，以便读者能够了解相关的背景和知识。
 
-编写新的任务页面时，在 `/content/en/docs/tasks` 目录下的子目录中创建一个
-新的 Markdown 文件。该文件特点如下。
+编写新的任务页面时，在 `/content/en/docs/tasks` 目录下的子目录中创建一个新的 Markdown 文件。
+该文件特点如下。
 
 | 页面章节                  |
 |---------------------------|
-| overview （概述）         |
-| prerequisites （准备工作）|
-| steps （步骤）            |
-| discussion （讨论）       |
-| whatsnext （接下来）      |
+| overview（概述）         |
+| prerequisites（准备工作）|
+| steps（步骤）            |
+| discussion（讨论）       |
+| whatsnext（接下来）      |
 
 <!--
 The `overview`, `steps`, and `discussion` sections appear as comments in the task page.
@@ -261,17 +259,16 @@ An example of a published task topic is [Using an HTTP proxy to access the Kuber
 
 在每个小节内撰写内容时注意以下规定：
 
-- 最低使用二级标题（H2，标题行前带两个 `#` 字符）。每个小节都会由模版自动给出标题。
-- 在 `overview` 节中，用一个段落为整个任务主体设定语境；
+- 最低使用二级标题（H2，标题行前带两个 `#` 字符）。每个小节都会由模板自动给出标题。
+- 在 `overview` 节中，用一个段落为整个任务主题设定语境；
 - 在 `prerequisites` 节中，尽可能使用项目符号列表。
   额外的环境准备条件要加在 `include` 短代码之后。
   默认的环境准备条件是拥有一个在运行的 Kubernetes 集群。
 - 在 `steps` 节中，使用编号符号列表。
 - 在 `discussion` 节中，使用正常文字内容来对 `steps` 节中内容展开叙述。
-- 在 `whatsnext` 节中，使用项目符号列表（不超过 5 项），列举读者可能接下来有兴趣
-  阅读的主题。
+- 在 `whatsnext` 节中，使用项目符号列表（不超过 5 项），列举读者可能接下来有兴趣阅读的主题。
 
-已上线的任务主题示例之一是[使用 HTTP 代理来访问 Kubernetes API](/zh-cn/docs/tasks/extend-kubernetes/http-proxy-access-api/)。
+已上线的任务主题示例之一是[使用 HTTP 代理访问 Kubernetes API](/zh-cn/docs/tasks/extend-kubernetes/http-proxy-access-api/)。
 
 <!--
 ### Tutorial
@@ -298,21 +295,21 @@ To write a new tutorial page, create a Markdown file in a subdirectory of the
 ### 教程（Tutorial）  {#tutorial}
 
 教程页面描述如果完成一个比单一任务规模更大的目标。通常教程页面会有多个小节，
-每个小节由一系列步骤组成。例如，每个教程可能提供对代码示例的讲解，便于用户
-了解 Kubernetes 的某个功能特性。教程可以包含表面层面的概念解释，对于更深层面
-的概念主题应该使用链接。
+每个小节由一系列步骤组成。例如，每个教程可能提供对代码示例的讲解，
+便于用户了解 Kubernetes 的某个功能特性。教程可以包含表面层面的概念解释，
+对于更深层面的概念主题应该使用链接。
 
 撰写新的教程页面时，在 `/content/en/docs/tutorials` 目录下面的子目录中创建新的
 Markdown 文件。该文件有以下特点。
 
 | 页面节区                  |
 |---------------------------|
-| overview （概述）         |
-| prerequisites （环境准备）|
-| objectives （目标）       |
-| lessoncontent （教程内容）|
-| cleanup （清理工作）      |
-| whatsnext （接下来）      |
+| overview（概述）         |
+| prerequisites（环境准备）|
+| objectives（目标）       |
+| lessoncontent（教程内容）|
+| cleanup（清理工作）      |
+| whatsnext（接下来）      |
 
 <!--
 The `overview`, `objectives`, and `lessoncontent` sections appear as comments in the tutorial page.
@@ -335,23 +332,22 @@ Within each section, write your content. Use the following guidelines:
   interested in reading next.
 
 An example of a published tutorial topic is
-[Running a Stateless Application Using a Deployment](/docs/tutorials/stateless-application/run-stateless-application-deployment/).
+[Running a Stateless Application Using a Deployment](/docs/tasks/run-application/run-stateless-application-deployment/).
 -->
 教程页面的 `overview`、`objectives` 和 `lessoncontent` 小节显示为注释形式。
 你可以使用 `heading` 短代码根据需要添加 `prerequisites`、`cleanup` 和
 `whatsnext` 小节。
 
 在每个小节中编写内容时，请注意以下规定：
 
-- 最低使用二级标题（H2，标题前面有两个 `#` 字符）。模版会自动为每个小节设置标题。
+- 最低使用二级标题（H2，标题前面有两个 `#` 字符）。模板会自动为每个小节设置标题。
 - 在 `overview` 节中，用一个段落为整个主题设定语境；
 - 在 `prerequisites` 节中，尽可能使用项目符号列表。
   额外的环境准备条件要加在已包含的条件之后。
 - 在 `objectives` 节中，使用项目符号列表。
 - 在 `lessoncontent` 节中，结合使用编号符号列表和叙述性文字。
 - 在 `cleanup` 节中，使用编号符号列表来描述任务结束后清理集群状态所需要的步骤。
-- 在 `whatsnext` 节中，使用项目符号列表（不超过 5 项），列举读者可能接下来有兴趣
-  阅读的主题。
+- 在 `whatsnext` 节中，使用项目符号列表（不超过 5 项），列举读者可能接下来有兴趣阅读的主题。
 
 已发布的教程主题的一个例子是
 [使用 Deployment 运行无状态应用](/zh-cn/docs/tasks/run-application/run-stateless-application-deployment/).
@@ -365,7 +361,7 @@ a Kubernetes component tool. Each page generates from scripts using the componen
 A tool reference page has several possible sections:
 
 | Page section                 |
-|--------------------------------|
+|------------------------------|
 | synopsis                     |
 | options                      |
 | options from parent commands |
@@ -387,11 +383,11 @@ Examples of published tool reference pages are:
 
 | 页面小节        |
 |-----------------|
-| synopsis (用法）|
+| synopsis（用法）|
 | options（选项） |
-| options from parent commands (从父命令集成的选项） |
-| examples （示例）|
-| seealso （参考）|
+| options from parent commands（从父命令集成的选项） |
+| examples（示例）|
+| seealso（参考）|
 
 已发布的工具参考页面示例包括：