文章头部

文章头部（front matter）是每个文件顶部用三点划线包裹的 YAML 代码，它为我们的内容提供了重要的管理选项。例如：文章头部允许我们确保现有链接对于已经完全移动或删除的页面继续有效。本页说明了 Istio 中文章头部目前可用的功能。

下面是一个文章头部的示例，其中所有必填字段都由占位符填充：

---
title: <title>
description: <description>
weight: <weight>
keywords: [<keyword1>,<keyword2>,...]
aliases:
    - <previously-published-at-this-URL>
---

您可以复制上面的示例，并在您的页面中使用相应值替换所有占位符。

必填字段

下表列举了所有的 必填 字段及其说明：

重命名、移动或删除页面

当您移动或完全删除页面时，必须确保指向这些页面的现有链接继续有效。文章头部中的 aliases 字段可帮助您满足此要求。在移动或删除页面之前，将现有路径添加到 aliases 字段中。Hugo 为我们的用户实现了从旧 URL 到新 URL 的自动重定向。

在 target page （您想让用户访问的页面）上，将 original page 的 <path> 添加到文章头部中，如下所示：

aliases:
    - <path>

例如，您可以在以前的 /zh/help/faq 下找到我们的 FAQ 页面。为了使用户更方便的找到 FAQ 页面，我们将该页面上移了一个级别至 /zh/faq/，并对文章头部做了以下更改：

---
title: Frequently Asked Questions
description: Questions Asked Frequently.
weight: 13
aliases:
    - /zh/help/faq
---

上面的更改允许所有用户通过 https://istio.io/zh/faq/ 或者 https://istio.io/zh/help/faq/ 都能访问到 FAQ 页面。

不仅是一个，该字段支持多个重定向，例如：

---
title: Frequently Asked Questions
description: Questions Asked Frequently.
weight: 13
aliases:
    - /zh/faq
    - /zh/faq2
    - /zh/faq3
---

可选字段

Hugo 支持非常多的文章头部字段，而此页面仅列举了在 istio.io 中实现的字段。

下表列举了最常用的 可选 字段：

一些文章头部字段可用于控制自动生成的目录（ToC）。下表列举了这些字段并说明了如何使用：

某些文章头部字段仅适用于所谓的 bundle page 。您可以辨别 bundle page ，因为它们的文件名都是以下划线 _ 开头，例如： _index.md。在 Istio 中，我们使用 bundle page 作为我们的部分着陆页面。下表列举了与 bundle page 相关的文章头部字段。

类似的，某些文章头部字段仅适用于博客文章。下表列举了这些字段：