安装 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 db119.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，把硬编码的路径改成你自己的默认值。