GitHub 簡易入門指南

Getting Started With GitHub

GitHub 是一個線上平台，旨在促進在一個共同專案上工作的個人之間的程式碼託管、版本控制和共同作業。通過該平台，無論何時何地，都可以對專案進行操作（託管和審查程式碼，管理專案和與世界各地的其他開發者共同開發軟體）。GitHub 平台為開源專案和私人專案都提供了專案處理功能。

關於團隊專案處理的功能包括：GitHub 流Flow>和 GitHub 頁Pages。這些功能可以讓需要定期部署的團隊輕鬆處理工作流程。另一方面，GitHub 頁提供了頁面用於展示開源專案、展示簡歷、託管部落格等。

GitHub 也為個人專案提供了必要的工具，使得個人專案可以輕鬆地處理。它也使得個人可以更輕鬆地與世界分享他們的專案。

註冊 GitHub 並啟動一個專案

在 GitHub 上啟動新專案時，您必須先使用您的電子郵件地址建立一個帳戶。

github homepage

然後，在驗證郵箱的時候，使用者將自動登入到他們的 GitHub 帳戶。

1、 建立倉庫

之後，我們會被帶到一個用於建立倉庫repository的頁面。?倉庫儲存著包括修訂歷史記錄在內的所有專案檔案。倉庫可以是公開的或者是私有的。公開的倉庫可以被任何人檢視，但是，只有專案所有者授予許可權的人才可以提交修改到這個倉庫。另一方面，私有倉庫提供了額外的控制，可以將專案設定為對誰可見。因此，公開倉庫適用於開源軟體專案，而私有倉庫主要適用於私有或閉源專案。

• 填寫 “倉庫名稱Repository Name” 和 “簡短描述Short Description”。
• 選中 “以一個 README 檔案初始化Initialize this repository with a README”。
• 最後，點選底部的 “建立倉庫Create Repository” 按鈕。

create a github repository

2、 新增分支

在 GitHub 中，分支branch是一種同時操作單個倉庫的各種版本的方式。預設情況下，任何建立的單個倉庫都會被分配一個名為 “MASTER” 的分支，它被認為是最後一個分支。在 GitHub 中，分支在被合併到主幹master（最後的分支）之前，可以在對倉庫進行實驗和編輯中發揮作用。

為了使專案適合每一個人的需求，通常情況下，總是需要新增幾個格外的分支來匹配不同的專案。在主分支上建立一個分支和複製主分支時的當前狀態是一樣的。

add a branch to github repository

建立分支與在不同版本中儲存單個檔案是類似的。它通過在特定倉庫上執行的任務重新命名來實現。

分支在保持錯誤修復和功能新增工作中同樣被證明是有效。在進行必要的修改後，這些分支會被合併到主分支中。

在建立倉庫後建立一個分支：

• 在這個例子中，點選倉庫名稱 “Hello-World” 跳轉到你的新倉庫。
• 點選頂部的 “Branch:Master” 按鈕，會看到一個下拉式選單，選單裡有填寫分支名稱的空白欄位。
• 輸入分支名稱，在這個例子中我們輸入 “readme-edits“。
• 按下確認鍵或者點選藍色的 “建立分支create branch” 框。

這樣就成功建立了兩個分支：master 和 readme-edits。

3、 修改專案檔案並提交

此步驟提供了關於如何更改倉庫並儲存修改的指導。在 GitHub 上，提交commit被定義為儲存的修改的意思。每一次提交都與一個提交資訊commit message相關聯，該提交資訊包含了儲存的修改的歷史記錄，以及為何進行這些更改。這使得其他貢獻者可以很輕鬆地知道你做出的更改以及更改的原因。

要對倉庫進行更改和提交更改，請執行以下步驟：

• 點選倉庫名稱 “Hello-World”。
• 點選右上角的鉛筆圖示檢視和編輯檔案。
• 在編輯器中，寫一些東西來確定你可以進行更改。
• 在提交訊息commit message欄位中做簡要的總結，以解釋為什麼以及如何進行更改。
• 點選提交更改 commit changes按鈕儲存更改。

請注意，這些更改僅僅影響到 readme-edits 分支，而不影響主分支。

commit branch to master

4、 開啟一個拉取請求

?拉取請求pull request是一個允許貢獻者提出並請求某人審查和合併某些更改到他們的分支的功能。?拉取請求還顯示了幾個分支的差異（diffs）。更改、新增和刪減通常以紅色和綠色來表示。一旦提交完成就可以開啟?拉取請求，即使程式碼還未完成。

開啟一個?拉取請求：

• 點選??拉取請求pull requests索引標籤。
• 點選新建拉取請求new pull requests按鈕。
• 選擇 readme-edits 分支與 master 分支進行比較。
• 確定請求，並確定這是您要提交的內容。
• 點選建立?拉取請求綠色按鈕並輸入一個標題。
• 按下確認鍵。

使用者可以通過嘗試建立並儲存拉取請求來證實這些操作。

5、 合併拉取請求

最後一步是將 readme-edits 分支和 master 分支合併到一起。如果 readme-edits 分支和 master 分支不會產生衝突，則會顯示merge pull request合併拉取請求的按鈕。

merge the pull request github

當合併拉取時，有必要確保評論comment和其他欄位被正確填寫。合併拉取：

• 點選merge pull request合併拉取請求的按鈕。
• 確認合併。
• 按下紫色的刪除分支按鈕，刪除 readme-edits 分支，因為它已經被包含在 master 分支中。（LCTT 譯註：如果是合併他人提交的拉取請求，則無需也無法刪除合併過來的他人的分支。）

本文提供了 GitHub 平台從註冊到使用的基本操作，接下來由大家盡情探索吧。

GitHub 教學系列文章： 

通過GitHub建立個人技術部落格圖文詳解  http://www.linuxidc.com/Linux/2015-02/114121.htm

GitHub 使用教學圖文詳解  http://www.linuxidc.com/Linux/2014-09/106230.htm 

使用 GitHub / GitLab 的 Webhooks 進行網站自動化部署  http://www.linuxidc.com/Linux/2016-06/131993.htm

多個GitHub帳號的SSH key切換 http://www.linuxidc.com/Linux/2016-05/131080.htm

如何在同一台電腦上使用兩個GitHub賬戶 http://www.linuxidc.com/Linux/2016-05/131079.htm

利用GitHub搭建個人Maven倉庫  http://www.linuxidc.com/Linux/2016-04/130197.htm

一分鐘認識GitHub http://www.linuxidc.com/Linux/2015-11/125089.htm

分享實用的GitHub 使用教學 http://www.linuxidc.com/Linux/2014-04/100556.htm 

GitHub使用操作指南  http://www.linuxidc.com/Linux/2016-10/135782.htm

GitHub使用方法入門基礎  http://www.linuxidc.com/Linux/2017-05/144084.htm