'''附录`部分的样式可以用在书籍和文章中,并且它可以有小节。尽管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!: