制作文档

GNU make 被用于从 DocBook 源文件里制作文档.在你安装时可能有几个环境变量定义需要设置或更改.Makefile 将查找 doc/../src/Makefile 和 (隐含地)查找 doc/../src/Makefile.custom 以获取环境信息.在我的系统上,src/Makefile.custom 是这样的
# Makefile.custom
# Thomas Lockhart 1998-03-01

POSTGRESDIR= /opt/postgres/current
CFLAGS+= -m486
YFLAGS+= -v

# documentation

HSTYLE= /home/lockhart/SGML/db143.d/docbook/html
PSTYLE= /home/lockhart/SGML/db143.d/docbook/print
这里 HSTYLE 和 PSTYLE 分别确定用于 HTML 和硬拷贝(打印)的风格表的 docbook.dsl 的路径.这些风格表文件名是用于 Norm Walsh 的模块化风格表(Modular Style Sheets)的;如果使用了其他风格表,那么你可以定义 HDSL 和 PDSL 为该风格表的全路径和名称,就象上面对 HSTYLE 和 PSTYLE 做的那样.在许多系统上,这些风格表将可以在安装在 /usr/lib/sgml/ /usr/local/lib/sgml/ 里的软件包里找到.

HTML 文档包可以键入下面命令从 SGML 源文件里生成

% cd doc/src
% make tutorial.tar.gz
% make user.tar.gz
% make admin.tar.gz
% make programmer.tar.gz
% make postgres.tar.gz
% make install
这些包可以在主文档目录里面键入下面命令生成
% cd doc
% make install