「編寫一次,就能以多種不同格式輸出」一直是許多開發團隊多年來的夢想。透過 DocBook XML 就能實現,它不僅保留了語義標記,也保留了對資料格式化與輸出的控制。
所謂控制語義,是指可以指定組成文檔的章節與段落,並在段落中進一步規定包含的項。比如可以把命令與函數名放進專門的標籤:
<para>The <command>compile</command> takes the source code of the material and builds a new class based on the filename. For example, if the filename is <filename>HelloWorld</filename> then the name of the class generated will be <classname>HelloWorld</classname>.
顯示不同元素時,可以選擇相同或不同的輸出樣式。更重要的是,由於語義信息會被保留(例如文檔可能包含對類名的引用),生成索引時就能用它自動列出文檔中詳細描述的所有類名。
除了語義標記,文檔的章節與各個部分還可用特殊的 ID 標記,用這些 ID 建立文檔不同部分的鏈接。有些類型(章節、部分等)可自動完成,其他則需明確建立鏈接。轉換成目標格式時,這些鏈接會自動轉為合適的形式:轉 HTML 時變成頁面或錨點鏈接,生成 PDF 時則可包含目標章節的頁碼。
這種轉換由 XSLT 樣式表完成。標準的 DocBook XSLT 樣式表支持轉換到 HTML、XHTML、PDF(透過 FO 標準)、Texinfo、Java Help 與 Man 頁面等多種格式,還能把數據轉成不同大小與風格——書籍、A4 頁面、幻燈片等。
各種輸出格式與標記的靈活性意味著:建立文檔時,同一份源代碼就能同時提供印刷手冊、內嵌幫助、man 頁面,以及在線與上下文感知的信息,而無需像傳統模式那樣分別編寫。正因如此,DocBook XML 在技術文檔社區獲得了廣泛認可,許多公司全部文檔都採用 DocBook XML 標準(或其子集)。