原諒我的無知,這會兒又搞了個Hello World。
簡介
在計算機編程時創建一個Hello World工程已經是慣例了。它可以讓我們在學習一些新東西時做一些簡單的練習。開始吧。
在這片文章中將會學到:
- 創建并使用版本庫
- 創建并管理一個新的分支
- 對一個文件做一些改動并使用 commits 將這些變化提交到Github上
- 如何打開并合并一個 pull request
Github是什么?
Github是一個為版本控制和合作開發提供的一個代碼管理平臺。它可以讓我們和來自各地的人合作開發同一項目。
這篇教程將會告訴我們Github的一些概念,比如 repositories、branches、commits、pull requests等。你可以創建一個版本庫,在這兒取名就叫Hello World,并且學習一種創建和檢查代碼的方式,pull request 工作流。
無需寫代碼
為了能夠完成這個教程,你需要有一個Github賬號網址在這并且能夠連接互聯網。你暫時不需要知道如何寫代碼,使用命令行,或者安裝Git。
Step1 創建一個版本庫
一個版本庫通常用來組織管理一個單獨的項目。版本庫可以包含你工程中所需要的所有類型的文件,比如 文件夾和文件,圖像,視頻,電子表格和數據集合等。我們推薦包含一個ReadMe文件,或者一個能夠說明項目信息的文件。當創建一個新的版本庫時,使用Github添加一個這樣的文件是很簡單的。并且他還提供一個像許可文件這樣的自定義選項。
你的 hello-world版本庫可以用來作為你保存想法、資源甚至是和別人分享討論問題的平臺。
創建新的版本庫
1、在右上角,你名稱的的旁邊,點擊+號并點擊 New Repository
2、將你的版本庫命名為 hello-world
3、寫一個簡短的描述
4、選中 Initialize this repository with a README
Setp2創建一個分支
分支是實現同一個版本庫中同一個時間可以工作在不同版本的一種方式。
你的repository在默認狀況下是有一個名叫master的分支的,它本認識版本庫的最終確定的版本。我們可以創建一些分支,并且在提交到master之前編輯他們并測試一些東西。
創建一個脫離master的分支,就是給當前狀態的master創建一個拷貝,或稱為快照。當你在你的分支上工作時,如果有人對master進行了改變,你可以將這些改變更新下來。
下面的圖展現了:
- master分支
- 一個叫做 feature的分支(因為我們將要在這個分支上做一些‘feature work’)
- feature 合并到master中之前所做的操作
你為一個文件的不同版本保存過類似下面這樣的文件?
- story.txt
- story-joe-edit.txt
- story-joe-edit-reviewed.txt
在Github的版本庫中所有的分支都完成了類似的功能。
在Github中,我們的開發者,文案還有設計者使用與master相對獨立的分支來修復bug和添加新的功能。當一個改變完成,將可以將其和master進行合并。
創建一個新的分支
1、進入剛創建的版本庫 hello-world中
2、點擊文件列表上方的叫做branch: master的下拉按鈕
3、輸入分支的名字,這里叫做 readme-edits
4、選擇藍色的選擇框Create branch,點擊回車
這樣,我們的項目中就出現了兩個分支,master和readme-edits。這會兒他們看起來是一樣的。下面我們將要對我們新建的分支做出一些改變。
Step3 改變文檔并提交這些改變
好的,現在,我們已經在master的拷貝分支的代碼頁了。讓我們對其做一些編輯。
在Github中,保存改變叫做 commits。每一次的commit都有一個相關的 commit message,它用來對所做的改變做出一個詳盡的描述。Commit message記錄了你所有的改變歷史,這樣可以讓其他的貢獻者知道你對工程做出什么樣的改變以及為什么要做出這樣的改變。
編輯文件并將改變提交
1、點擊選中文件 README.md
2、點擊文件視圖右上角的鉛筆樣式的按鈕來編輯
3、在編輯框內,寫入一些自己想要寫入的內容
4、寫commit message來描述你的改變
5、點擊 Commit change按鈕
這些改變僅僅只是發生在readme-edits分支的 README文件中,所以現在這個分支中包含的內容是和master中的內容是有區別的。
Step4、打開一個Pull Request
現在你的分支已經和master有一些改變了,你可以打開一個Pull Request。
Pull Request 是Github上合作模式的核心部分。當你打開一個 Pull Request時,你該確認你的改變并且需要有人幫你復查,之后將你的改變合并到他們的分支里。Pull Request將會展示兩個分支之間內容的不同之處。這些改變和添加或者減少都會以綠色或紅色展現出來。
只要你commit一次,你就可以打開一個Pull request并且展開比較討論,即使這時候你的代碼尚未完成。
By using GitHub’s @mention system in your pull request message, you can ask for feedback from specific people or teams, whether they’re down the hall or 10 time zones away.(沒看太懂)
你也可以在你自己的版本庫中打開 pull request并且將他們與你自己的合并,在你參加大型項目之前這將是你學習Github工作流的一個好方式。
為README的改變創建一個pull request
步驟 | 截圖 |
---|---|
選擇Pull Request選項,在該頁點擊綠色的 New pull request按鈕 | |
選擇你剛創建的分支readme-edits,和原始的分支master進行比較 | |
查看在比較頁面上你改變的所有不同處,確保提交的都是所需要的 | |
如果你確保這些改變都是你確實需要提交的,點擊這個大的綠色按鈕Create Pull Request | |
給你的pull request 起一個標題,并給你所做的改變寫一個簡潔的說明 |
當你所有的信息都填寫好,點擊Create pull request吧。
Step5、合并你的 Pull Request
在最后一步,是時候將你的修改合并到一起了,就是將readme-edits分支合并到master中去。
1、點擊綠色按鈕Merge pull request將修改合并到master中去。
2、點擊按鈕 Confirm merge
3、繼續操作所有修改就會被合并,點擊紫色框內的**Delete branch **按鈕將會刪除這個分支
End
愿:你我都好。。。