第一部:问题世界

本部说明为什么同一本长书需要 part。part intro 为该部提供进入正文之前的过渡说明。

1. 长书的问题世界

长书仍然只有一个书名、一个入口和一个连续的阅读产物。第一部、第二部只是同一本书内部的大分部。

当读者需要一次性阅读整本书时,part 比拆成多本 book 更合适。

2. part 的边界

part 不拥有独立 book.adoc。它由同一本 book.adoc 中的 level 0 标题声明。

part 下的 chapter 仍属于同一本书。

第二部:书籍规约

本部说明 part 对 book.adoc 的结构要求。part、chapter 和后置章节共同组成同一本 book。

3. book.adoc 的职责

book.adoc 声明整本书的标题、属性、part 顺序和后置章节。

同一本长书内部的 part 不应复制根级依赖或构建脚本。

4. 分部结构的验证

验证长书分部时,重点检查 book.adoc 中是否存在多个 level 0 part,以及每个 part 下是否有 chapter。

分卷发布可以参考样本 05-upper-volume06-lower-volume 的目录组织。

Appendix A: 附录 A:part 速查

  • = 第一部:同一本 book 内部的 part。

  • [partintro]:part 开头的说明块。

  • == 章标题:part 下的 chapter。

参考资料