1. 摘要
本书是 AsciiDoc book 的结构标本。它集中展示前置内容、正文分部、章节层级、附录、术语表、参考资料和索引在书稿中的位置。
本书用于学习完整结构，不作为日常新书的复制起点。
版本说明
本文档属于 AsciiDoc 多本书工作区示例。colophon 位于书籍前置区域，记录版本、来源或出版信息。
示例版本：v0.1。
献辞
献给每一位需要把书稿结构先想清楚再开始写作的人。
前言
这本标本书按结构位置组织，而不是按主题展开。阅读时先看 book.adoc，再对照各个被 include 的文件。
日常写作起点见 日常独立单书。
致谢
感谢 Asciidoctor 文档提供稳定术语和结构坐标。
第一部：前置结构
本部展示一本书进入正文之前的结构位置。摘要、版本说明、献辞、前言和致谢都属于书籍前置内容。
2. 前置内容地图
前置内容用于建立读者进入正文之前需要知道的说明、来源和阅读位置。
| 结构 | 职责 |
|---|---|
|
说明整本书覆盖什么。 |
|
记录版本、出版或来源信息。 |
|
放置献辞。 |
|
说明写作目的和阅读方式。 |
|
放置致谢。 |
第二部：正文结构
本部展示正文中的 part、chapter、section 和离散标题。part 组织同一本书内部的大分部。
3. 正文结构地图
part 是 book doctype 中的 level 0 section。chapter 是 part 下的 level 1 section，也就是 == 标题。
3.1. 小节层级
小节用于组织 chapter 内部内容。
离散标题
离散标题提供视觉分隔，但不进入书籍目录层级。
Appendix A: 附录 A：结构速查
| 写法 | 含义 |
|---|---|
|
document title。 |
|
book doctype 中的 part。 |
|
chapter。 |
|
section。 |
术语表
- book
-
具有独立
book.adoc、章节顺序和构建产物的书籍单位。 - part
-
同一本 book 内部的 level 0 大分部。
- chapter
-
book 中的主要正文单位，通常使用
==标题。 - section
-
chapter 内部的层级标题。
- appendix
-
放置补充材料的后置章节。
- glossary
-
使用定义列表解释术语的后置章节。
- bibliography
-
放置参考资料的后置章节。
- index
-
放置索引入口的后置章节。
参考资料
-
[asciidoctor-section-styles] Asciidoctor Docs, Section Styles for Articles and Books, https://docs.asciidoctor.org/asciidoc/latest/sections/styles/
-
[asciidoctor-parts] Asciidoctor Docs, Book Parts, https://docs.asciidoctor.org/asciidoc/latest/sections/parts/
索引
索引 section 位于书籍后置区域。正文中的索引词宏是索引词来源：
(((section)))
(((discrete heading)))