能够编写文档，然后以多种不同的输出格式创建它，这曾是许多开发团队多年来的梦想。通过 DocBook XML 就可以实现，它不仅保持了语义标记，也保持了对资料格式化与输出的控制。
控制语义可以指定组成文档的章节和段落。在段落中可进一步详细规定包含的项。比方说可以将命令和函数名放在单独的标签中，如清单 8 所示。
清单 8. 使用单独的标签包装命令和函数                                       
                <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 标准（或它的一个子集）。                                                    

评论 (0) All

登陆 还没注册？