1. 简介

1.1. 关于本文档的信息

本文 mini-HOWTO 的最新版本可以在以下网址找到:

http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/

有关本文档的版权、许可和免责声明信息,请参阅附录中的“法律”部分。

1.2. 什么是 DocBook

DocBook 是一种标准通用标记语言 (SGML) 文档类型定义 (DTD),它定义了一组文本文档标记标签,其工作方式与 Web 上常用的 HTML 语言非常相似。

DocBook 旨在用于编写书籍和文章。因此,它提供了专门用于描述书籍和文章的标签。例如,<book><article>DocBook 标签用于创建书籍和文章。在这些文档中,<chapter>, <sect1><para>标签被使用。DocBook SGML 文件以文本文件形式存储,后缀名为sgmlgml后缀。

处理后,单个 DocBook SGML 文件可以输出html, pdf, ps, txt以及其他格式,用于在线和印刷出版。处理过程由样式表控制,样式表可以自动生成目录、页码、章节编号和其他功能。

DocBook 也被设计用于通过编写 man 页面来创作 unix 文档。<refentry>文档。如果您不知道什么是 man 页面,请在终端上尝试命令 man man

1.3. 简要概述

以下是我们在接下来章节中将要使用的软件包的简要描述

OpenJade. OpenJade 是 ISO/IEC 10179:1996 国际标准文档样式语义和规范语言 (DSSSL) 的一个实现。OpenJade 执行 DSSSL 语言来处理 SGML 和 XML 输入文件。特别是,它使用模块化 DocBook 样式表 dsl 代码将 DocBook SGML/XML 文件处理成其他格式,例如html, tex, rtf, txt等等。OpenJade 是将 DocBook 文件转换为其他格式的关键引擎。TeX 输出格式主要用作获取以下格式的中间格式dvi, pdfps通过 TeX 宏和 dvi 转换器。

DocBook SGML DTD. DocBook 文档类型定义 (DTD) 文件是定义 DocBook 语言的 SGML 文件。它定义了有效的标签集及其使用规则。OpenJade 需要访问 DTD 文件才能解析每种文档类型。

ISO8879 ENTITY SGML. 实体定义了如何表示在 SGML 中没有键盘按键或具有特殊含义的特殊字符。HTML 中常见的示例包括 "&amp;"='&'、"&gt;"='>' 和 "&lt;"='<'。

DocBook DSSSL(模块化 DocBook 样式表). 特定 DTD(在本例中为 DocBook)的 DSSSL 文件(dsl 后缀)指定如何将 DocBook 转换为 html、rtf、tex 等。dsl 文件与您的 DocBook sgml 文件一起输入到 openjade,并告知 openjade 如何将您的文档转换/样式化为另一种文件格式。在线(html)格式的 dsl 通常与打印(dvi, pdf, ps)格式的 dsl 不同。

SGMLtools-Lite. SGMLtools-Lite 是一个前端包装器,用于运行 openjadeTeXjadetexpdfjadetex,这些宏包含在 OpenJade 中。将 DocBook 文件转换为pspdf是一个两步或三步过程。OpenJade 输出一个tex文件,该文件是 jadetex 的输入,用于生成一个dvi文件,而 pdfjadetex 用于生成一个pdfps文件是通过传递dvi文件通过 dvips 获得的。sgmltools 脚本提供了一个命令来执行这些任务。

HTMLdoc. HTMLdoc 是一个免费程序,用于将 html 文件转换为pdfps文件。

SGMLSpm 和 docbook2X. 这两者一起用于生成 man 页面。SGMLSpm 是一个 perl5 模块库,用于处理来自以下程序的解析输出onsgmls,一个包含在 OpenJade 中的程序。SGMLSpm 包含一个名为sgmlspl的应用程序,用于使用 SGMLSpm 库。Sgmlspl需要“spec files”,这些文件可以从互联网上的各种其他来源获得,用于执行每种类型的文档转换。DocBook2X 是一个软件包,它提供了将 DocBook 文件转换为 man 页面的 spec files。