当你的文档变得很大时,你可以把它分割成子文档,以便更容易编辑。

= 我的书

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

相对级别是首选。当你有嵌套包含时,绝对级别会变得不方便,因为它们不具备上下文意识。