结构元素
优质
小牛编辑
137浏览
2023-12-01
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[“文档工程”一节
以下是常用的结构元素
元素 | 说明 |
---|---|
set | 集 |
book | 书 |
part | 部 |
chapter | 章 |
article | 文章 |
sections | 节 |
[53] section 与 sect1、sect2……sect5 的区别在于,section 可以无限嵌套,sect1 到 sect5 只能逐级嵌套
推荐使用 sect1~5,这样可以使文档的结构更加清晰,而且通常5级也够用了;如果超过5级,那样的文章估计也没法读