为内容建立结构

让目录、分区索引、页面包与权重共同构成可预期的阅读与导航顺序。

2 为内容建立结构

让目录、分区索引、页面包与权重共同构成可预期的阅读与导航顺序。

对普通站点而言，OINK 不会另外维护一份导航数据库。内容树就是侧栏树，同一个顺序还会驱动翻页器与 Book 目录。读者不应该对“下一页是什么”得到三个不同答案。

从读者的问题出发

一级分区应使用读者能辨认的任务或主题命名。小型工程站点通常需要上手指南、参考文档、运维指南与变更记录。只有当一个目录能为若干页面提供有意义的共享上下文时，才应创建它。

继续使用第 1 章的 Starter，保留已有示例。本章在现有 Docs 分区下新增一篇英文页面及其中文译文。法语可以保持启用；本练习只添加下面两种语言的对页。

搭建内容树

本练习涉及的文件；其它 Starter 文件保持不变

content/
- docs/
  - _index.md已有分区根页
  - _index.zh.md已有中文根页
  - preview-check.md新增页面
  - preview-check.zh.md新增译文

按下面的完整内容创建两个文件。分区根页已经存在，不要替换它们。

---
title: Verify a local preview
description: Check that a documentation edit reaches the browser.
weight: 25
---

## Check the preview {#check-preview}

Open this page locally, change this sentence, and confirm the browser updates.

---
title: 验证本地预览
description: 确认文档修改已经显示在浏览器中。
weight: 25
---

## 检查预览 {#check-preview}

在本地打开本页，修改这句话，再确认浏览器已显示新内容。

译文以 .zh.md 后缀放在英文源文件旁边。这两页没有图片或下载资源，使用独立 Markdown 文件即可；页面拥有这些资源时，再使用页面包。

明确写出顺序

现有栏目权重之间留有空档。新页面使用 25，可以插入相邻栏目之间，而不必重新编号；两种译文保持相同权重。新建内容树时，以 10 为间隔也能留下类似空间：

项目	权重	为什么放在这里
快速上手	10	建立可运行的基线
创作内容	20	在可运行站点上继续搭建
定制站点	30	在结构之后改变呈现
运行维护	40	验证并发布结果

表 2-1 同一个显式顺序被导航、翻页与生成目录共同使用。

建立稳定地址

任何可能被其它页面引用的标题，都要显式写出 ID。英文页面与中文页面虽然显示不同的标题，却使用同一个 ID。这会让链接、页内目录与整书打印在两种语言中始终对齐。

保持 hugo server 运行，打开 /docs/preview-check/ 与 /zh/docs/preview-check/。两页都应出现在各自的 Docs 侧栏中，语言切换应打开对应译文；两页标题的锚点均为 #check-preview。保留这两个文件，第 3 章继续修改它们。

完整规则见编写页面与组织内容。