前言

本书是新增普通 book 时的复制起点。它只保留日常写作最常见的结构:前言、章节、附录、参考资料和本书图片。

1. 单书边界

一本普通书由自己的 book.adoc 定义边界。入口文件负责书名、属性、章节顺序、前置内容和后置内容。

日常单书结构图

2. 章节顺序

普通章节放在 chapters/ 下。book.adoc 通过 include 顺序决定阅读顺序。

新增章节时,先创建章节文件,再把 include 放到合适位置。

Appendix A: 附录 A:最小文件清单

普通新书通常需要:

  • book.adoc

  • frontmatter/preface.adoc

  • chapters/

  • backmatter/

  • assets/images/

参考资料

  • [starter-anatomy] 样本 00-book-anatomy 展示完整 book 结构位置。