PostgreSQL7.0手册-附录-文档
减小字体
增大字体拥有正确的 m4 版本，键入
gnum4 --version
如果你安装 GNU m4，把它装成名为 gnum4，这样 sgmltools 将能找到它。在安装过后，你将有 sgmltools，jade 和 Norm Walsh 的 DocBook 风格表。下面的步骤是分别用于安装这些工具的。
前提
你需要的东西：
一个可用的 GCC 2.7.2
一个可用的 Emacs 19.19 或更新版本
一个用于 UNIX 的 unzip 程序, 用以解包
你需要获取的：
James Clark 的 Jade （在文件 jade1_1.zip 里的版本 1.1 是写作的时候最新的版本）
DocBook 版本 3.0
Norman Walsh 的 Modular Stylesheets （最初用于制作这些文档的是版本 1.19）
Lennart Staflin 的 PSGML （写作的时候可用的最新版本是 psgml-1.0.1.tar.gz 里的 1.0.1）
重要的 URL：
The Jade web page
The DocBook web page
The Modular Stylesheets web page
The PSGML web page
Steve Pepper's Whirlwind Guide
Robin Cover's database of SGML software
安装 Jade
安装 Jade
阅读上面 URL 列出的安装指导．
在一个合适的位置 Unzip （解压缩）发布包．做这些的命令看起来象
unzip -aU jade1_1.zip
Jade 不是用 GNU Autoconf 制作的，所以你需要自己编辑 Makefile。因为 James Clark 把他的工具做得很容易处理这些事情，所以你最好在 Jade 发布的主目录下建立一个制作目录（也许用你的机器的体系命名），把主目录的 Makefile 拷贝到这个位置，在这里编辑之，然后在该目录下运行 make。
不过，可以不编辑 Makefile．在主目录里有一个文件名为 Makefile.jade，其作用是制作 Jade（相对于只是制作 Jade 倚赖的 SGML 分析器工具 SP）时可以用 make -f Makefile.jade．不过我们建议不要这样做，因为这样你需要修改比 Makefile.jade 里更多的东西，所以不管怎样你都要编辑其中之一（译注：Makefile 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 支持文件缺省路径的声明－－你可能需要针对你自己的安装做一些改动．如果你的系统不需要上面那些关于数学库和 ranlib 命令的设置，仅仅把它们留在 Makefile 里．
键入 make 制作 Jade 和各种各样 SP 工具．
一旦完成软件的制作，make install 将完成安装．
安装 DocBook DTD 工具
安装 DocBookDTD 工具
你需要把制作 DocBookDTD 工具的文件放到你制作 Jade 的目录里，如果你按照我们上面建议的话，应该是 /usr/local/share/sgml/。除了 DocBook 文件以外，你还需要有一个就位的 catalog 文件，用于文档类型声明和该目录里实际文件的外部实体参考．你还要有 ISO字符集映射以及可能还需要一个或更多个版本的HTML．
安装多种多样的 DTD 和支持文件的一种方法是设置 catalog 文件，就是收集所有的文件到上面提到的目录里，用一个叫 CATALOG 的文件描述所有这些文件，然后创建文件 catalog 作为指向前者的目录指针 －－ 往里面输入下面一行内容：
CATALOG /usr/local/share/sgml/CATALOG
文件 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
当然，一个包含这些的文件和 DocBook工具一起发布．注意这些行的最后一项都是文件名，这里给出的没有路径．你可以把这些文件放到你的 SGML 目录的子目录里，当然还要修改 CATALOG 文件里的引用．DocBook 还引用了 ISO字符集实体，所以你还要获取和安装这些东西（它们可以通过几种不同途径获取，并且可以在上面列出的 URL 里很容易的找到），以及所有这些东西的目录实体，类似：
PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN" ISO/ISOlat1
注意这里文件名是如何包含一个目录名的，这里显示了我们把 ISO 实体文件放到了一个名为 ISO 的子目录．同样，正确的目录入口应该对应你获取的工具实体．
安装 Norman Walsh 的 DSSSL 风格表
安装 Norman Walsh 的 DSSSL 风格表
阅读上面 URL 列出的安装指导．
安装 Norman 的风格表，只需要在合适的位置简单的解压缩发布的工具．一个处理这些事情的合适的位置是 /usr/local/share，把工具放到在 /usr/local/share/docbook 目录树下的目录里．处理这些的命令看起来将象
unzip -aU db119.zip
测试安装成功与否的一个方法是制作 PostgreSQL用户手册的HTML 和 RTF 形式．
制作 HTML 文件，进入 SGML 源文件目录，doc/src/sgml，键入
jade -t sgml -d /usr/local/share/docbook/html/docbook.dsl -D ../graphics postgres.sgml
book1.htm 是输出的顶级节点。
生成 RTF 输出，为你常用的字处理系统和打印系统做准备，键入：
jade -t rtf -d /usr/local/share/docbook/print/docbook.dsl -D ../graphics postgres.sgml
安装 PSGML
安装 PSGML
阅读上面 URL 列出的安装指导．
解开发布的压缩文件，运行 configure，make 和 make install 把 byte-compiled（字节编译）文件和信息库就位．
然后往你的 /usr/local/share/emacs/site-lisp/site-start.el 文件里增加下
gnum4 --version
如果你安装 GNU m4，把它装成名为 gnum4，这样 sgmltools 将能找到它。在安装过后，你将有 sgmltools，jade 和 Norm Walsh 的 DocBook 风格表。下面的步骤是分别用于安装这些工具的。
前提
你需要的东西：
一个可用的 GCC 2.7.2
一个可用的 Emacs 19.19 或更新版本
一个用于 UNIX 的 unzip 程序, 用以解包
你需要获取的：
James Clark 的 Jade （在文件 jade1_1.zip 里的版本 1.1 是写作的时候最新的版本）
DocBook 版本 3.0
Norman Walsh 的 Modular Stylesheets （最初用于制作这些文档的是版本 1.19）
Lennart Staflin 的 PSGML （写作的时候可用的最新版本是 psgml-1.0.1.tar.gz 里的 1.0.1）
重要的 URL：
The Jade web page
The DocBook web page
The Modular Stylesheets web page
The PSGML web page
Steve Pepper's Whirlwind Guide
Robin Cover's database of SGML software
安装 Jade
安装 Jade
阅读上面 URL 列出的安装指导．
在一个合适的位置 Unzip （解压缩）发布包．做这些的命令看起来象
unzip -aU jade1_1.zip
Jade 不是用 GNU Autoconf 制作的，所以你需要自己编辑 Makefile。因为 James Clark 把他的工具做得很容易处理这些事情，所以你最好在 Jade 发布的主目录下建立一个制作目录（也许用你的机器的体系命名），把主目录的 Makefile 拷贝到这个位置，在这里编辑之，然后在该目录下运行 make。
不过，可以不编辑 Makefile．在主目录里有一个文件名为 Makefile.jade，其作用是制作 Jade（相对于只是制作 Jade 倚赖的 SGML 分析器工具 SP）时可以用 make -f Makefile.jade．不过我们建议不要这样做，因为这样你需要修改比 Makefile.jade 里更多的东西，所以不管怎样你都要编辑其中之一（译注：Makefile 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 支持文件缺省路径的声明－－你可能需要针对你自己的安装做一些改动．如果你的系统不需要上面那些关于数学库和 ranlib 命令的设置，仅仅把它们留在 Makefile 里．
键入 make 制作 Jade 和各种各样 SP 工具．
一旦完成软件的制作，make install 将完成安装．
安装 DocBook DTD 工具
安装 DocBookDTD 工具
你需要把制作 DocBookDTD 工具的文件放到你制作 Jade 的目录里，如果你按照我们上面建议的话，应该是 /usr/local/share/sgml/。除了 DocBook 文件以外，你还需要有一个就位的 catalog 文件，用于文档类型声明和该目录里实际文件的外部实体参考．你还要有 ISO字符集映射以及可能还需要一个或更多个版本的HTML．
安装多种多样的 DTD 和支持文件的一种方法是设置 catalog 文件，就是收集所有的文件到上面提到的目录里，用一个叫 CATALOG 的文件描述所有这些文件，然后创建文件 catalog 作为指向前者的目录指针 －－ 往里面输入下面一行内容：
CATALOG /usr/local/share/sgml/CATALOG
文件 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
当然，一个包含这些的文件和 DocBook工具一起发布．注意这些行的最后一项都是文件名，这里给出的没有路径．你可以把这些文件放到你的 SGML 目录的子目录里，当然还要修改 CATALOG 文件里的引用．DocBook 还引用了 ISO字符集实体，所以你还要获取和安装这些东西（它们可以通过几种不同途径获取，并且可以在上面列出的 URL 里很容易的找到），以及所有这些东西的目录实体，类似：
PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN" ISO/ISOlat1
注意这里文件名是如何包含一个目录名的，这里显示了我们把 ISO 实体文件放到了一个名为 ISO 的子目录．同样，正确的目录入口应该对应你获取的工具实体．
安装 Norman Walsh 的 DSSSL 风格表
安装 Norman Walsh 的 DSSSL 风格表
阅读上面 URL 列出的安装指导．
安装 Norman 的风格表，只需要在合适的位置简单的解压缩发布的工具．一个处理这些事情的合适的位置是 /usr/local/share，把工具放到在 /usr/local/share/docbook 目录树下的目录里．处理这些的命令看起来将象
unzip -aU db119.zip
测试安装成功与否的一个方法是制作 PostgreSQL用户手册的HTML 和 RTF 形式．
制作 HTML 文件，进入 SGML 源文件目录，doc/src/sgml，键入
jade -t sgml -d /usr/local/share/docbook/html/docbook.dsl -D ../graphics postgres.sgml
book1.htm 是输出的顶级节点。
生成 RTF 输出，为你常用的字处理系统和打印系统做准备，键入：
jade -t rtf -d /usr/local/share/docbook/print/docbook.dsl -D ../graphics postgres.sgml
安装 PSGML
安装 PSGML
阅读上面 URL 列出的安装指导．
解开发布的压缩文件，运行 configure，make 和 make install 把 byte-compiled（字节编译）文件和信息库就位．
然后往你的 /usr/local/share/emacs/site-lisp/site-start.el 文件里增加下
