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

收藏: