内容组织
本网站使用 Hugo。在 Hugo 中，内容组织 是一个核心概念。
注意
Hugo 提示：使用hugo server --navigateToChanged 启动 Hugo 以进行内容编辑会话。页面列表
页面顺序
文档侧边菜单、文档页面浏览器等均使用 Hugo 的默认排序顺序列出，即按权重（从 1 开始）、日期（最新优先）和链接标题排序。
鉴于此，如果您想向上移动页面或部分，请在页面首页中设置权重
title: My Page
weight: 10
注意
对于页面权重，明智的做法是不要使用 1、2、3...，而是使用其他间隔，例如 10、20、30... 这允许您稍后在所需位置插入页面。此外，同一目录（部分）内的每个权重不应与其他权重重叠。这确保内容始终井井有条，尤其是在本地化内容中。文档主菜单
“文档”主菜单由 docs/ 下面的部分构建，并在 _index.md 部分内容文件的首页中设置了 main_menu 标志
main_menu: true
请注意，链接标题是从页面的 linkTitle 中获取的，因此如果您希望它与标题不同，请在内容文件中更改它
main_menu: true
title: Page Title
linkTitle: Title used in links
注意
以上操作需要针对每种语言执行。如果您在菜单中没有看到您的部分，则可能是因为 Hugo 未将其识别为部分。在部分文件夹中创建一个_index.md 内容文件。文档侧边菜单
文档侧边栏菜单是从 docs/ 下面的“当前部分树”构建的。
它将显示所有部分及其页面。
如果您不想列出某个部分或页面，请在首页中将 toc_hide 标志设置为 true
toc_hide: true
当您导航到包含内容的部分时，将显示特定部分或页面（例如 _index.md）。否则，将显示该部分内的第一个页面。
文档浏览器
文档主页上的页面浏览器是使用 docs 部分正下方的所有部分和页面构建的。
如果您不想列出某个部分或页面，请在首页中将 toc_hide 标志设置为 true
toc_hide: true
主菜单
右上角菜单（以及页脚）中的网站链接是通过页面查找构建的。这是为了确保页面确实存在。因此，如果网站（语言）中不存在 case-studies 部分，则不会链接到该部分。
页面包
除了独立的内容页面（Markdown 文件）之外，Hugo 还支持 页面包。
一个例子是 自定义 Hugo 短代码。它被认为是一个“叶包”。目录下的所有内容（包括 index.md）都将成为包的一部分。这还包括页面相对链接、可以处理的图像等。
en/docs/home/contribute/includes
├── example1.md
├── example2.md
├── index.md
└── podtemplate.json
另一个广泛使用的例子是 includes 包。它在首页中设置了 headless: true，这意味着它没有自己的 URL。它仅在其他页面中使用。
en/includes
├── default-storage-class-prereqs.md
├── index.md
├── partner-script.js
├── partner-style.css
├── task-tutorial-prereqs.md
├── user-guide-content-moved.md
└── user-guide-migration-notice.md
关于包中文件的一些重要说明
- 对于已翻译的包，任何缺少的非内容文件都将从上面的语言继承。这避免了重复。
- 包中的所有文件都是 Hugo 所谓的“资源”，您可以为每种语言提供元数据，例如参数和标题，即使它不支持首页（YAML 文件等）。请参阅 页面资源元数据。
- 您从“资源”的
.RelPermalink获取的值是页面相对的。请参阅 永久链接。
样式
本网站样式表的 SASS 源代码存储在 assets/sass 中，并由 Hugo 自动构建。
下一步
- 了解 自定义 Hugo 短代码
- 了解 风格指南
- 了解 内容指南