源代码检出

Apache 在官方网站上提供了各种文档的下载。

但是就是没有中文语言版本,通过 Google 的搜索,很多人都自行翻译了 Apache 的中文文档,而且都挂到了网上。

其实我们可以统一一个版本后发给 Apache,将我们中文翻译的成功让所有人共享。

下面介绍如何在本地编译 Apache 提供的原始文档。

首先你需要安装 SVN 的客户端,如果你还没有安装 SVN 的客户端,你可以安装 tortoise svn。

下载地址是 http://tortoisesvn.tigris.org/

安装后,到你希望检出的目录下,右键:你将会看到 SVN Checkout

配置 SVN

单击 SVN Checkout 后配置 Checkout 路径。

Apache 的文档 svn 路径为: https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/

如果我希望把文件都检出到我本地的 D:\workdir\OSS\httpd\docs 目录下的话。

下载编译环境

下载代码完成后,进入 D:\workdir\OSS\httpd\docs\manual> 目录。

你需要为你的代码下编译环境。

svn co http://svn.apache.org/repos/asf/httpd/docs-build/trunk build

编译

输入 build 命令进行编译。

D:\workdir\OSS\httpd\docs\manual\build>build

如果你希望编译中文的,你可以在后面加参数

D:\workdir\OSS\httpd\docs\manual\build>build zh-cn

结果

源文件为 handler.xml

你需要将这个文件重命名为 handler.xml.zh-cn

然后开始翻译 handler.xml.zh-cn 中的内容,当翻译完成后,就执行build 命令,程序会生成 handler.html.zh-cn 文件。

handler.html.zh-cn 就是我们需要的结果。

如何编译 Apache 文档 (last edited 2011-02-27 05:57:15 by huyuchengus)