ZH-trans: add test.md (#13297)

* Create test.md * Update test.md * Update test.md * Update test.md * Update test.md * Update test.md * Update test.md
2019-06-16 21:18:08 +08:00
parent e8d6eb2847
commit a49af9f466
1 changed files with 707 additions and 0 deletions
@@ -0,0 +1,707 @@
+---
+title: 文档冒烟测试页面
+main_menu: false
+---
+
+<!--
+title: Docs smoke test page
+main_menu: false
+-->
+
+<!--
+This page serves two purposes:
+-->
+此文档有两个用途：
+
+<!--
+- Demonstrate how the Kubernetes documentation uses Markdown
+- Provide a "smoke test" document we can use to test HTML, CSS, and template
+  changes that affect the overall documentation.
+-->
+
+- 演示 Kubernetes 文档如何使用 Markdown
+- 提供一个 "冒烟测试" 文档，我们可以使用它来测试影响整个文档的 HTML、CSS 和模板更改。
+
+<!--
+## Heading levels
+-->
+
+## 标题级别
+
+<!--
+The above heading is an H2. The page title renders as an H1. The following
+sections show H3-H6.
+-->
+上面的标题是 H2。页面标题呈现为 H1。以下部分显示 H3-H6。
+
+### H3
+
+<!--
+This is in an H3 section.
+-->
+这是在 H3 部分。
+
+#### H4
+
+<!--
+This is in an H4 section.
+-->
+这是在 H4 部分。
+
+
+##### H5
+
+<!--
+This is in an H5 section.
+-->
+这是在 H5 部分。
+
+###### H6
+
+<!--
+This is in an H6 section.
+-->
+这是在 H6 部分。
+
+<!--
+## Inline elements
+-->
+## 内联元素
+
+<!--
+Inline elements show up within the text of paragraph, list item, admonition, or
+other block-level element.
+-->
+内联元素出现在段落、列表项、警告或其他块级元素的文本中。
+
+<!--
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor
+incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis
+nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
+Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu
+fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
+culpa qui officia deserunt mollit anim id est laborum.
+-->
+
+
+<!--
+### Inline text styles
+-->
+
+### 内联文本样式
+
+<!--
+- **bold**
+- _italic_
+- ***bold italic***
+- ~~strikethrough~~
+- <u>underline</u>
+- _<u>underline italic</u>_
+- **<u>underline bold</u>**
+- ***<u>underline bold italic</u>***
+- `monospace text`
+- **`monospace bold`**
+-->
+
+- **粗体**
+- _斜体_
+- ***加粗斜体***
+- ~~删除线~~
+- <u>下划线</u>
+- _<u>强调斜体</u>_
+- **<u>强调 bold</u>**
+- ***<u>粗体斜体加下划线</u>***
+- `等宽字体文本`
+- **`等宽字体 bold`**
+
+<!--
+## Lists
+-->
+
+## 列表
+
+<!--
+Markdown doesn't have strict rules about how to process lists. When we moved
+from Jekyll to Hugo, we broke some lists. To fix them, keep the following in
+mind:
+-->
+Markdown 没有关于如何处理列表的严格规则。当我们从 Jekyll 搬到 Hugo 时，我们破坏了一些列表。要解决这些问题，请记住以下几点:
+
+<!--
+- Make sure you indent sub-list items **4 spaces** rather than the 2 that you
+  may be used to. Counter-intuitively, you need to indent block-level content
+  within a list item an extra 4 spaces too.
+
+- To end a list and start another, you need a HTML comment block on a new line
+  between the lists, flush with the left-hand border. The first list won't end
+  otherwise, no matter how many blank lines you put between it and the second.
+-->
+
+- 确保缩进子列表项**4个空格**而不是您可能习惯的2个空格。与直觉相反，您需要将列表项中的块级内容缩进额外的4个空格。
+- 要结束列表并启动另一个列表，您需要在列表之间的新行上使用 HTML 注释块，并使用左侧边框刷新。
+  无论你在第一个列表和第二个列表之间放置多少空行，第一个列表都不会以其他方式结束。
+
+<!--
+### Bullet lists
+-->
+
+### 项目符号列表
+
+<!--
+- This is a list item
+* This is another list item in the same list
+- You can mix `-` and `*`
+    - To make a sub-item, indent two tabstops (4 spaces). **This is different
+      from Jekyll and Kramdown.**
+        - This is a sub-sub-item. Indent two more tabstops (4 more spaces).
+    - Another sub-item.
+-->
+
+- 这是一个列表项
+* 这是同一列表中的另一个列表项
+- 你可以把 `-` 和 `*` 混合
+    - 要生成一个子项目，缩进两个制表符(4个空格)。**这和 Jekyll 和 Kramdown 不一样。**
+        - 这是一个子项目。缩进另外两个制表符（另外4个空格）。
+    - 另一个子项目。
+
+<!-- separate lists -->
+
+<!--
+- This is a new list. With Hugo, you need to use a HTML comment to separate two
+  consecutive lists. **The HTML comment needs to be at the left margin.**
+- Bullet lists can have paragraphs or block elements within them.
+-->
+- 这是一个新列表。使用 Hugo，您需要使用 HTML 注释来分隔两个连续的列表。**HTML 注释需要在左边的空白处。**
+- 项目符号列表可以包含段落或块元素。
+
+<!--
+      Indent the content to be one tab stop beyond the text of the bullet
+      point. **This paragraph and the code block line up with the second `l` in
+      `Bullet` above.**
+-->
+      将内容缩进到项目符号文本之外的一个制表符。**本段和代码块与上面 `Bullet` 中的第二个 `l` 对齐。**
+
+      ```bash
+      ls -l
+      ```
+
+      - 以及一些块级内容之后的子列表
+
+<!--
+- A bullet list item can contain a numbered list.
+    1.  Numbered sub-list item 1
+    2.  Numbered sub-list item 2
+-->
+
+- 项目符号列表项可以包含编号列表。
+    1.  编号的子列表项目 1
+    2.  编号的子列表项目 2
+
+<!--
+### Numbered lists
+-->
+
+### 编号列表
+
+<!--
+1.  This is a list item
+2.  This is another list item in the same list. The number you use in Markdown
+    does not necessarily correlate to the number in the final output. By
+    convention, we keep them in sync.
+3.  {{<note>}}
+    For single-digit numbered lists, using two spaces after the period makes
+    interior block-level content line up better along tab-stops.
+    {{</note>}}
+-->
+
+1.  这是一个列表项
+2.  这是同一列表中的另一个列表项。在 Markdown 中使用的数字不一定与最终输出中的数字相关。按照惯例，我们使它们保持同步。
+3.  {{<note>}}
+    对于单位数字编号列表，在句点后使用两个空格可使内部块级内容沿制表符更好地排列。
+    {{</note>}}
+
+
+<!-- separate lists -->
+
+<!--
+1.  This is a new list. With Hugo, you need to use a HTML comment to separate
+    two consecutive lists. **The HTML comment needs to be at the left margin.**
+2.  Numbered lists can have paragraphs or block elements within them.
+
+      Just indent the content to be one tab stop beyond the text of the bullet
+      point. **This paragraph and the code block line up with the `m` in
+      `Numbered` above.**
+-->
+1.  这是一个新的列表。使用 Hugo，您需要使用 HTML 注释来分隔两个连续的列表。**HTML 注释需要在左边的空白处**
+2.  编号列表可以包含段落或块元素。
+
+    只需将内容缩进到 bullet 文本之外的一个制表符停止即可。**本段和代码块与上面 `Numbered` 中的 `m` 对齐。**
+
+
+      ```bash
+      $ ls -l
+      ```
+
+<!--
+    - And a sub-list after some block-level content. This is at the same
+      "level" as the paragraph and code block above, despite being indented
+      more.
+-->
+    - 以及块级内容之后的子列表。这与上面的段落和代码块处于同一"级别"，尽管缩进更多。
+
+
+<!--
+### Tab lists
+-->
+
+### 标签列表
+
+<!--
+Tab lists can be used to conditionally display content, e.g., when multiple
+options must be documented that require distinct instructions or context.
+-->
+标签列表可用于有条件地显示内容，例如，当必须记录多个需要不同指令或上下文的选项时。
+
+{{< tabs name="tab_lists_example" >}}
+{{% tab name="Choose one..." %}}
+
+<!--
+Please select an option.
+-->
+请选择一个选项。
+
+{{% /tab %}}
+{{% tab name="Formatting tab lists" %}}
+
+<!--
+Tabs may also nest formatting styles.
+-->
+标签也可以嵌套格式样式。
+
+<!--
+1. Ordered
+1. (Or unordered)
+1. Lists
+-->
+
+1. 有序
+2. （或无序）
+3. 列表
+
+```bash
+$ echo 'Tab lists may contain code blocks!'
+```
+
+{{% /tab %}}
+{{% tab name="Nested headers" %}}
+
+<!--
+### Header within a tab list
+-->
+
+### 标签列表中的标题
+
+<!--
+Nested header tags may also be included.
+-->
+还可以包括嵌套标题标签。
+
+{{< warning >}}
+
+<!--
+Headers within tab lists will not appear in the Table of Contents.
+-->
+标签列表中的标题不会出现在目录中。
+
+{{< /warning >}}
+
+{{% /tab %}}
+{{< /tabs >}}
+
+<!--
+### Checklists
+-->
+
+### 检查列表
+
+<!--
+Checklists are technically bullet lists, but the bullets are suppressed by CSS.
+-->
+检查列表在技术上是 bullet 列表，但项目符号被 CSS 抑制。
+
+<!--
+- [ ] This is a checklist item
+- [x] This is a selected checklist item
+-->
+
+- [ ] 这是一个检查列表项目
+- [x] 这是一个选定的检查表项
+
+<!--
+## Code blocks
+-->
+
+## 代码块
+
+<!--
+You can create code blocks two different ways by surrounding the code block with
+three back-tick characters on lines before and after the code block. **Only use
+back-ticks (code fences) for code blocks.** This allows you to specify the
+language of the enclosed code, which enables syntax highlighting. It is also more
+predictable than using indentation.
+-->
+您可以用两种不同的方法创建代码块，方法是使用三个反勾号围绕代码块来以两种不同的方式创建代码块。
+**仅对代码块使用反向标记（代码栏）**，这允许您指定所附代码的语言，从而启用语法高亮显示。它也比缩进更容易预测。
+
+{{< warning >}}
+
+<!--
+There is one situation where you need to use indentation for code blocks: when
+the contents of the code block contain lines starting with `-` or `*` characters.
+This is due to
+[blackfriday issue #239](https://github.com/russross/blackfriday/issues/239).
+-->
+有一种情况需要对代码块使用缩进：当代码块的内容包含以 `-` 或 `*` 字符开头的行时。这是由于 [blackfriday 问题 #239](https://github.com/russross/blackfriday/issues/239).
+
+{{< /warning >}}
+
+<!--
+this is a code block created by back-ticks
+-->
+
+```
+这是由反勾号创建的代码块
+```
+
+<!--
+The back-tick method has some advantages.
+-->
+反勾号方法有一些优点。
+
+<!--
+- It works nearly every time
+- It is more compact when viewing the source code.
+- It allows you to specify what language the code block is in, for syntax
+  highlighting.
+- It has a definite ending. Sometimes, the indentation method breaks with
+  languages where spacing is significant, like Python or YAML.
+-->
+- 几乎每次都有效
+- 查看源代码，它更紧凑。
+- 它允许您指定代码块所在的语言，用于语法高亮显示。
+- 它有一个明确的结尾。有时候，缩进方法会中断一些间距很大的语言，比如 Python 或 YAML。
+
+<!--
+To specify the language for the code block, put it directly after the first
+grouping of back-ticks:
+-->
+要为代码块指定语言，请将其直接放在第一个代码块之后
+反勾号的分组：
+
+```bash
+ls -l
+```
+
+<!--
+Common languages used in Kubernetes documentation code blocks include:
+-->
+Kubernetes 文档代码块中使用的通用语言包括：
+
+<!--
+- `bash` / `shell` (both work the same)
+- `go`
+- `json`
+- `yaml`
+- `xml`
+- `none` (disables syntax highlighting for the block)
+-->
+- `bash` / `shell` (两者都相同)
+- `go`
+- `json`
+- `yaml`
+- `xml`
+- `none` (禁用块的语法突出显示)
+
+<!--
+### Code blocks containing Hugo shortcodes
+-->
+
+### 包含 Hugo 短代码的代码块
+
+<!--
+To show raw Hugo shortcodes as in the above example and prevent Hugo
+from interpreting them, use C-style comments directly after the `<` and before
+the `>` characters. The following example illustrates this (view the Markdown
+source for this page).
+-->
+要显示上面示例中的原始 Hugo 短代码并防止 Hugo 解释它们，请在 `<` 后面和 `>` 字符之前直接使用 C 风格的注释。
+下面的例子说明了这一点（查看此页面的 Markdown 源代码）。
+
+```none
+{{</* codenew file="pods/storage/gce-volume.yaml" */>}}
+```
+
+<!--
+## Links
+-->
+
+## 链接
+
+<!--
+To format a link, put the link text inside square brackets, followed by the
+link target in parentheses. [Link to Kubernetes.io](https://kubernetes.io/) or
+[Relative link to Kubernetes.io](/)
+-->
+要格式化链接，请将链接文本放在方括号中，然后将链接目标放在圆括号中。[链接到 Kubernetes.io](https://kubernetes.io/) 或者 
+[Kubernetes.io 的相关链接](/)
+
+<!--
+You can also use HTML, but it is not preferred.
+<a href="https://kubernetes.io/">Link to Kubernetes.io</a>
+-->
+您也可以使用 HTML，但不推荐使用它。
+<a href="https://kubernetes.io/">链接到 Kubernetes.io</a>
+
+<!--
+## Images
+-->
+
+## 图片
+
+<!--
+To format an image, use similar syntax to [links](#links), but add a leading `!`
+character. The square brackets contain the image's alt text. Try to always use
+alt text so that people using screen readers can get some benefit from the
+image.
+-->
+要格式化图片，请使用与[链接](#links)类似的语法，但要添加一个前导 `!` 字符。
+方括号包含图片的 alt 文本。尽量使用 alt 文本，这样使用屏幕阅读器的人就可以从图片中获得一些好处。
+
+<!--
+![pencil icon](/static/images/pencil.png)
+-->
+
+![铅笔图标](/static/images/pencil.png)
+
+<!--
+To specify extended attributes, such as width, title, caption, etc, use the
+<a href="https://gohugo.io/content-management/shortcodes/#figure">figure shortcode</a>,
+which is preferred to using a HTML `<img>` tag. Also, if you need the image to
+also be a hyperlink, use the `link` attribute, rather than wrapping the whole
+figure in Markdown link syntax as shown below.
+-->
+要指定扩展属性，如宽度、标题、标题等，请使用<a href="https://gohugo.io/content-management/shortcodes/#figure">图形短代码</a>
+这是首选使用 HTML `<img>` 标签。此外，如果您需要图片也是一个超链接，请使用 `link` 属性，而不是用 Markdown 链接语法包装整个图片，如下所示。
+
+<!--
+{{< figure src="/static/images/pencil.png" title="Pencil icon" caption="Image used to illustrate the figure shortcode" width="200px" >}}
+-->
+{{< figure src="/static/images/pencil.png" title="铅笔图标”" caption="用于说明图片短代码的图片" width="200px" >}}
+
+<!--
+Even if you choose not to use the figure shortcode, an image can also be a link. This
+time the pencil icon links to the Kubernetes website. Outer square brackets enclose
+the entire image tag, and the link target is in the parentheses at the end.
+-->
+即使您选择不使用图形短代码，图片也可以是链接。这一次铅笔图标链接到 Kubernetes 网站。外部方括号将整个图像标记括起来，链接目标位于末尾的括号中。
+
+<!--
+[![pencil icon](/static/images/pencil.png)](https://kubernetes.io)
+-->
+[![铅笔图标](/static/images/pencil.png)](https://kubernetes.io)
+
+<!--
+You can also use HTML for images, but it is not preferred.
+-->
+您还可以对图片使用 HTML，但不推荐使用 HTML。
+
+<img src="/static/images/pencil.png" alt="pencil icon" />
+
+<!--
+## Tables
+-->
+
+## 表
+
+<!--
+Simple tables have one row per line, and columns are separated by `|`
+characters. The header is separated from the body by cells containing nothing
+but at least three `-` characters. For ease of maintenance, try to keep all the
+cell separators even, even if you heed to use extra space.
+-->
+简单表每行有一行，列由 `|` 字符分隔。标题由包含任何内容但至少包含三个 `-` 字符的单元格与主体分隔。
+为了便于维护，尽量保持所有的单元分隔符，即使你注意使用额外的空间。
+
+<!--
+| Heading cell 1 | Heading cell 2 |
+|----------------|----------------|
+| Body cell 1    | Body cell 2    |
+-->
+
+| 标题单元 1     | 标题单元 2    |
+|---------------|----- ---------|
+| 主体单元 1     | 主体单元 2    |
+
+
+<!--
+The header is optional. Any text separated by `|` will render as a table.
+-->
+标题头是可选的。任何以 `|` 分隔的文本都将呈现为一个表。
+
+<!--
+Markdown tables have a hard time with block-level elements within cells, such as
+list items, code blocks, or multiple paragraphs. For complex or very wide
+tables, use HTML instead.
+-->
+Markdown 在单元格中很难处理块级元素，例如列表项代码块或多个段落。对于复杂或非常宽的表，可以使用 HTML。
+
+<!--
+<table>
+<thead>
+  <tr>
+    <th>Heading cell 1</th>
+    <th>Heading cell 2</th>
+  </tr>
+</thead>
+<tbody>
+  <tr>
+    <td>Body cell 1</td>
+    <td>Body cell 2</td>
+  </tr>
+</tbody>
+</table>
+-->
+
+<table>
+<thead>
+  <tr>
+    <th>标题单元 1</th>
+    <th>标题单元 2</th>
+  </tr>
+</thead>
+<tbody>
+  <tr>
+    <td>主体单元 1</td>
+    <td>主体单元 2</td>
+  </tr>
+</tbody>
+</table>
+
+<!--
+## Sidebars and Admonitions
+-->
+
+## 侧边栏和警告
+
+<!--
+Sidebars and admonitions provide ways to add visual importance to text. Use
+them sparingly.
+-->
+侧边栏和警告提供了为文本添加视觉重要性的方法。谨慎使用它们。
+
+<!--
+### Sidebars
+-->
+
+### 侧边栏
+
+<!--
+A sidebar offsets text visually, but without the visual prominence of
+[admonitions](#admonitions).
+-->
+侧边栏在视觉上抵消了文本的影响，但是没有[警告](#admonitions)的视觉突出。
+
+<!--
+> This is a sidebar.
+>
+> You can have paragraphs and block-level elements within a sidebar.
+>
+> You can even have code blocks.
+>
+> ```bash
+> sudo dmesg
+> ```
+>
+-->
+
+
+> 这是一个侧边栏。
+>
+> 您可以在侧栏中包含段落和块级元素。
+>
+> 你甚至可以拥有代码块。
+>
+> ```bash
+> sudo dmesg
+> ```
+>
+
+
+<!--
+### Admonitions
+-->
+
+### 警告
+
+<!--
+Admonitions (notes, warnings, etc) use Hugo shortcodes.
+-->
+警告（注释，警告等）使用 Hugo 短代码。
+
+
+{{< note >}}
+
+<!--
+Notes catch the reader's attention without a sense of urgency.
+
+You can have multiple paragraphs and block-level elements inside an admonition.
+-->
+笔记能抓住读者的注意力，而不带紧迫感。
+
+警告中可以包含多个段落和块级元素。
+
+
+| Or | a | table |
+{{< /note >}}
+
+{{< caution >}}
+
+<!--
+The reader should proceed with caution.
+-->
+读者应该谨慎行事。
+
+{{< /caution >}}
+
+
+{{< warning >}}
+
+<!--
+Warnings point out something that could cause harm if ignored.
+-->
+警告指出如果被忽略可能会造成损害的事情。
+
+{{< /warning >}}
+
+
+<!--
+## Includes
+
+To add shortcodes to includes.
+-->
+
+## 包含
+
+添加包含的短代码。
+
+{{< note >}}
+{{< include "federation-current-state.md" >}}
+{{< /note >}}
+
+<!--
+## Katacoda Embedded Live Environment
+-->
+
+## Katacoda 嵌入式实时环境
+
+{{< kat-button >}}