第一部:问题世界
本部说明为什么同一本长书需要 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-volume 和 06-lower-volume 的目录组织。
Appendix A: 附录 A:part 速查
-
= 第一部:同一本 book 内部的 part。 -
[partintro]:part 开头的说明块。 -
== 章标题:part 下的 chapter。
参考资料
-
[asciidoctor-parts] Asciidoctor Docs, Book Parts, https://docs.asciidoctor.org/asciidoc/latest/sections/parts/