若要更有效率地使用您的翻譯,並保持最新的狀態,建議您將 svn 資源庫下載到電腦中,以便您能定期查看自上次瀏覽/變更以來哪些英文檔案已更新,並將這些變更傳輸到您現有的中譯檔案。此外,透過這種方式,您將可以在本地端建立文件 (將其轉換為 HTML 檔案),以便查看變更的外觀。
文件手冊分為多個分支
查看哪些文件已經翻譯,以及是否為最新狀態,有助於您進行翻譯。
若要正常進行作業,您必須將 doc
樹狀結構 (svn 資源庫) 下載到您的電腦
在電腦中建立一個名為 "httpd-doc" 的目錄:mkdir httpd-doc
切換至這個目錄: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
完成檔案修改後,請將其儲存到 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(好的例子)。
完成後,請別忘記儲存你的工作(在適當的 "sav" 子目錄中儲存 bind.xml 和 bind.xml.fr 的新版本)。
若要查看修改項目呈現的方式,你必須建置文件以透過 xml 檔案產生 HTML 檔案(請參閱此文件)。
對你的工作感到滿意後,請提交修正程式至https://bz.apache.org/bugzilla/
歡迎將問題寄送至 docs@httpd.apache.org