Linux中國

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 changes to github repository
  • 在編輯器中,寫一些東西來確定你可以進行更改。
  • 提交消息 commit message 欄位中做簡要的總結,以解釋為什麼以及如何進行更改。
  • 點擊 提交更改 commit changes 按鈕保存更改。

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

commit branch to master

4、 開啟一個拉取請求

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

開啟一個​拉取請求:

  • 點擊​ ​拉取請求 pull requests 選項卡。 github pull request
  • 點擊 新建拉取請求 new pull requests 按鈕。
  • 選擇 readme-edits 分支與 master 分支進行比較。 compare commit changes github
  • 確定請求,並確定這是您要提交的內容。
  • 點擊創建​拉取請求綠色按鈕並輸入一個標題。 open a pull request in github repository
  • 按下回車鍵。

用戶可以通過嘗試創建並保存拉取請求來證實這些操作。

5、 合併拉取請求

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

merge the pull request github

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

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

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

via: http://www.linuxandubuntu.com/home/getting-started-with-github

作者:LinuxAndUbuntu 譯者:firmianay 校對:wxy

本文由 LCTT 原創編譯,Linux中國 榮譽推出


本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive

對這篇文章感覺如何?

太棒了
0
不錯
0
愛死了
0
不太好
0
感覺很糟
0
雨落清風。心向陽

    You may also like

    Leave a reply

    您的電子郵箱地址不會被公開。 必填項已用 * 標註

    此站點使用Akismet來減少垃圾評論。了解我們如何處理您的評論數據

    More in:Linux中國