只要对DocBook的标签有少许的了解,就可以开始书写基于DocBook规范的文档,前面已经列举了两个例子。
我们就用下面这份简单的例子作为第一份DocBook文档,把这份文档命名为firstbook.xml
1 <book><title>docbook简要参考⼿册</title> 2 <subtitle>DocBook 5.0 and XSLT 1.0 Stylesheet</subtitle> 3 4 <chapter><title>制作第⼀份docbook⽂档</title> 5 <para>前面已经提到过,docbook主要分为SGML和XML两个版本,不论哪个版本,都称为DocbookDTD... ...</para> 6 <para>docbook的入门是有一定门槛的,需要很多方面的配合,才能产出一份不错的文档。... ...</para> 7 <sect1><title>基础环境搭建</title> 8 <para>... ...</para> 9 </sect1> 10 11 <sect1><title>书写DocBook格式的xml⽂件</title> 12 <para>... ...</para> 13 </sect1> 14 15 <sect1><title>生成我们需要的文件</title> 16 <para>... ...</para> 17 </sect1> 18 19 </chapter> 20 21 <chapter><title>制作更完整的DocBook文档</title> 22 <para>... ...</para> 23 </chapter> 24 25 </book>
上面这段并不长的代码足以让我们演示DocBook文档的结构。文档中只有如下几种标签:
这可能是DocBook文档中最常见的文档起点。也是我们用得最多,但也是输入次数很少的标签。“一本书”只需输入两次,一头一尾:<book> </book>。
book的子节点之一,“章”的根节点。与chapter节点同级的还有preface(序言)和appendix(附录)。
sect1是“小节”的根节点,“小节”一共有5个级别,一级套一级,1套2,2套3...... sect1、sect2、sect3、sect4和sect5。如果不喜欢这5个标签,也可以使用section标签递归嵌套。
para就是paragraph的缩写。应该是用得最多的标签了吧。
title是在文档中应用非常广泛的标签,不仅是book,chapter,sect*等,在后面还会用到的表格、插图等都可以有一个标题。
如果没有什么特别的要求,这样一份单纯文字性的“书”就算准备好了。接下来,我们就可以将这个文件转换为我们需要的格式。