前言

页眉是每个文件顶部三条破折号之间的 YAML 代码，它提供了对我们内容的重要管理选项。例如，页眉允许我们确保现有链接在页面被移动或完全删除后仍然有效。本页解释了目前 Istio 中页眉可用的功能。

以下示例显示了一个页眉，其中所有必填字段都用占位符填充

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

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

必需的前言字段

下表显示了所有 **必填** 字段的描述

重命名、移动或删除页面

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

在 **目标页面** 上，即您希望用户到达的页面，将 **原始页面** 的 <path> 添加到页眉中，如下所示

aliases:
    - <path>

例如，您过去可以在 /help/faq 下找到我们的常见问题解答页面。为了帮助我们的用户找到常见问题解答页面，我们将页面向上移动了一级到 /faq/，并将页眉更改如下

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

上面的更改允许任何用户在访问 https://istio.ac.cn/faq/ 或 https://istio.ac.cn/help/faq/ 时访问常见问题解答。

支持多个重定向，例如

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

可选的前言字段

然而，Hugo 支持许多页眉字段，本页只涵盖了 istio.io 上实现的那些字段。

下表显示了最常用的 **可选** 字段

某些页眉字段控制自动生成的目录（ToC）。下表显示了这些字段，并解释了如何使用它们

某些页眉字段仅适用于所谓的 **捆绑页面**。您可以识别捆绑页面，因为它们的文件名以下划线 _ 开头，例如 _index.md。在 Istio 中，我们使用捆绑页面作为我们的部分着陆页。下表显示了与捆绑页面相关的页眉字段。

类似地，某些页眉字段专门适用于博客文章。下表显示了这些字段