GitHub使用學習筆記

一、創建一個存儲庫

存儲庫通常用於組織單個項目。 存儲庫可以包含文件夾和文件,圖像,視頻,電子表格和數據集 - 您的項目需要的任何東西。 我們建議包括一個自述文件或包含關於您項目信息的文件。 GitHub可以在創建新存儲庫的同時輕鬆添加一個。 它還提供其他常見選項,如許可證文件。

你的hello-world知識庫可以是你存儲想法,資源甚至與他人分享和討論事物的地方。

創建一個新的存儲庫

1、 在右上角,在你的頭像或身份證旁邊,點擊+然後選擇New respository;

2、命名你的存儲庫:hello-world;

3、寫一個簡短的描述;

4、選擇 Initialize this respository with a README;

5、點擊Create repository


二、創建一個分支(Branch)

分支是一次處理不同版本的存儲庫的方式。

默認情況下,你的倉庫有一個名爲master的分支,它被認爲是最終分支。 我們使用分支在將它們提交給master之前進行實驗和編輯。

當您從主分支創建分支時,您正在製作主分支的副本或快照,就像它在那個時間點一樣。 如果其他人在您的分支上工作時對主分支進行了更改,則可以引入這些更新。

如圖顯示:
     a、主分支
     b、一個叫做feature的新分支(因爲我們正在這個分支上做'特色工作')

     c、該功能在合併到主分支之前所經歷的歷程


你有沒有保存過不同版本的文件? 就像是:

story.txt

story-joe-edit.txt

story-joe-edit-reviewed.txt

分支機構在GitHub存儲庫中實現類似的目標。

在GitHub上,我們的開發人員,作者和設計人員使用分支來將錯誤修復和功能工作與我們的主(生產)分支分開。 當一個變化準備就緒後,他們將他們的分支合併爲主分支。

創建一個新的分支:

1、轉到您的新存儲庫hello-world。

2、 單擊文件列表頂部的下拉列表中的分支:master。

3、在新的分支文本框中輸入分支名稱readme-edits。

4、 選擇藍色的創建分支框或點擊鍵盤上的“Enter”。


現在你有兩個分支,master and readme-edits。 它們看起來完全一樣,但時間不長! 接下來,我們會將我們的更改添加到新分支。

三、進行並提交更改

現在,您正在使用readme-edits分支的代碼視圖,該分支是主副本。 我們來做一些編輯。

在GitHub上,保存的更改稱爲提交。 每個提交都有一個關聯的提交消息,它是解釋爲什麼進行特定更改的說明。 提交消息捕獲您所做更改的歷史記錄,所以其他貢獻者可以瞭解您所做的工作以及原因。

進行並提交更改:

1、點擊README.md文件。

2、點擊鉛筆圖標在文件視圖的右上角進行編輯。

3、在編輯器中,寫一些關於你自己的信息。

4、編寫描述您的更改的提交消息。

5、單機commit changes 按鈕。


這些更改將僅針對readme-edits分支上的README文件進行,因此,此分支包含的內容與主分支不同。

四、打開合併請求

現在您的分支已經發生變化,您可以打開一個拉取請求。

合併請求是GitHub協作的核心。 當你打開一個拉取請求時,你正在提出你的改變,並要求有人審查並提交你的貢獻,並將它們合併到他們的分支中。 拉取請求顯示來自兩個分支的內容的差異或不同。 更改,添加和減法以綠色和紅色顯示。

一旦你提交了,你甚至可以在代碼完成之前打開一個pull請求並開始討論。

通過在您的拉取請求消息中使用GitHub的@mention系統,您可以要求特定人員或團隊提供反饋,無論他們是否在大廳或10個時區以外。

你甚至可以在你自己的倉庫中打開pull請求並自己合併它們。 在開展大型項目之前,學習GitHub流程是一種很好的方式。

打開合併請求以更改README文件:

1、點擊Pull Request標籤,然後從合併請求頁面點擊綠色的New pull request按鈕。


2、Example Comparisons框中,選擇您創建的分支,readme-edits,以與master(原始)進行比較。



3、查看比較頁面上差異的更改,確保它們是您想要提交的內容。

4、如果您滿意這些是您要提交的更改,請點擊綠色的Create Pull Request按鈕。


5、給你的拉取請求一個標題,並寫一個你的改變的簡要說明。

完成消息後,請點擊Create pull request!

提示:您可以使用表情符號並將圖像和gif拖放到註釋和合並請求上。


五、合併您的請求

在這最後一步中,是時候把你的修改結合在一起了 - 將你的readme-edits分支合併到master分支中。

1、點擊綠色Merge pull request按鈕,將更改合併到master中。

2、點擊Confirm merge.

3、繼續操作,刪除分支,因爲它的更改已經合併。用紫色框中的Delete branch按鈕。



恭喜!

通過完成本教程,您已經學會了創建一個項目並在GitHub上提出拉取請求!

以下是您在本教程中完成的任務:
     創建了一個開源庫
     開始並管理一個新的分支
     更改了一個文件並將這些更改提交給GitHub

     打開併合並拉取請求

看看你的GitHub配置文件,你會看到你的新貢獻廣場(contribution squares)!

要詳細瞭解Pull Request的功能,我們推薦閱讀GitHub Flow Guide.(流程指南)。 您也可以訪問GitHub Explore並參與開源項目


提示:查看我們的其他指南,YouTube頻道和點播培訓,瞭解更多關於如何開始使用GitHub的信息。


參考:https://guides.github.com/activities/hello-world/

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章