学习 Docbook 创作一个标准化的文档

http://xiaowang.net/doc/docbook/index.html

界面:

学习 Docbook

	下一页

---

学习 Docbook

创作一个标准化的文档

Wei Wang

xiaowang.net

<wangwei0609atgmail.com>

---

---

		下一页
		第1章My first chapter

转自:http://xiaowang.net/blog/archives/18

---

Docbook简介

转自:http://blog.csdn.net/mickeyrat/archive/2005/02/04/281050.aspx

Docbook是一些标准和工具的集合。标准包括XML、DTD、XSL、XSL-FO和Docbook DTD（Docbook的核心），工具则包括XSLT Processor和XSL-FO Processor。这些标准和工具组成基于Docbook的发布系统。

Docbook原本是为了编写和发布技术文档而开发的，O'Reily是发起者之一，但实际上它也可以用于其他类型的文档，因为它所定义的结构符合大部分现代书籍的格式。

Docbook的核心是Docbook DTD，这个标准是由OASIS的Docbook小组维护的。这个标准对文档的结构进行了详细的定义，譬如书（book元素）可以包含一个标题（title），若干的段落（para）和若干的章节（chapter），等等。这些都符合常规书籍的出版格式。

使用Docbook编写文档，实际上就是根据Docbook DTD编辑XML文件的过程。所有的内容都用标签封装起来，Docbook提供了十分详尽的定义，几乎任何内容都可以根据其用途找到对应的标签。在编辑文档的过程中，作者只需要关心内容，根本不会涉及到排版的问题。

要发布Docbook文档，必须使用XSLT。专为Docbook使用的XSLT不属于Docbook的核心，任何人都可以编写自己的XSLT。当然，你不用真的自己写（除非你有兴趣），已经有人做了这方面的工作，你可以在SourceForge找到Norman Walsh开发的Docbook样式单，写这篇文章的时候，最新版本是1.67.2。

如果最终发布Docbook文档，自然需要用到XSLT Processor和XSL-FO Processor这类的工具，可供选择开源工具很多，像xsltproc、Xalan、FOP和PassiveTeX等等。这些工具实际上也是与Docbook无关的。因此不用浪费时间在网上找Docbook的专门工具，只要找到按标准实现的工具，就可以用来发布Docbook文档。

总的来说，Docbook的发布流程是这样的：

1) 编写XML文档；

2) 使用XSLT Processor把XML文档转换成HTML文档，或者XSL-FO文档；

3) 使用XSL-FO Processor将XSL-FO文档转换为PDF或者PS文件。

因此，Docbook有下列优点：

1) 内容与格式分离；

2) 内容高度结构化；

3) 平台无关；

4) 发布过程可以自动化；

5) 易于版本控制；

6) 可以生成多种形式的文档。

Docbook的缺点就是非WYSIWYG，编辑的时候不如Word那么直观，直接编辑XML文件还是一件比较烦琐的事情。但是这个问题并不严重，使用专门的XML编辑器就可以让工作轻松很多，譬如Emacs就支持Docbook文档的编辑。至于效果，使用工具生成最终文档是非常快的。相对于它的优点而言，这点缺点又算的了什么呢。

参考资料：
Docbook

Docbook Publishing Model

安装配置Docbook工具

制作Docbook文档

---

相关链接:

1.比较详细的介绍:简单介绍 DocBook

2.安装配置Docbook工具

3.制作Docbook文档