2. Why ?

DocBook可以说是专为技术类文档而生的。技术类的文档相比文学书籍来说,具有更多的“文档元素”、在版式等方面也有更多的要求。DocBook在这些方面给出了一个比较完美的解决方案。

  1. DocBook具有非常丰富的“文档元素”或者说是“标签”,在DocBook 5.0中,根据其官方文档显示,有385个,例如有关于文档组织方面的preface 、chapter 、section等;关于文档出版信息方面的author、copyright、date、legalnotice、revision、adress等;关于文档标注方面的footnote、superscript、tip、important、caution等。这些丰富的元素足以让我们轻松地组织、书写和发布我们的文档。
  2. 文档内容与样式分离,文档作者的精力和能力其实是集中在内容方面的,文档的写作者只需要关注文档的内容,相应的表现样式已经都提前定义好。
  3. 单一的源文件,DocBook是定义了一套XML的标签规范,所有的以DocBook规范书写的文档都被保存为纯文本的XML文件。在发布时可以根据需求发布为不同的格式,如PDF或者是HTML。并且因为是结构良好的XML文本文件,也有利于对文档的各种重新组织和复用。
  4. 多人协作,有时候多人写作一本书,当所有的章节汇聚在一起时,往往要花费大量的精力来进行重新的编制目录、插图目录、表格目录等,不但耗时而且容易出错。DocBook规范的XML文件在这方面具有很大优势,所有的编目均可自动生成,不但大方美观,而且效率高、不容易出错。
  5. 版本控制,以DocBook规范书写的源文件是XML格式的文本文件,很容易使用SVN或git等版本控制工具将其放入版本库中,对各个时间段或时期的文档进行版本管理。