当你的文档变得很大时,你可以把它分割成子文档,以便更容易编辑。
= 我的书 include::chapter01.adoc[] include::chapter02.adoc[] include::chapter03.adoc[]
Tip
|
注意include指令前后的空行。无论何时包含AsciiDoc内容时,都推荐这种做法,以避免出现意外结果(例如,一个章节标题被解释为前一段落的末行)。 |
使用leveloffset操作标题级别
leveloffset` 属性可以在这里提供帮助,通过将包含文档中的所有标题按指定的数量级别向下推。这使您可以发布每一章作为一个独立的文档(包含一个文档标题),但仍然能够将章节包含到一个主文档中(该主文档有它自己的文档标题)。
你可以轻松地组装你的书籍,使得章节文档标题成为一级标题,使用以下方法:
= 我的书 include::chapter01.adoc[leveloffset=+1] include::chapter02.adoc[leveloffset=+1] include::chapter03.adoc[leveloffset=+1]
因为leveloffset是_相对的_(它以+或-开始),即使被包含的文档有其自己的包含内容和leveloffsets,这也是可行的。
如果您有很多章节需要包括,并且希望它们都有相同的偏移量,您可以通过在包含内容周围设置`leveloffset`来节省一些输入工作:
= 我的书 :leveloffset: +1 include::chapter01.adoc[] include::chapter02.adoc[] include::chapter03.adoc[] :leveloffset: -1
最后一行将级别偏移量返回到0。
或者,你可以使用绝对水平:
:leveloffset: 1 //includes :leveloffset: 0
相对级别是首选。当你有嵌套包含时,绝对级别会变得不方便,因为它们不具备上下文意识。