安装 Jade

1. 阅读上面列出的 URL 处的安装说明。

2. 把发行包解压到一个合适的位置。使用的命令 大致是

   unzip -aU jade1_1.zip
   

3. Jade 不是用 GNU Autoconf 构建的，所以你需要自己编辑 Makefile。既然 James Clark 已经 为此准备好了他的套件，一个好办法是在 Jade 发行包的主目录下建一个 构建目录（也许以你的机器架构命名），把主目录中的 Makefile 文件复制进去，在那里编辑它， 然后在那里运行 make。

   不过，Makefile 确实需要 编辑。主目录中有一个名为 Makefile.jade 的 文件，构建 Jade （而不是构建 Jade 所基于的 SGML 解析器套件 SP）时， 可以用 make -f Makefile.jade 来使用它。不过我们建议 你不要那样做，因为需要修改的内容 超出了 Makefile.jade 的范围，反正 你也得编辑其中某一个。

   通读 Makefile，阅读 James 的 说明并按需编辑。有若干变量 需要设置。下面收集汇总了最重要的 一些变量及其典型值：

   prefix = /usr/local
   XDEFINES = -DSGML_CATALOG_FILES_DEFAULT=\"/usr/local/share/sgml/catalog\"
   XLIBS = -lm
   RANLIB = ranlib
   srcdir = ..
   XLIBDIRS = grove spgrove style
   XPROGDIRS = jade
   

   注意其中指定了查找 SGML 支持文件默认 catalog 的位置 —— 你可能想把它改成更适合你自己 安装的值。如果你的系统不需要上面这些数学库和 ranlib 命令的设置，就让它们保持 Makefile 中的原样。

4. 输入 make 构建 Jade 和各种 SP 工具。

5. 软件构建完成后，make install 会 完成显而易见的那一步。

安装 DocBook DTD 工具包

1. 你会想把构成 DocBook DTD 工具包的文件放在 你构建 Jade 时让它查找的 目录中；如果你遵循了上面的建议，那就是 /usr/local/share/sgml/。除了 DocBook 实际文件外，你还需要放好一个 catalog 文件，用于把 文档类型规范和外部实体引用映射到该目录中的实际 文件。你还需要 ISO 字符集映射，可能还有一或多个版本的 HTML。

   安装各种 DTD 和 支持文件并建立 catalog 文件的一种 办法是，把它们全部收进上面提到的目录，用一个名为 CATALOG 的文件描述它们全部，然后 创建文件 catalog 作为指向前者的 catalog 指针，给它这样一行内容：

   CATALOG /usr/local/share/sgml/CATALOG
   

2. CATALOG 文件随后应包含三类 行。第一类是（可选的）SGML 声明，即：

   SGMLDECL docbook.dcl
   

   接下来，对 DTD 和实体文件的各项 引用必须解析。对于 DocBook 文件，这些行看起来像这样：

   PUBLIC "-//Davenport//DTD DocBook V3.0//EN" docbook.dtd
   PUBLIC "-//USA-DOD//DTD Table Model 951010//EN" cals-tbl.dtd
   PUBLIC "-//Davenport//ELEMENTS DocBook Information Pool V3.0//EN" dbpool.mod
   PUBLIC "-//Davenport//ELEMENTS DocBook Document Hierarchy V3.0//EN" dbhier.mod
   PUBLIC "-//Davenport//ENTITIES DocBook Additional General Entities V3.0//EN" dbgenent.mod
   

3. 当然，包含这些内容的文件随 DocBook 工具包一起提供。注意 这些行每行的最后一项都是文件名，这里没有带路径。 你当然可以把文件放在主 SGML 目录的子目录中，并修改 CATALOG 文件中的引用。 DocBook 还引用 ISO 字符集实体，所以你需要获取 并安装它们（它们可从多个来源获得，通过上面列出的 URL 很容易找到），并为它们全部配上 catalog 条目，例如：

   PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN" ISO/ISOlat1
   

   注意这里的文件名包含目录名，表明 我们把 ISO 实体文件放在了名为 ISO 的子目录中。同样，你获取的 实体包应附带正确的 catalog 条目。

安装 Norman Walsh 的 DSSSL 样式表

1. 阅读上面列出的 URL 处的安装说明。

2. 要安装 Norman 的样式表，只需把发行包 解压到合适的位置。一个合适的位置是 /usr/local/share，这会把工具包放到 /usr/local/share/docbook 目录树 下。命令大致是

   unzip -aU db107.zip
   

3. 测试安装的一种办法是构建 PostgreSQL 手册的 HTML 和 RTF 形式。

   1. 要构建 HTML 文件， 进入 SGML 源 目录 doc/src/sgml，执行

      jade -t sgml -d /usr/local/share/docbook/html/docbook.dsl -D ../graphics postgres.sgml
      

      book1.htm 是输出的顶层节点。。

   2. 要生成可导入你喜欢的字处理系统并打印的 RTF 输出，输入：

      jade -t rtf -d /usr/local/share/docbook/print/docbook.dsl -D ../graphics postgres.sgml
      

安装 PSGML

1. 阅读上面列出的 URL 处的安装说明。

2. 解开发行文件，运行 configure、make 和 make install，把字节编译文件和 info 库放到位置。

3. 然后把以下几行加入你的 /usr/local/share/emacs/site-lisp/site-start.el 文件，让 Emacs 在需要时正确 载入 PSGML：

   (setq load-path
         (cons "/usr/local/share/emacs/site-lisp/psgml" load-path))
   (autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t)
   

4. 如果你想在编辑 HTML 时也使用 PSGML，还要加上：

   (setq auto-mode-alist
         (cons '("\\.s?html?\\'" . sgml-mode) auto-mode-alist))
   

5. 使用 PSGML 有一点需要注意： 它的作者假定你的主 SGML DTD 目录是 /usr/local/lib/sgml。如果像本章示例 中那样使用 /usr/local/share/sgml，你 就必须对此作出补偿。

   1. 你可以设置 SGML_CATALOG_FILES 环境变量。

   2. 你可以 定制你的 PSGML 安装（它的 手册说明了方法）。

   3. 你甚至可以在编译和安装 PSGML 之前编辑源文件 psgml.el，把硬编码的路径改成 你自己的默认值。