为了更有效地进行翻译并保持翻译的最新状态,建议您将 svn 仓库下载到您的计算机上,以便您可以定期检查自上次访问/更改以来哪些英文文件已更新,并将这些更改转移到您现有的翻译文件中。此外,通过这种方式,您将能够在本地构建文档(将其转换为 HTML 文件),以便查看您的更改效果。
文档手册分为多个分支
很高兴看到 哪些内容已被翻译 以及是否已更新。
为了正常工作,您必须将 doc
树(svn 仓库)下载到您的计算机上
在您的计算机上创建一个名为 "httpd-doc" 的目录:mkdir httpd-doc
cd 到此目录:cd httpd-doc
下载 svn 仓库
svn co https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs httpd-trunk
svn co https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x/docs httpd-2.4
注意:SVN 是一个功能强大的程序;更多信息请参见 此处,当然,如果您在类 Unix 环境中工作,还可以使用 "svn --help
" 或 "man svn
"。
翻译尚未翻译的文档,如 翻译文档 中所示。
有几种方法可以做到这一点。以下是我多年来一直在使用的方法;它可能不是最好的,但它将帮助您入门。
cd 到您的仓库根目录 "httpd-doc"
创建一个名为 "working" 的目录(稍后将使用):mkdir working
创建一个名为 "sav" 的目录(用于更新检测的参考目录 - 参见下文):mkdir sav
将您上面下载的 svn 仓库复制到 "sav" 目录中
cp -a httpd-trunk sav
cp -a httpd-2.4 sav
完成对某个文件的处理后,例如 file.xml.fr,将其保存到 sav 树中相应的目录中,以及其英文版本 file.xml;您将在下一步中了解原因。
假设一周后,您想查看文档专家是否进行了一些更改:cd 到您的仓库根目录 "httpd-doc",其中包含不同的分支。
将 此脚本 复制到 "httpd-doc" 目录中,并从那里启动它。将显示每个分支的修改。
假设 2.4 分支的修改包含以下行
U manual/bind.xml
这意味着自上次访问以来,manual/bind.xml 文件已修改。为了检查这些修改,您必须将 manual/bind.xml 的最新版本与您上次工作会话期间保存到 "sav" 目录中的版本进行比较;为此,您可以使用 diff 命令,方法如下
diff sav/httpd-2.4/manual/bind.xml httpd-2.4/manual/bind.xml > working/diff-bind
working/diff-bind
文件现在包含您在翻译后必须转移到您自己的 bind.xml.ll(ll->本地语言)中的所有修改,例如 bind.xml.fr(一个很好的例子)。
完成后,不要忘记保存您的工作(bind.xml 和 bind.xml.fr 的新版本位于相应的 "sav" 子目录中)。
为了检查您的修改效果,您必须构建文档以从 xml 文件生成 HTML 文件(请参见 此文档)。
对您的工作满意后,请向 https://bz.apache.org/bugzilla/ 提交补丁。
请随时将您的问题发送到 docs@httpd.apache.org