- 1. GitHub 的Hello World教程
- 2. 參考鏈接
1. GitHub 的Hello World教程
翻譯自
https://guides.github.com/activities/hello-world/
內(nèi)容有精簡和補充，開頭部分增加了重要流程和概念的介紹。
為了便于實際使用github，熟悉界面單詞， 每個步驟的標題沒有翻譯，采用其特有的術語，對應的要素在第一次提到時都給出了中文所對應的英文。
1.1. 什么是GitHub？
GitHub是版本控制和協(xié)作的代碼托管平臺。它可以讓你和其他人在任何地方一起工作。
本教程向您介紹GitHub 基本要素，如存儲庫(repository)，分支(branches)，提交(commits)和合并請求(Pull Requests)。
您將創(chuàng)建自己的Hello World存儲庫并學習GitHub的Pull Request工作流程，這是一種創(chuàng)建和查看代碼的流行方式。
無需編碼
為了完成這個教程，你需要一個GitHub.com 賬號 和Internet的訪問， 不需要知道如何編碼，使用命令行或者安裝Git(GitHub 構建其上的版本控制軟件)
提示：在單獨的瀏覽器窗口（或選項卡）中打開本指南，以便在完成教程中的步驟時看到它。
1.1.1. 安全試驗和修改的核心：Branching & Pull Requests
使用github最重要的概念是分支合并流程：
有了分支，可以很安全第進行修改和增加新特性。
- 創(chuàng)建分支，可以在分支里安全地實驗和修改。
- 打開一個合并請求，從其他人那里得到反饋。
- 部署代碼測試，合并修改到主分支。
1.1.2. 社會協(xié)作編碼的核心：Forking
另一個需要了解的概念是Forking Projects
在自己使用GitHub一段時間后，您可能會發(fā)現(xiàn)自己想要為其他人的項目做出貢獻。或者，也許你想用某人的項目作為自己的起點。這個過程被稱為分叉（forking）。
創(chuàng)建一個“分叉”就是制作其他人項目的個人副本。叉子(forks) 充當原始存儲庫和個人副本之間的橋梁。您可以提交合并請求Pull Requests，通過將更改提供給原始項目來幫助改善其他人的項目。分叉Forking 是GitHub社會協(xié)同編碼的核心。
限于篇幅，請自行到參考資料中查看，本文不作具體說明。
1.2. 第1步. Create a Repository
一個庫Repository通常用于組織單個項目。存儲庫可以包含文件夾和文件，圖像，視頻，電子表格和數(shù)據(jù)集 - 您的項目需要的任何東西。我們建議包括一個自述文件或包含關于您項目信息的文件。GitHub可以在創(chuàng)建新存儲庫的同時輕松添加一個。它還提供其他常見選項，如許可證文件。
您的hello-world存儲庫可以是您存儲想法，資源甚至與其他人共享和討論事物的地方。
創(chuàng)建一個新的存儲庫
在右上角，在你的頭像或身份證旁邊，點擊 然后選擇新的存儲庫。
命名您的存儲庫hello-world。
寫一個簡短的描述。
選擇使用自述文件初始化此存儲庫。
1.3. 第2步. Create a Branch
分支Branching 是一次處理不同版本的存儲庫的方式。
默認情況下，你的倉庫中有一個分支master，它被認為是最終分支。在提交之前，我們使用分支來進行實驗和編輯master。
當您從分支創(chuàng)建分支時master，您正在制作master當時的副本或快照。如果其他人在master分支上工作時對分支進行了更改，則可以引入這些更新。
此圖顯示：
- 該master分支
- 一個新的分支叫feature（因為我們正在這個分支上做'feature工作'）
- feature合并至master之前的過程
分店
你有沒有保存過不同版本的文件？就像是：
- story.txt
- story-joe-edit.txt
- story-joe-edit-reviewed.txt
分支Branches 在GitHub存儲庫中實現(xiàn)類似的目標。
在GitHub上，我們的開發(fā)人員，作家和設計人員使用分支機構將錯誤修復和功能工作與我們master（生產(chǎn)）分支分開。當一個變化就緒后，他們再將分支合并到master。
1.3.1. To create a new branch
- 轉(zhuǎn)到您的新存儲庫hello-world。
- 單擊文件列表頂部的下拉列表中的分支：master。
- readme-edits在新的分支文本框中輸入分支名稱。
-
選擇藍色的創(chuàng)建分支框或點擊鍵盤上的“Enter”鍵。
Mrzgithub-branching.gif
現(xiàn)在你有兩個分支，master并且readme-edits。它們看起來完全一樣，但時間不長！接下來，我們會將我們的更改添加到新分支。
1.4. 第3步. Make and commit changes
好樣的！現(xiàn)在，您在您的readme-edits分支的代碼視圖中，它是master的副本。我們來做一些編輯。
在GitHub上，保存更改被稱為提交commit。每個提交都有一個關聯(lián)的提交消息commit message，它是解釋為什么進行特定更改的說明。提交消息捕獲您所做更改的歷史記錄，所以其他貢獻者可以了解您所做的工作以及原因。
1.4.1. Make and commit changes
- 點擊該README.md文件。
- 點擊 鉛筆圖標在文件視圖的右上角進行編輯。
- 在編輯器中，寫一些關于你自己的信息。
- 編寫描述您的更改的提交消息。
-
單擊提交更改按鈕。
image
這些更改將僅針對readme-edits分支上的readme文件進行，因此現(xiàn)在該分支包含與master不同的內(nèi)容。
1.5. 第4步. Open a Pull Request
現(xiàn)在您已經(jīng)在主分支之外進行了更改，你可以開始合并請求Open a Pull Request。
合并請求(Pull Requests)是GitHub協(xié)作的核心。當你打開一個合并請求時，你提出了你的改變，并要求有人審查并提交你的貢獻，并將它們合并到他們的分支中。合并請求顯示來自兩個分支的內(nèi)容的差異。更改，添加和減法以綠色和紅色顯示。
一旦你提交了，你甚至可以在代碼完成之前打開一個合并請求并開始討論。
通過在您的合并請求消息中使用GitHub的 @mention system ，您可以要求特定人員或團隊提供反饋，無論他們是否在大廳或10個時區(qū)以外。
你甚至可以在自己的倉庫中打開合并請求并自己合并。在開始大型項目之前，學習GitHub流程是一種很好的方式。
1.5.1. Open a Pull Request for changes to the README
-
點擊 合并請求 標簽，然后從合并請求頁面點擊綠色的新建請求按鈕。
image 在“ 示例比較”框中，選擇您創(chuàng)建的分支readme-edits以與master（原始）進行比較。
- 查看比較頁面上差異的更改，確保它們是您想要提交的內(nèi)容。
-
如果您滿意這些是您要提交的更改，請點擊綠色的“ 創(chuàng)建合并請求”按鈕。
image -
為您的拉取請求提供一個標題并寫下您的更改的簡要說明。
image
1.6. 第5步. Merge your Pull Request
在這最后一步中，是時候把你的修改結合起來 - 將你的readme-edits分支合并到master分支中。
- 點擊綠色 合并拉請求（Merge pull request ） 按鈕，將更改合并到master。
- 點擊確認合并。
- 繼續(xù)操作，并刪除分支，因為它的更改已經(jīng)合并，并在紫色框中帶有刪除分支按鈕。
慶祝！
通過完成本教程，您已經(jīng)學會了創(chuàng)建一個項目并在GitHub上提出合并請求！
以下是您在本教程中完成的任務：
- 創(chuàng)建了一個開源庫
- 開始并管理一個新的分支
- 更改了一個文件并將這些更改提交給GitHub
- 打開并合并了一個合并請求。
2. 參考鏈接
Hello World
https://guides.github.com/activities/hello-world/
Understanding the GitHub Flow
https://guides.github.com/introduction/flow/
Forking Projects
https://guides.github.com/activities/forking/
