Git 最初的開發動力來自於 BitKeeper 和 Monotone。 Git 最初只是作為一個可以被其他前端比如 Cogito 或 StGIT 包裝的後端而開發的。不過,後來 Git 核心已經成熟到可以獨立地用作版本控制。
目前,phpBB 團隊已將其所有開發的相關軟體,都遷移到 GitHub,以利使用者共同維護與開發。而部份的語言檔翻譯,也將採用此方式申請與維護。(更多資訊)
筆者僅整理個人上傳 Quickinstall 翻譯文件成功的小小心得,以供大家分享。
Git 註冊:
- 要使用 Git,當然得先到 GitHub 官方網站註冊一個使用者帳號。
- 建立一個 SSH key(鑰匙):
- 生成一個鑰匙:
- 點選桌面「Git Bash」圖示兩下。
- 依序輸入指令:
p.s.
代碼: 選擇全部
$ ssh-keygen -t rsa -C "wang55.wang55@msa.hinet.net"
wang55.wang55@msa.hinet.net:修改為您註冊的 e-mail。
p.s.代碼: 選擇全部
Generating public/private rsa key pair. Enter file in which to save the key (/c/Users/max/.ssh/id_rsa):
/c/Users/user/.ssh/id_rsa:自動修改為您安裝 Git 的路徑;
依照括弧內的提示(新增 /.ssh/ 隱藏資料夾)輸入即可。
p.s.代碼: 選擇全部
Enter passphrase (empty for no passphrase):
留白,按「Enter」。
p.s.代碼: 選擇全部
Enter same passphrase again:
留白,按「Enter」。
結果如下:代碼: 選擇全部
Your identification has been saved in /c/Users/max/.ssh/id_rsa. Your public key has been saved in /c/Users/max/.ssh/id_rsa.pub. The key fingerprint is: d0:58:38:9f:3a:c9:e7:af:3b:4b:37:77:a1:2f:dd:d7 wang55.wang55@msa.hinet.net
- 將生成的鑰匙增加到您的 Git 帳號:
- 以文字編輯器開啟 id_rsa.pub,複製其中代碼。
- 登入 Git,到您的 Git 帳號,點選「SSH Public Keys」。
如果您已經有儲存過,那麼再點選「Add another public key」。 - 將複製的代碼貼上 Key 欄位。
- Title 欄位則建議輸入某值,以示區別。(留白,則以 e-mail 顯示)。
例如:筆者已經有儲存家用(home)與學校(school)電腦的鑰匙,現在再新增筆記型(notebook)電腦的鑰匙。 - 點選「Add key」儲存之。
- 生成一個鑰匙:
- 設定全域的使用者名稱與 e-mail:
- 點選桌面「Git Bash」圖示兩下。
- 依序輸入指令後,按「Enter」:
p.s.
代碼: 選擇全部
$ git config --global user.name "wang5555"
wang5555:修改為您註冊 Git 的帳號。
p.s.代碼: 選擇全部
$ git config --global user.email "wang55.wang55@msa.hinet.net"
wang55.wang55@msa.hinet.net:修改為您註冊 Git 的 e-mail。
- 設定編碼為 utf-8:
- 在 D 磁碟區新增 /Git/ 資料夾。
- 以滑鼠右鍵點選 /Git/ 資料夾,再以左鍵點選「Git Init Here」。
- 以滑鼠右鍵點選 /Git/ 資料夾,再以左鍵點選「Git Commit Tool」。
- 按「Edit」,再點選「Option」。
- 將 Global (All Repositories) 的「Default File Contents Encoding」改變為「utf-8」後,按「Save」。
- add(新增檔案)
- branch(分支)
- clone(複製)
- commit(記錄倉庫的改變)
- diff(比較不同)
- fetch(切換)
- grep(搜尋字串)
- init(建立新的倉庫)
- log(記錄)
- merge(合併)
- mv(修改檔名、搬移目錄)
- pull(更新)
- push(上傳)
- remote(維護遠端檔案)
- reset(重設)
- revert(資料還原)
- rm(刪除檔案)
- show(顯示)
- stash(暫存)
- status(狀態)
- tag(標籤)
- -d(還原已被刪除的檔案)
Git 實做:
- 目標:上傳已翻譯的 /zh_cmn_hant/ 資料夾(含底下的目錄以及檔案)到 phpBB QuickInstall。
- 步驟:
- 將專案變成叉狀--
登入 GitHub 官方網站後,瀏覽 phpBB QuickInstall,點選「Fork」。 - 複製專案到您的電腦倉庫--
滑鼠右鍵點選 D 磁碟區 /Git/ 資料夾,再點選「Git Bash」。 輸入以下指令:代碼: 選擇全部
$ git clone git@github.com:wang5555/quickinstall.git
- 將您已經翻譯好的 /zh_cmn_hant/ 資料夾存入--
D:\Git\quickinstall\language\(相關目錄底下) - 切換到下一層目錄--
輸入以下指令:代碼: 選擇全部
$ cd quickinstall
- 新增所有檔案--
輸入以下指令:代碼: 選擇全部
$ git add .
- 瀏覽目前資料狀態--
輸入以下指令:代碼: 選擇全部
$ git status
- 建立改變記錄--
輸入以下指令:代碼: 選擇全部
$ git commit -m 'first translation'
- 維護遠端檔案--
輸入以下指令:代碼: 選擇全部
$ git remote add origin git@github.com:wang5555/quickinstall.git
- 上傳已翻譯的 /zh_cmn_hant/ 資料夾--
輸入以下指令:代碼: 選擇全部
$ git push origin master
- 更新請求--
當您完成上傳後,便可以在 wang5555 / quickinstall 點選「Pull Request」。 輸入主題與內容後,點選「Send pull request」。
- 將專案變成叉狀--
後記:
- 常見問題:
當執行「$ git remote add origin...」時,出現下列錯誤:解決方法:代碼: 選擇全部
fatal: remote origin already exists.
先執行底下指令刪除,再重新執行「$ git remote add origin...」。代碼: 選擇全部
$ git remote rm origin
- 參考資料:
資料來源:
http://wang5555.dnsfor.me/phpBB3/viewtopic.php?f=77&t=710