Git 實做成功之經驗分享

phpBB-TW Knowledge Base
收集網友們在竹貓所發表的教學主題或文章,以利分享!
(僅供瀏覽,由版主群維護)
回覆文章
頭像
心靈捕手
默默耕耘的老師
默默耕耘的老師
文章: 8433
註冊時間: 2004-04-30 01:54
來自: Taiwan

Git 實做成功之經驗分享

文章 心靈捕手 »

前言:
Git 最初的開發動力來自於 BitKeeper 和 Monotone。 Git 最初只是作為一個可以被其他前端比如 Cogito 或 StGIT 包裝的後端而開發的。不過,後來 Git 核心已經成熟到可以獨立地用作版本控制。

目前,phpBB 團隊已將其所有開發的相關軟體,都遷移到 GitHub,以利使用者共同維護與開發。而部份的語言檔翻譯,也將採用此方式申請與維護。(更多資訊

筆者僅整理個人上傳 Quickinstall 翻譯文件成功的小小心得,以供大家分享。

Git 註冊: Git 安裝:
  • 依照您的作業系統,到下載頁面下載最新的版本。
    例如:筆者使用 Windows 7 作業系統,可以下載 msysgit 最新的版本。
Git 設定:
  1. 建立一個 SSH key(鑰匙):
    • 生成一個鑰匙:
      • 點選桌面「Git Bash」圖示兩下。
      • 依序輸入指令:

        代碼: 選擇全部

        $ ssh-keygen -t rsa -C "wang55.wang55@msa.hinet.net"
        p.s.
        wang55.wang55@msa.hinet.net:修改為您註冊的 e-mail。

        代碼: 選擇全部

        Generating public/private rsa key pair.
        Enter file in which to save the key (/c/Users/max/.ssh/id_rsa):
        p.s.
        /c/Users/user/.ssh/id_rsa:自動修改為您安裝 Git 的路徑;
        依照括弧內的提示(新增 /.ssh/ 隱藏資料夾)輸入即可。

        代碼: 選擇全部

        Enter passphrase (empty for no passphrase):
        p.s.
        留白,按「Enter」。

        代碼: 選擇全部

        Enter same passphrase again:
        p.s.
        留白,按「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)電腦的鑰匙。
        git01.png
        git01.png (37.19 KiB) 已瀏覽 23893 次
      • 點選「Add key」儲存之。
  2. 設定全域的使用者名稱與 e-mail:
    • 點選桌面「Git Bash」圖示兩下。
    • 依序輸入指令後,按「Enter」:

      代碼: 選擇全部

      $ git config --global user.name "wang5555"
      p.s.
      wang5555:修改為您註冊 Git 的帳號。

      代碼: 選擇全部

      $ git config --global user.email "wang55.wang55@msa.hinet.net"
      p.s.
      wang55.wang55@msa.hinet.net:修改為您註冊 Git 的 e-mail。
  3. 設定編碼為 utf-8:
    • 在 D 磁碟區新增 /Git/ 資料夾。
    • 以滑鼠右鍵點選 /Git/ 資料夾,再以左鍵點選「Git Init Here」。
    • 以滑鼠右鍵點選 /Git/ 資料夾,再以左鍵點選「Git Commit Tool」。
    • 按「Edit」,再點選「Option」。
    • 將 Global (All Repositories) 的「Default File Contents Encoding」改變為「utf-8」後,按「Save」。
      git02.png
      git02.png (77.15 KiB) 已瀏覽 23896 次
Git 指令:
  • 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
  • 步驟:
    1. 將專案變成叉狀--
      登入 GitHub 官方網站後,瀏覽 phpBB QuickInstall,點選「Fork」。
      git03.png
    2. 複製專案到您的電腦倉庫--
      滑鼠右鍵點選 D 磁碟區 /Git/ 資料夾,再點選「Git Bash」。
      git04.png
      輸入以下指令:

      代碼: 選擇全部

      $ git clone git@github.com:wang5555/quickinstall.git
    3. 將您已經翻譯好的 /zh_cmn_hant/ 資料夾存入--
      D:\Git\quickinstall\language\(相關目錄底下)
      git05.png
    4. 切換到下一層目錄--
      輸入以下指令:

      代碼: 選擇全部

      $ cd quickinstall
    5. 新增所有檔案--
      輸入以下指令:

      代碼: 選擇全部

      $ git add .
    6. 瀏覽目前資料狀態--
      輸入以下指令:

      代碼: 選擇全部

      $ git status
    7. 建立改變記錄--
      輸入以下指令:

      代碼: 選擇全部

      $ git commit -m 'first translation'
    8. 維護遠端檔案--
      輸入以下指令:

      代碼: 選擇全部

      $ git remote add origin git@github.com:wang5555/quickinstall.git
    9. 上傳已翻譯的 /zh_cmn_hant/ 資料夾--
      輸入以下指令:

      代碼: 選擇全部

      $ git push origin master
    10. 更新請求--
      當您完成上傳後,便可以在 wang5555 / quickinstall 點選「Pull Request」。
      git06.png
      輸入主題與內容後,點選「Send pull request」。
      git07.png


後記: --
資料來源:
http://218.161.28.134/phpBB3/viewtopic.php?f=77&t=710
施比受有福,歡迎來信賜教,謝謝 & 再見!
祝福您 好運 ^_^
歡迎加入★★心靈捕手★★ :: 討論區!!
http://wang5555.hopto.org/phpBB3/
p.s. 奉老婆之命:在晚上十一點前,得關機睡覺!!!

頭像
心靈捕手
默默耕耘的老師
默默耕耘的老師
文章: 8433
註冊時間: 2004-04-30 01:54
來自: Taiwan

Re: Git 實做成功之經驗分享

文章 心靈捕手 »

補充說明:
  • phpBB 翻譯者,必須在專案底下,自行建立新的分支「intl-<lang>」。
    例如:「intl-de」或「intl-zh_cmn_hant」。
操作實例:
  • 目標:
    要將翻譯好的 STK 語言檔,上傳至 phpbb / support-toolkit
  • 步驟:
    1. 將專案變成叉狀--
      登入 GitHub 官方網站後,瀏覽 phpbb / support-toolkit,點選「Fork」。
    2. 複製專案到您的電腦倉庫--
      以滑鼠右鍵點選 D 磁碟區 /Git/ 資料夾,再點選「Git Bash」。
      輸入以下指令:

      代碼: 選擇全部

      $ git clone git@github.com:wang5555/support-toolkit.git
    3. 將您已經翻譯好的 /zh_cmn_hant/ 資料夾存入--
      D:\Git\support-toolkit\stk\language\(相關目錄底下)
    4. 切換到下一層目錄--
      輸入以下指令:

      代碼: 選擇全部

      $ cd support-toolkit
    5. 新增所有檔案--
      輸入以下指令:

      代碼: 選擇全部

      $ git add .
    6. 瀏覽目前資料狀態--
      輸入以下指令:

      代碼: 選擇全部

      $ git status
    7. 建立改變記錄--
      輸入以下指令:

      代碼: 選擇全部

      $ git commit -m 'first translation'
    8. 建立新的分支--
      輸入以下指令:

      代碼: 選擇全部

      $ git checkout -b intl-zh_cmn_hant stk/olympus
      p.s.
      此專案的主分支(master branch)名稱為「stk/olympus」。
    9. 維護遠端檔案--
      輸入以下指令:

      代碼: 選擇全部

      $ git remote add origin git@github.com:wang5555/support-toolkit.git
    10. 上傳已翻譯的 /zh_cmn_hant/ 資料夾--
      輸入以下指令:

      代碼: 選擇全部

      $ git push origin intl-zh_cmn_hant
    11. 更新請求--
      當您完成上傳後,便可以在 wang5555 / support-toolkit 點選「Pull Request」。
      輸入主題與內容後,點選「Send pull request」。
參考連結:
http://wiki.phpbb.com/Sub-Project_Contr ... Guidelines
施比受有福,歡迎來信賜教,謝謝 & 再見!
祝福您 好運 ^_^
歡迎加入★★心靈捕手★★ :: 討論區!!
http://wang5555.hopto.org/phpBB3/
p.s. 奉老婆之命:在晚上十一點前,得關機睡覺!!!

回覆文章

回到「教學文件庫」