PostgreSQL7.0手册-附录-文档
减小字体
增大字体RTF（例如）：
% cd doc/src/sgml
% make tutorial.rtf
修复 RTF 文件，以正确声明所有风格，尤其是缺省风格．这些域可以 vi 或者下面简单的l sed 过程处理：
#!/bin/sh
# fixrtf.sh
# Utility to repair slight damage in RTF files generated by jade
# Thomas Lockhart
#
for i in $* ; do
mv $i $i.orig
cat $i.orig | sed 's#\\stylesheet#\\stylesheet{\\s0 Normal;}#' > $i
done
exit
这里该脚本把 {\s0 Normal;} 作为文档的零级风格．根据 ApplixWare，RTF 标准会禁止增加一种隐含的零级风格，尽管 M$Word 碰巧可以处理这种情况．
在 Applix Words 里打开新的文档，然后输入该 RTF 文件．
用 ApplixWare 生成一个新的 ToC．
选择现有的 ToC 行，从第一行第一个字符到最后一行最后一个字符．
用 Tools.BookBuilding.CreateToC 制作一个新的 ToC．选择头三层头用于包含在 ToC里．这将用本地的 ApplixWare ToC 代替从 RTF 里输入进来的行．
使用 Format.Style 调整 ToC 格式，选择每三种 ToC 风格，然后为 First 和 Left调整边距．使用下面的值：
表 DG2-2. 目录的边距格式
风格 第一边距（英寸） 左边距（英寸）
TOC-Heading 1 0.6 0.6
TOC-Heading 2 1.0 1.0
TOC-Heading 3 1.4 1.4
对文档进行加工：
调整分页符．
调整表列宽．
向文档中插入图片．用 Applixware 工具条上的居中调整按钮把每幅图片放到中央．
注意：不是所有文档都有图片．你可以 grep SGML 源文件查找字串 "graphic" 以标出那些有图片的文档．有几幅图片在不同的文档中有重复．
用正确的值替换 ToC 里例子和图片部分右对齐的页数．这些对每个文档只需要花几分钟．
如果出现了引用书目，删去每个记录的短形式参考标题．Norm Walsh 的 DocBook 风格表好象把这些打印出来的，甚至这些就是随后根着的信息的子集也一样．
把该文档保存为 Applix Words 本地文档格式以便于最后的编辑．
把该文档以 Postscript 格式 "打印" 到一个文件．
用 gzip 压缩 Postscript 文件．把压缩后的文件放到 doc 目录．
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
工具集
安装处理文档需要的工具的经验已经文档化了，总共有三种方法。一种是在Linux 上从 RPM 里安装，第二种是从 FreeBSD 的 port（移植）里安装，最后一种是从独立的工具的最初发布里安装。这些方法将在下面描述。
可能还有一些这些工具的其他发布包．请向文档邮件列表报告包状态，我们将在这里包含那些信息．
Linux RPM 安装
使用 Cygnus 的 Mark Galassi 开发的 RPM 集是对于一个 RedHat 兼容的 Linux 系统最简单的安装方式。也可以通过源代码安装，我们随后的章节将要介绍。
安装 RPM
为 Jade 和相关包安装 RPM。
安装 Norm Walsh 的最新风格表。取决于 RPM 的新旧，最新的风格表可能比 RPM 里包含的要改进了一些。
更新你的 src/Makefile.custom 以包含指向风格表的 HSTYLE 和 PSTYLE 定义。
FreeBSD 安装
在 FreeBSD 上有一整套用于文档工具的移植（ports）。实际上，postgresql.org，其自身的文档每天晚上自动更新，就是一台 FreeBSD 机器。
安装 FreeBSD 移植
要在 FreeBSD 上面制作文档，我们需要安装许多移植包（ports）。
% cd /usr/ports/devel/gmake && make install
% cd /usr/ports/textproc/docproj && make install
% cd /usr/ports/textproc/docbook && make install
% cd /usr/ports/textproc/dsssl-docbook-modular && make install
设置环境变量以访问 jade 工具集。
注意：这些对于 postgresql.org 那台 FreeBSD 机器是不需要的，因此你也可能不需要做这些事情。
export SMGL_ROOT=/usr/local/share/sgml
SGML_CATALOG_FILES=/usr/local/share/sgml/jade/catalog
SGML_CATALOG_FILES=/usr/local/share/sgml/html/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/local/share/sgml/iso8879/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/local/share/sgml/transpec/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/local/share/sgml/docbook/catalog:$SGML_CATALOG_FILES
export SGML_CATALOG_FILES
（这是 sh/bash 语法；根据实情为 csh/tcsh 做调整）。
Make 需要一些特殊的参数，或者你要把这些加入你的 Makefile.custom 里：
HSTYLE=/usr/local/share/sgml/docbook/dsssl/modular/html/
PSTYLE=/usr/local/share/sgml/docbook/dsssl/modular/print/
当然，你要用 gmake 而不只是简单的 'make' 来制作。
Debian 安装
Debian 里也有一整套文档工具包。
安装 Debian 包
安装 jade，docbook，和 unzip：
apt-get install jade
apt-get install docbook
apt-get install docbook-stylesheets
安装最新的风格表。
确认已经安装了 unzip，或者安装包：
apt-get install unzip
从 http://www.nwalsh.com/docbook/dsssl 抓取最新的风格表并且解压缩到一个位置（可能是 /usr/share）。
编辑 src/Makefile.custom，增加合适的 HSTYLE 和 PSTYLE 定义：
HSTYLE= /usr/share/docbook/html
PSTYLE= /usr/share/docbook/print
手工安装这些工具
下面是你获取和安装用 Emacs 编辑 DocBook 源文件然后用 Norman Walsh 的 DSSSL 风格表处理并创建 HTML 和 RTF 文件所需要工具的一个简介．
获取 SGML 和 DocBook 工具的最简单方法可能是从 sgmltools 获取 sgmltools。sgmltools 需要 GNU 版本的 m4。要核实你
% cd doc/src/sgml
% make tutorial.rtf
修复 RTF 文件，以正确声明所有风格，尤其是缺省风格．这些域可以 vi 或者下面简单的l sed 过程处理：
#!/bin/sh
# fixrtf.sh
# Utility to repair slight damage in RTF files generated by jade
# Thomas Lockhart
#
for i in $* ; do
mv $i $i.orig
cat $i.orig | sed 's#\\stylesheet#\\stylesheet{\\s0 Normal;}#' > $i
done
exit
这里该脚本把 {\s0 Normal;} 作为文档的零级风格．根据 ApplixWare，RTF 标准会禁止增加一种隐含的零级风格，尽管 M$Word 碰巧可以处理这种情况．
在 Applix Words 里打开新的文档，然后输入该 RTF 文件．
用 ApplixWare 生成一个新的 ToC．
选择现有的 ToC 行，从第一行第一个字符到最后一行最后一个字符．
用 Tools.BookBuilding.CreateToC 制作一个新的 ToC．选择头三层头用于包含在 ToC里．这将用本地的 ApplixWare ToC 代替从 RTF 里输入进来的行．
使用 Format.Style 调整 ToC 格式，选择每三种 ToC 风格，然后为 First 和 Left调整边距．使用下面的值：
表 DG2-2. 目录的边距格式
风格 第一边距（英寸） 左边距（英寸）
TOC-Heading 1 0.6 0.6
TOC-Heading 2 1.0 1.0
TOC-Heading 3 1.4 1.4
对文档进行加工：
调整分页符．
调整表列宽．
向文档中插入图片．用 Applixware 工具条上的居中调整按钮把每幅图片放到中央．
注意：不是所有文档都有图片．你可以 grep SGML 源文件查找字串 "graphic" 以标出那些有图片的文档．有几幅图片在不同的文档中有重复．
用正确的值替换 ToC 里例子和图片部分右对齐的页数．这些对每个文档只需要花几分钟．
如果出现了引用书目，删去每个记录的短形式参考标题．Norm Walsh 的 DocBook 风格表好象把这些打印出来的，甚至这些就是随后根着的信息的子集也一样．
把该文档保存为 Applix Words 本地文档格式以便于最后的编辑．
把该文档以 Postscript 格式 "打印" 到一个文件．
用 gzip 压缩 Postscript 文件．把压缩后的文件放到 doc 目录．
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
工具集
安装处理文档需要的工具的经验已经文档化了，总共有三种方法。一种是在Linux 上从 RPM 里安装，第二种是从 FreeBSD 的 port（移植）里安装，最后一种是从独立的工具的最初发布里安装。这些方法将在下面描述。
可能还有一些这些工具的其他发布包．请向文档邮件列表报告包状态，我们将在这里包含那些信息．
Linux RPM 安装
使用 Cygnus 的 Mark Galassi 开发的 RPM 集是对于一个 RedHat 兼容的 Linux 系统最简单的安装方式。也可以通过源代码安装，我们随后的章节将要介绍。
安装 RPM
为 Jade 和相关包安装 RPM。
安装 Norm Walsh 的最新风格表。取决于 RPM 的新旧，最新的风格表可能比 RPM 里包含的要改进了一些。
更新你的 src/Makefile.custom 以包含指向风格表的 HSTYLE 和 PSTYLE 定义。
FreeBSD 安装
在 FreeBSD 上有一整套用于文档工具的移植（ports）。实际上，postgresql.org，其自身的文档每天晚上自动更新，就是一台 FreeBSD 机器。
安装 FreeBSD 移植
要在 FreeBSD 上面制作文档，我们需要安装许多移植包（ports）。
% cd /usr/ports/devel/gmake && make install
% cd /usr/ports/textproc/docproj && make install
% cd /usr/ports/textproc/docbook && make install
% cd /usr/ports/textproc/dsssl-docbook-modular && make install
设置环境变量以访问 jade 工具集。
注意：这些对于 postgresql.org 那台 FreeBSD 机器是不需要的，因此你也可能不需要做这些事情。
export SMGL_ROOT=/usr/local/share/sgml
SGML_CATALOG_FILES=/usr/local/share/sgml/jade/catalog
SGML_CATALOG_FILES=/usr/local/share/sgml/html/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/local/share/sgml/iso8879/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/local/share/sgml/transpec/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/local/share/sgml/docbook/catalog:$SGML_CATALOG_FILES
export SGML_CATALOG_FILES
（这是 sh/bash 语法；根据实情为 csh/tcsh 做调整）。
Make 需要一些特殊的参数，或者你要把这些加入你的 Makefile.custom 里：
HSTYLE=/usr/local/share/sgml/docbook/dsssl/modular/html/
PSTYLE=/usr/local/share/sgml/docbook/dsssl/modular/print/
当然，你要用 gmake 而不只是简单的 'make' 来制作。
Debian 安装
Debian 里也有一整套文档工具包。
安装 Debian 包
安装 jade，docbook，和 unzip：
apt-get install jade
apt-get install docbook
apt-get install docbook-stylesheets
安装最新的风格表。
确认已经安装了 unzip，或者安装包：
apt-get install unzip
从 http://www.nwalsh.com/docbook/dsssl 抓取最新的风格表并且解压缩到一个位置（可能是 /usr/share）。
编辑 src/Makefile.custom，增加合适的 HSTYLE 和 PSTYLE 定义：
HSTYLE= /usr/share/docbook/html
PSTYLE= /usr/share/docbook/print
手工安装这些工具
下面是你获取和安装用 Emacs 编辑 DocBook 源文件然后用 Norman Walsh 的 DSSSL 风格表处理并创建 HTML 和 RTF 文件所需要工具的一个简介．
获取 SGML 和 DocBook 工具的最简单方法可能是从 sgmltools 获取 sgmltools。sgmltools 需要 GNU 版本的 m4。要核实你
