Windows下搭建Docbook环境

为了更好地跟踪Zend Framework文档的最新版本，我们决定使用编辑Docbook的XML文件的方法来进行翻译，然后通过svn更新到Zend的服务器。
由于XML的可读性不如HTML，有时候需要我们在翻译完后在本地编译出HTML，看看效果如何。
下面说说Windows平台下如何搭建本地编译Docbook文档的环境：
(一) 安装Cygwin
(1)下载
http://www.cygwin.com/setup.exe
(2) 点击安装
在安装的时候，程序会询问安装哪些package，你必须确保选择了以下package:
(按Zend的README，只需要安装autoconf, make,
libxml2-devel，但我测试不行，后来按一个德国程序员Ralf的建议，安装了以下几个软件包，就可以了—haohappy注)
autoconf
libgcrypt
libgpg-error
libxml2
libxslt
m4
make
perl
注意：你也可以在安装完cygwin之后手动安装这些package。
从
http://cygwin.com/mirrors.html
上选择一个镜像服务器，下载以上列出的软件包。然后将它们的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=http://framework.zend.com/docbook/xml/4.4/docbookx.dtd
DOCBOOK_XSL=http://framework.zend.com/docbook-xsl/html/chunk.xsl
你可以将DTD和XSL下载至本地后，修改Makefile.in文件中的两项值，可以加快编译速度。
比如：
DOCBOOK_DTD=http://localhost/zf/docbook/xml/4.4/docbookx.dtd
DOCBOOK_XSL=http://localhost/zf/docbook/docbook-xsl/html/chunk.xsl