天天看點

PostgreSQL9.5中文手冊的翻譯送出步驟

PostgreSQL 9.5中文手冊翻譯目前已經開始進行,通過github進行翻譯的管理,相關流程和說明請參考

<a href="https://github.com/postgres-cn/pgdoc-cn/wiki/pg9.5" target="_blank">https://github.com/postgres-cn/pgdoc-cn/wiki/pg9.5</a>

本文介紹如何使用git工具送出翻譯後的文檔(在參與翻譯工作前,請務必仔細閱讀上面的wiki頁面)。

下面的操作均假設在Windows系統上,其它平台的操作類似。

1. 注冊github賬号

首先你要注冊一個github賬号,可以進這個頁面新增賬號 https://github.com/join 。如果你已經有賬号了,跳過這一步。

2. 下載下傳安裝git用戶端

http://git-scm.com/downloads

注:也可以使用你熟悉的其它Git工具,比如Git Extensions。但下面的操作步驟以Git用戶端為例子。

3. 打開git bash

進入你的工作目錄,點滑鼠右鍵,再在彈出菜單上點選"Git Bash"。

4. 配置git用戶端

配置賬号和email:

$ git config --global user.name "your_name"

$ git config --global user.email "[email protected]"

賬号和email要替換成github上你注冊的使用者名和郵箱。

生成SSH key:

$ ssh-keygen -t rsa -b 4096 -C "[email protected]"

一路回車,會在你使用者目錄的".ssh"目錄(比如C:\Users\Administrator)下生成SSH key,其中id_rsa.pub是你的公鑰。

打開https://github.com/settings/ssh,點選"Add SSH key",将id_rsa.pub的内容添加上去。

做完這一步,以後向github倉庫push的時候就可以免去認證的麻煩。

5. Fork一個你自己的倉庫

打開下面的URL,點選右上角的"Fork"按鈕,Fork一個你自己的倉庫。以後你的更新都push到自己的倉庫,再由自己的倉庫發起pull request。

https://github.com/postgres-cn/pgdoc-cn

6. clone你自己的Github倉庫到本地

$ git clone [email protected]:your_name/pgdoc-cn.git

把上面的your_name替換成你自己的github使用者名。

這裡不直接clone原始庫到本地的原因在于,你沒有原始庫的寫權限,不能直接往原始庫push修改,隻能先借助于你自己的Github倉庫。

7. 配置本地倉庫與原始庫同步

$ cd pgdoc-cn

$ git remote add upstream [email protected]:postgres-cn/pgdoc-cn.git

8. 從原始庫擷取最新的sgml檔案到本地

$ git pull -r upstream master:master

9. 修改sgml檔案

用你喜歡的編輯器修改sgml檔案并儲存。

修改完成後,可運作builddoc.bat本地編譯一下,然後打開下面的網頁預覽效果。

pgdoc-cn\postgresql\doc\src\sgml\html\index.html

10. 送出修改到本地庫

$ git add .

$ git commit -m "翻譯9.5 xxxx.sgml"

add和commit之前最好先用git status确認一下修改了哪些檔案,要送出哪些檔案。

另外,commit這一步建議通過GUI來做,可以看到要送出哪些檔案,輸入中文commit說明也更友善。

調出GUI commit 視窗的方法是,點滑鼠右鍵,再在彈出菜單上點選"Git Commit Tool"。

11. push本地庫的修改到你自己的github倉庫

$ git push origin master:master

12. 通過你的github倉庫向原始庫發起pull request

下面通過一個例子來說明。

比如,我剛剛按上面的方法修改了bki.sgml,并push到我自己的github倉庫。

現在打開我的github倉庫https://github.com/ChenHuajun/pgdoc-cn,發現下面的提示畫面。

PostgreSQL9.5中文手冊的翻譯送出步驟

點選"New pull request",進入下一畫面。

PostgreSQL9.5中文手冊的翻譯送出步驟

确認修改無誤後(可以通過看頁面下方的檔案對比),點選"Create pull request"。然後進入下面的畫面。

PostgreSQL9.5中文手冊的翻譯送出步驟

輸入必要的說明再點選"Create pull request",修改的pull request就發出去了。

注意上面圖檔的含義,是指從你自己的倉庫(bead fork: ChenHuajun/pgdoc-cn)的master

分支向原始庫(base fork:postgres-cn/pgdoc-cn)的master分支發pull request。

13. 再次修改sgml

過了一段時間再次修改其他sgml時,從上面的第8步開始做。因為github原始庫裡有其他人的更新,第8步可以把這些更新拉過來,保持和原始庫的資料同步。

繼續閱讀