istio
/
istio.io
mirror of https://github.com/istio/istio.io.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

zh-translation: about/contribute/front-matter/index.md (#9205)

This commit is contained in:
凡梦星尘 2021-03-13 23:47:01 +08:00 committed by GitHub
parent ab9695ae3a
commit b17aae7bcc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
content/zh/about/contribute/front-matter/index.md
View File

@ -1,13 +1,13 @@
--- ---
title: 文章头 title: 文章头部
description: 介绍了文档中使用的文章头及其可用字段。 description: 介绍了文档中使用的文章头及其可用字段。
weight: 4 weight: 6
keywords: [metadata, navigation, table-of-contents] keywords: [metadata, navigation, table-of-contents]
--- ---
文章头（front matter）是每个文件顶部用三点划线包裹的 YAML 代码，它为我们的内容提供了重要的管理选项。例如，文章头允许我们确保现有链接对于已经完全移动或删除的页面继续有效。本页说明了 Istio 中的文章头目前可用的功能。 文章头部（front matter）是每个文件顶部用三点划线包裹的 YAML 代码，它为我们的内容提供了重要的管理选项。例如：文章头部允许我们确保现有链接对于已经完全移动或删除的页面继续有效。本页说明了 Istio 中文章头部目前可用的功能。
下面是一个文章头的示例，其中所有必填字段都由占位符填充： 下面是一个文章头部的示例，其中所有必填字段都由占位符填充：
{{< text yaml >}} {{< text yaml >}}
--- ---
@ -20,39 +20,38 @@ aliases:
--- ---
{{< /text >}} {{< /text >}}
您可以复制上面的示例，并用您页面中相应的值替换所有占位符。 您可以复制上面的示例，并在您的页面中使用相应值替换所有占位符。
## 必填字段{#required-front-matter-fields} ## 必填字段{#required-front-matter-fields}
The following table shows descriptions for all the **required** fields:
下表列举了所有的 **必填** 字段及其说明： 下表列举了所有的 **必填** 字段及其说明：
|字段 | 说明 |字段 | 说明
|-------------------|------------ |-------------------|------------
|`title` | 该页面的标题 |`title` | 该页面的标题。
|`description` | 对其该页面内容的一个简单结束 |`description` | 对其该页面内容的一个简单描述。
|`weight` | 该页面相对于当前目录中其他页面的顺序。 |`weight` | 该页面相对于当前目录中其他页面的顺序。
|`keywords` | 页面上的关键字。Hugo 根据此列表在页面末尾生成“相关内容”链接。 |`keywords` | 页面上的关键字。Hugo 根据此列表在页面末尾生成“相关内容”链接。
|`aliases` | 页面以前发布过的 URL。有关此字段的详细信息，请参见下面的[重命名、移动或删除页面](#rename-move-or-delete-pages)。 |`aliases` | 页面以前发布过的 URL。有关此字段的详细信息，请参见下面的[重命名、移动或删除页面](#rename-move-or-delete-pages)。
### 重命名、移动或删除页面{#rename-move-or-delete-pages} ### 重命名、移动或删除页面{#rename-move-or-delete-pages}
移动或完全删除页面时，必须确保指向这些页面的现有链接继续有效。文章头中的 `aliases` 字段可帮助您满足此要求。在移动或删除页面之前，将现有路径添加到 `aliases` 字段中。Hugo 自动为我们的用户实现了从旧 URL 到新 URL 的重定向。 当您移动或完全删除页面时，必须确保指向这些页面的现有链接继续有效。文章头部中的 `aliases` 字段可帮助您满足此要求。在移动或删除页面之前，将现有路径添加到 `aliases` 字段中。Hugo 为我们的用户实现了从旧 URL 到新 URL 的自动重定向。
在 _target page_（您想让用户访问的页面）上，将 _original page_ 的 `<path>` 添加到文章头中，如下所示： 在 _target page_ （您想让用户访问的页面）上，将 _original page_ 的 `<path>` 添加到文章头部中，如下所示：
{{< text plain >}} {{< text plain >}}
aliases: aliases:
- <path> - <path>
{{< /text >}} {{< /text >}}
例如，在以前，您可以在 `/zh/help/faq` 下找到我们的 FAQ 页面。为了使用户更方便的找到 FAQ 页面，我们将该页面上移了一个级别至 `/zh/faq/`，并对文章头做了以下更改： 例如，您可以在以前的 `/zh/help/faq` 下找到我们的 FAQ 页面。为了使用户更方便的找到 FAQ 页面，我们将该页面上移了一个级别至 `/zh/faq/`，并对文章头部做了以下更改：
{{< text plain >}} {{< text plain >}}
--- ---
title: Frequently Asked Questions title: Frequently Asked Questions
description: Questions Asked Frequently. description: Questions Asked Frequently.
weight: 12 weight: 13
aliases: aliases:
- /zh/help/faq - /zh/help/faq
--- ---
@ -66,7 +65,7 @@ aliases:
--- ---
title: Frequently Asked Questions title: Frequently Asked Questions
description: Questions Asked Frequently. description: Questions Asked Frequently.
weight: 12 weight: 13
aliases: aliases:
- /zh/faq - /zh/faq
- /zh/faq2 - /zh/faq2
@ -76,38 +75,38 @@ aliases:
## 可选字段{#optional-front-matter-fields} ## 可选字段{#optional-front-matter-fields}
Hugo 支持非常多的文章头字段，而此页面仅列举了在 istio.io 中实现的字段。 Hugo 支持非常多的文章头部字段，而此页面仅列举了在 istio.io 中实现的字段。
下表列举了最常用的 **可选** 字段： 下表列举了最常用的 **可选** 字段：
|字段 | 描述 |字段 | 描述
|-------------------|------------ |-------------------|------------
|`linktitle` | 短标题，常用于链接到页面。 |`linktitle` | 短标题，常用于链接到页面。
|`subtitle` | 主标题下方显示的子标题。 |`subtitle` | 主标题下方显示的副标题。
|`icon` | 标题旁边显示图标的路径。 |`icon` | 标题旁边显示图标的路径。
|`draft` | 如果为 true，该页面不会出现在网站中。 |`draft` | 如果为 true，该页面不会出现在网站中。
|`skip_byline` | 如果为 true，不会在主标题下显示下划线。 |`skip_byline` | 如果为 true，Hugo 不会在主标题下显示下划线。
|`skip_seealso` | 如果为 true， Hugo 不会为该页面生成“相关内容”链接。 |`skip_seealso` | 如果为 true， Hugo 不会为该页面生成“相关内容”链接。
一些文章头字段可用于控制自动生成的目录（ToC）。下表列举了这些字段并说明了如何使用： 一些文章头部字段可用于控制自动生成的目录（ToC）。下表列举了这些字段并说明了如何使用：
|字段 | 描述 |字段 | 描述
|--------------------|------------ |--------------------|------------
|`skip_toc` | 如果为 true，Hugo 不会为该页面生成目录 |`skip_toc` | 如果为 true，Hugo 不会为该页面生成目录。
|`force_inline_toc` | 如果为 true，Hugo 会强制在文本中插入自动生成的目录，而不是右侧的边栏。 |`force_inline_toc` | 如果为 true，Hugo 会强制在文本中插入自动生成的目录，而不是右侧的边栏。
|`max_toc_level` | 设置目录中使用的标题级别。值可以从 2 到 6。 |`max_toc_level` | 设置目录（ToC）中使用的标题级别。值可以从 2 到 6。
|`remove_toc_prefix` | Hugo 从目录中每个条目的前缀中删除此字符串。 |`remove_toc_prefix` | Hugo 从目录中每个条目的前缀中删除此字符串。
某些文章头字段仅适用于所谓的 _bundle page_。您可以辨别 _bundle page_，因为它们的文件名都是以下划线 `_` 开头，例如 `_index.md`。在 Istio 中，我们使用 _bundle page_ 作为我们的部分着陆页面。下表列举了与 _bundle page_ 相关的文章头字段。 某些文章头部字段仅适用于所谓的 _bundle page_ 。您可以辨别 _bundle page_ ，因为它们的文件名都是以下划线 `_` 开头，例如： `_index.md`。在 Istio 中，我们使用 _bundle page_ 作为我们的部分着陆页面。下表列举了与 _bundle page_ 相关的文章头部字段。
|字段 | 描述 |字段 | 描述
|----------------------|------------ |----------------------|------------
|`skip_list` | 如果为 true，Hugo 不会自动生成该部分页面的内容图块。 |`skip_list` | 如果为 true，Hugo 不会自动生成该部分页面的内容块。
|`simple_list` | 如果为 true，Hugo 使用一个简单列表列出该部分页面的自动生成内容。 |`simple_list` | 如果为 true，Hugo 使用一个简单列表列出该部分页面的自动生成内容。
|`list_below` | 如果为 true，Hugo 会将自动生成的内容追加到手动编写的内容后面。 |`list_below` | 如果为 true，Hugo 会将自动生成的内容追加到手动编写的内容后面。
|`list_by_publishdate` | 如果为 true，Hugo 会按照 `publishdate` 而不是 `weight`，对自动生成的内容进行排序。 |`list_by_publishdate` | 如果为 true，Hugo 会按照 `publishdate` 而不是 `weight`，对自动生成的内容进行排序。
类似的，某些文章头字段仅适用于博客文章。下表列举了这些字段： 类似的，某些文章头部字段仅适用于博客文章。下表列举了这些字段：
|字段 | 描述 |字段 | 描述
|-----------------|------------ |-----------------|------------
@ -115,4 +114,4 @@ Hugo 支持非常多的文章头字段，而此页面仅列举了在 istio.io
|`last_update` | 最近一次进行重大修改的日期 |`last_update` | 最近一次进行重大修改的日期
|`attribution` | 可选的，作者的姓名 |`attribution` | 可选的，作者的姓名
|`twitter` | 可选的，作者的 Twitter |`twitter` | 可选的，作者的 Twitter
|`target_release` | 此博客内容中所使用的 Istio 版本。通常，该值是在创作或更新该博客时，当时最新的主要 Istio 版本。 |`target_release` | 此博客内容中所使用的 Istio 版本。通常，该值是在创作或更新该博客时，当时最新的主要 Istio 版本。