许多重要的开源项目都在逐渐采用 DocBook 作为其文档的标准格式——这些项目包括 Linux 内核、GNOME、KDE、Samba 和 Linux 文档项目。 基于 XML 的“结构化标记”(与 troff、Tex 和 Texinfo 所代表的旧式“表示标记”相对)的倡导者似乎已经赢得了理论上的胜利。 你可以从结构化标记生成表示标记,但反过来却非常困难。
然而,围绕 DocBook 及其支持程序仍然存在许多困惑。 它的拥护者们使用着一种即使以计算机科学的标准来看也晦涩难懂的行话,随意抛掷着与你编写标记并从中生成 HTML 或 Postscript 所需操作没有明显关系的缩略语。 XML 标准和技术文档以晦涩难懂而闻名。
本 HOWTO 将尝试阐明围绕 DocBook 及其在开源文档中的应用的主要谜团——包括技术和政治方面的。 我们的目标是使您不仅能够理解制作文档需要做什么,还能理解为什么这个过程如此复杂——以及随着更新的 DocBook 相关工具的出现,它将如何变化。