文章头部
下面是一个文章头部的示例,其中所有必填字段都由占位符填充:
您可以复制上面的示例,并在您的页面中使用相应值替换所有占位符。
下表列举了所有的 必填 字段及其说明:
在 target page (您想让用户访问的页面)上,将 original page 的 <path>
添加到文章头部中,如下所示:
例如,您可以在以前的 /zh/help/faq
下找到我们的 FAQ 页面。为了使用户更方便的找到 FAQ 页面,我们将该页面上移了一个级别至 /zh/faq/
,并对文章头部做了以下更改:
上面的更改允许所有用户通过 https://istio.io/zh/faq/
或者 都能访问到 FAQ 页面。
可选字段
Hugo 支持非常多的文章头部字段,而此页面仅列举了在 istio.io 中实现的字段。
下表列举了最常用的 可选 字段:
一些文章头部字段可用于控制自动生成的目录(ToC)。下表列举了这些字段并说明了如何使用:
类似的,某些文章头部字段仅适用于博客文章。下表列举了这些字段: