结构元素
DocBook 中的一些元素,在发布的时候会作为条目被收进目录。它们表示的是文档内部的结构,所以它们是结构元素,如下:
<set>
<book>
<part>
<chapter>
<sect1>
<sect2>
…………
</sect2>
</sect1>
</chapter>
</part>
</book>
</set>
如果 DocBook 的根元素是article,那么可以允许这种结构:
<article>
<sect1>
<sect2>
…………
</sect2>
</sect1>
</article>
- 结构元素可以拥有标题,title、titleabbrev、subtitle任选一个,还可以拥有info
可以看出,无论是 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级,那样的文章估计也没法读