2. 书写DocBook格式的xml文件

只要对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文档的结构。文档中只有如下几种标签:

  1. 书 book

    这可能是DocBook文档中最常见的文档起点。也是我们用得最多,但也是输入次数很少的标签。“一本书”只需输入两次,一头一尾:<book> </book>。

  2. 章 chapter

    book的子节点之一,“章”的根节点。与chapter节点同级的还有preface(序言)和appendix(附录)。

  3. 节 sect*

    sect1是“小节”的根节点,“小节”一共有5个级别,一级套一级,1套2,2套3...... sect1、sect2、sect3、sect4和sect5。如果不喜欢这5个标签,也可以使用section标签递归嵌套。

  4. 段落

    para就是paragraph的缩写。应该是用得最多的标签了吧。

  5. 标题

    title是在文档中应用非常广泛的标签,不仅是book,chapter,sect*等,在后面还会用到的表格、插图等都可以有一个标题。

如果没有什么特别的要求,这样一份单纯文字性的“书”就算准备好了。接下来,我们就可以将这个文件转换为我们需要的格式。