结构元素

DocBook 中的一些元素,在发布的时候会作为条目被收进目录。它们表示的是文档内部的结构,所以它们是结构元素,如下:

  1. <set>
  2. <book>
  3. <part>
  4. <chapter>
  5. <sect1>
  6. <sect2>
  7. …………
  8. </sect2>
  9. </sect1>
  10. </chapter>
  11. </part>
  12. </book>
  13. </set>

如果 DocBook 的根元素是article,那么可以允许这种结构:

  1. <article>
  2. <sect1>
  3. <sect2>
  4. …………
  5. </sect2>
  6. </sect1>
  7. </article>
  • 结构元素可以拥有标题,titletitleabbrevsubtitle任选一个,还可以拥有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级,那样的文章估计也没法读