DocBook 中的一些元素,在发布的时候会作为条目被收进目录。它们表示的是文档内部的结构,所以它们是结构元素,如下:
<set> <book> <part> <chapter> <sect1> <sect2> ………… </sect2> </sect1> </chapter> </part> </book> </set>
如果 DocBook 的根元素是article,那么可以允许这种结构:
<article> <sect1> <sect2> ………… </sect2> </sect1> </article>
可以看出,无论是 Book 还是 Article,自 sect1[53]而下的结构都是相同的。
如果把sect1元素的内容放在一个单独的文件中,那么无论是 Book 还是 Article 都可以不加改动的引用这个文件,参见“文档工程”一节
以下是常用的结构元素
元素 | 说明 |
---|---|
set | 集 |
book | 书 |
part | 部 |
chapter | 章 |
article | 文章 |
sections | 节 |
[53] section 与 sect1、sect2……sect5 的区别在于,section 可以无限嵌套,sect1 到 sect5 只能逐级嵌套
推荐使用 sect1~5,这样可以使文档的结构更加清晰,而且通常5级也够用了;如果超过5级,那样的文章估计也没法读