Windows下搭建Docbook环境

为了更好地跟踪Zend Framework文档的最新版本，我们决定使用编辑Docbook的XML文件的方法来进行翻译，然后通过svn更新到Zend的服务器。

由于XML的可读性不如HTML，有时候需要我们在翻译完后在本地编译出HTML，看看效果如何。

下面说说Windows平台下如何搭建本地编译Docbook文档的环境：

(一) 安装Cygwin

(1)下载
(2) 点击安装
在安装的时候，程序会询问安装哪些package，你必须确保选择了以下package:
(按Zend的README，只需要安装autoconf, make,
libxml2-devel，但我测试不行，后来按一个德国程序员Ralf的建议，安装了以下几个软件包，就可以了—haohappy注)
autoconf
libgcrypt
libgpg-error
libxml2
libxslt
m4
make
perl

注意：你也可以在安装完cygwin之后手动安装这些package。
从 上选择一个镜像服务器，下载以上列出的软件包。然后将它们的tar.bz2文件全部放在C:\cygwin目录下(假设我们把cygwin安装在C:\cygwin目录下)。

输入命令 tar –xjvf *.tar.bz2
将这些软件包解开即可完成安装，软件包会自动安装到相应目录。

(二) 编译文档

点击桌面的cygwin图标，进入命令行，输入：
$cd documentation/zh
$autoconf
$./configure
$make

即可开始编译，生成的HTML文件位于zh/html目录。 再次编译时，如果html目录中存在html文件，会导致编译中止，可以用命令：
make clean

然后再次运行
make

编译注意：

默认情况下，使用的DTD和XSL文件为（定义于Makefile.in文件中）：
DOCBOOK_DTD=
DOCBOOK_XSL=

你可以将DTD和XSL下载至本地后，修改Makefile.in文件中的两项值，可以加快编译速度。

比如：
DOCBOOK_DTD=
DOCBOOK_XSL=