'''附录`部分的样式可以用在书籍和文章中,并且它可以有小节。尽管AsciiDoc结构允许将附录放置在任何位置,但通常习惯将它们放在文档的接近结尾处。'''

附录部分的语法

对于文章,附录必须被定义为一级标题(==)。例如:

Unresolved directive in appendix.adoc - include::example$appendix.adoc[tag=appx-article]

目录将如下出现:

Unresolved directive in appendix.adoc - include::example$appendix.adoc[tag=appx-article-out]

对于书籍,如果你希望附录紧随章节后,那么必须将附录定义为一级节(==)。在多部分组成的书籍中,如果你想要附录紧随其他部分后,那么必须将附录定义为零级节(=)。无论哪种情况,附录的第一个小节都必须定义为二级节(===)。

以下例子展示了如何为多部分组成的书定义一个附录。

Unresolved directive in appendix.adoc - include::example$appendix.adoc[tag=appx-book]

目录将如下出现:

Unresolved directive in appendix.adoc - include::example$appendix.adoc[tag=appx-book-out]

附录标签

当渲染时,标记为`appendix`的章节标题将包括:

  • 一个标签,取自`appendix-caption`属性的值,默认为“Appendix”。

  • 代表附录顺序中附录序号的字母(A、B、…​)

  • 一个冒号

  • 章节标题

例如:

附录A: 数据访问矩阵

前缀可以通过设置 appendix-caption 属性并用自定义值覆盖默认值来修改。

附录标题:展览

取消设置属性以移除前缀。

appendix-caption!: