編寫技術(shù)文檔，我想誰都遇到過。很多人都用MS Word，不可否認(rèn)Word的功能確實(shí)非常強(qiáng)大，但是用Word有一些缺點(diǎn)無法避免：
1) 寫文檔的時(shí)候，不得不兼顧文檔的格式，這是件很頭痛的事情，至少對我來說。經(jīng)常是最后不得不Review好幾遍，就是為了統(tǒng)一格式，即使使用模板也不能避免這個(gè)問題。
2) 無法進(jìn)行有效的版本控制，因?yàn)閃ord保存的是二進(jìn)制格式，這就不能使用CVS的版本控制功能，只能手工合并，這樣很容易出錯(cuò)。雖然Word現(xiàn)在也可以保存成XML，但是看一下保存的文件就會發(fā)現(xiàn)，格式和內(nèi)容混雜在一起，簡直沒法看。況且，版本控制的時(shí)候，我們注重的往往是內(nèi)容，現(xiàn)在卻不得不處理大量的格式信息，至少我沒興趣把時(shí)間花在這個(gè)上面。
3) 可移植性問題，畢竟Word只能運(yùn)行在Windows平臺上，即使可以保存為XML或者HTML，在其他平臺上你又如何編輯和打印呢？
4) 用盜版還是正版的問題，公司不得不考慮知識產(chǎn)權(quán)這個(gè)比較嚴(yán)肅的話題。
講到這里，很多人可能會自然而然的想到XML+XSLT+開源代碼。Docbook正是基于XSLT把內(nèi)容和形式分開的思想開發(fā)的，它可以解決上述的所有問題。
那么到底什么是Docbook？
Docbook是一些標(biāo)準(zhǔn)和工具的集合。標(biāo)準(zhǔn)包括XML、DTD、XSL、XSL-FO和Docbook DTD（Docbook的核心），工具則包括XSLT Processor和XSL-FO Processor。這些標(biāo)準(zhǔn)和工具組成基于Docbook的發(fā)布系統(tǒng)。
Docbook原本是為了編寫和發(fā)布技術(shù)文檔而開發(fā)的，O'Reily是發(fā)起者之一，但實(shí)際上它也可以用于其他類型的文檔，因?yàn)樗x的結(jié)構(gòu)符合大部分現(xiàn)代書籍的格式。
Docbook的核心是Docbook DTD，這個(gè)標(biāo)準(zhǔn)是由OASIS的Docbook小組維護(hù)的。這個(gè)標(biāo)準(zhǔn)對文檔的結(jié)構(gòu)進(jìn)行了詳細(xì)的定義，譬如書（book元素）可以包含一個(gè)標(biāo)題（title），若干的段落（para）和若干的章節(jié)（chapter），等等。這些都符合常規(guī)書籍的出版格式。
使用Docbook編寫文檔，實(shí)際上就是根據(jù)Docbook DTD編輯XML文件的過程。所有的內(nèi)容都用標(biāo)簽封裝起來，Docbook提供了十分詳盡的定義，幾乎任何內(nèi)容都可以根據(jù)其用途找到對應(yīng)的標(biāo)簽。在編輯文檔的過程中，作者只需要關(guān)心內(nèi)容，根本不會涉及到排版的問題。
要發(fā)布Docbook文檔，必須使用XSLT。專為Docbook使用的XSLT不屬于Docbook的核心，任何人都可以編寫自己的XSLT。當(dāng)然，你不用真的自己寫（除非你有興趣），已經(jīng)有人做了這方面的工作，你可以在SourceForge找到Norman Walsh開發(fā)的Docbook樣式單，寫這篇文章的時(shí)候，最新版本是1.67.2。
如果最終發(fā)布Docbook文檔，自然需要用到XSLT Processor和XSL-FO Processor這類的工具，可供選擇開源工具很多，像xsltproc、Xalan、FOP和PassiveTeX等等。這些工具實(shí)際上也是與Docbook無關(guān)的。因此不用浪費(fèi)時(shí)間在網(wǎng)上找Docbook的專門工具，只要找到按標(biāo)準(zhǔn)實(shí)現(xiàn)的工具，就可以用來發(fā)布Docbook文檔。
總的來說，Docbook的發(fā)布流程是這樣的：
1) 編寫XML文檔；
2) 使用XSLT Processor把XML文檔轉(zhuǎn)換成HTML文檔，或者XSL-FO文檔；
3) 使用XSL-FO Processor將XSL-FO文檔轉(zhuǎn)換為PDF或者PS文件。
因此，Docbook有下列優(yōu)點(diǎn)：
1) 內(nèi)容與格式分離；
2) 內(nèi)容高度結(jié)構(gòu)化；
3) 平臺無關(guān)；
4) 發(fā)布過程可以自動(dòng)化；
5) 易于版本控制；
6) 可以生成多種形式的文檔。
Docbook的缺點(diǎn)就是非WYSIWYG，編輯的時(shí)候不如Word那么直觀，直接編輯XML文件還是一件比較煩瑣的事情。但是這個(gè)問題并不嚴(yán)重，使用專門的XML編輯器就可以讓工作輕松很多，譬如Emacs就支持Docbook文檔的編輯。至于效果，使用工具生成最終文檔是非常快的。相對于它的優(yōu)點(diǎn)而言，這點(diǎn)缺點(diǎn)又算的了什么呢。
參考資料：
Docbook
Docbook Publishing Model
安裝配置Docbook工具
制作Docbook文檔