Try Our Interactive Tutorials

Kubernetes v1.12 版本的文档已不再维护。您现在看到的版本来自于一份静态的快照。如需查阅最新文档，请点击 最新版本。

Edit This Page

文档冒烟测试页面

此文档有两个用途：

标题级别

上面的标题是 H2。页面标题呈现为 H1。以下部分显示 H3-H6。

H3

这是在 H3 部分。

H4

这是在 H4 部分。

H5

这是在 H5 部分。

H6

这是在 H6 部分。

内联元素

内联元素出现在段落、列表项、警告或其他块级元素的文本中。

内联文本样式

列表

Markdown 没有关于如何处理列表的严格规则。当我们从 Jekyll 搬到 Hugo 时，我们破坏了一些列表。要解决这些问题，请记住以下几点:

项目符号列表

  将内容缩进到项目符号文本之外的一个制表符。**本段和代码块与上面 `Bullet` 中的第二个 `l` 对齐。**

  ```bash
  ls -l
  ```

  - 以及一些块级内容之后的子列表

编号列表

  1. 这是一个列表项
  2. 这是同一列表中的另一个列表项。在 Markdown 中使用的数字不一定与最终输出中的数字相关。按照惯例，我们使它们保持同步。
  3. Note: 
    对于单位数字编号列表，在句点后使用两个空格可使内部块级内容沿制表符更好地排列。
  1. 这是一个新的列表。使用 Hugo，您需要使用 HTML 注释来分隔两个连续的列表。HTML 注释需要在左边的空白处

  2. 编号列表可以包含段落或块元素。

    只需将内容缩进到 bullet 文本之外的一个制表符停止即可。本段和代码块与上面 Numbered 中的 m 对齐。

      $ ls -l
- 以及块级内容之后的子列表。这与上面的段落和代码块处于同一"级别"，尽管缩进更多。

标签列表

标签列表可用于有条件地显示内容，例如，当必须记录多个需要不同指令或上下文的选项时。

请选择一个选项。

标签也可以嵌套格式样式。

  1. 有序
  2. （或无序）
  3. 列表
$ echo 'Tab lists may contain code blocks!'

标签列表中的标题

还可以包括嵌套标题标签。

Warning:

标签列表中的标题不会出现在目录中。

检查列表

检查列表在技术上是 bullet 列表，但项目符号被 CSS 抑制。

代码块

您可以用两种不同的方法创建代码块，方法是使用三个反勾号围绕代码块来以两种不同的方式创建代码块。 仅对代码块使用反向标记（代码栏），这允许您指定所附代码的语言，从而启用语法高亮显示。它也比缩进更容易预测。

Warning:

有一种情况需要对代码块使用缩进：当代码块的内容包含以 - 或 * 字符开头的行时。这是由于 blackfriday 问题 #239.

这是由反勾号创建的代码块

反勾号方法有一些优点。

要为代码块指定语言，请将其直接放在第一个代码块之后 反勾号的分组：

ls -l

Kubernetes 文档代码块中使用的通用语言包括：

包含 Hugo 短代码的代码块

要显示上面示例中的原始 Hugo 短代码并防止 Hugo 解释它们，请在 < 后面和 > 字符之前直接使用 C 风格的注释。 下面的例子说明了这一点（查看此页面的 Markdown 源代码）。

{{< codenew file="pods/storage/gce-volume.yaml" >}}

链接

要格式化链接，请将链接文本放在方括号中，然后将链接目标放在圆括号中。链接到 Kubernetes.io 或者 Kubernetes.io 的相关链接

您也可以使用 HTML，但不推荐使用它。 链接到 Kubernetes.io

图片

要格式化图片，请使用与链接类似的语法，但要添加一个前导 ! 字符。 方括号包含图片的 alt 文本。尽量使用 alt 文本，这样使用屏幕阅读器的人就可以从图片中获得一些好处。

铅笔图标

要指定扩展属性，如宽度、标题、标题等，请使用图形短代码 这是首选使用 HTML <img> 标签。此外，如果您需要图片也是一个超链接，请使用 link 属性，而不是用 Markdown 链接语法包装整个图片，如下所示。

用于说明图片短代码的图片

铅笔图标”

用于说明图片短代码的图片

即使您选择不使用图形短代码，图片也可以是链接。这一次铅笔图标链接到 Kubernetes 网站。外部方括号将整个图像标记括起来，链接目标位于末尾的括号中。

铅笔图标

您还可以对图片使用 HTML，但不推荐使用 HTML。

pencil icon

表

简单表每行有一行，列由 | 字符分隔。标题由包含任何内容但至少包含三个 - 字符的单元格与主体分隔。 为了便于维护，尽量保持所有的单元分隔符，即使你注意使用额外的空间。

| 标题单元 1 | 标题单元 2 | |—————|—– ———| | 主体单元 1 | 主体单元 2 |

标题头是可选的。任何以 | 分隔的文本都将呈现为一个表。

Markdown 在单元格中很难处理块级元素，例如列表项代码块或多个段落。对于复杂或非常宽的表，可以使用 HTML。

标题单元 1 标题单元 2
主体单元 1 主体单元 2

侧边栏和警告

侧边栏和警告提供了为文本添加视觉重要性的方法。谨慎使用它们。

侧边栏

侧边栏在视觉上抵消了文本的影响，但是没有警告的视觉突出。

这是一个侧边栏。

您可以在侧栏中包含段落和块级元素。

你甚至可以拥有代码块。

sudo dmesg

警告

警告（注释，警告等）使用 Hugo 短代码。

Note:

笔记能抓住读者的注意力，而不带紧迫感。

警告中可以包含多个段落和块级元素。

| Or | a | table |

Caution:

读者应该谨慎行事。

Warning:

警告指出如果被忽略可能会造成损害的事情。

包含

添加包含的短代码。

Note:

Federation V1, the current Kubernetes federation API which reuses the Kubernetes API resources ‘as is’, is currently considered alpha for many of its features. There is no clear path to evolve the API to GA; however, there is a Federation V2 effort in progress to implement a dedicated federation API apart from the Kubernetes API. The details are available at sig-multicluster community page. –>

Federation V1， 是当前的 Kubernetes 联邦 API， 它“原样”重用 Kubernetes API 资源， 其许多特性目前被认为是 alpha。 没有明确的途径将 API 发展成 GA； 然而， 除了 Kubernetes API 之外， 还有一个 Federation V2 正在努力实现专用的联邦 API。详细信息可在 sig-multicluster 社区页面 获得。

Katacoda 嵌入式实时环境

反馈