Github的基本操作介紹--Hello World(翻譯)

原諒我的無知,這會(huì)兒又搞了個(gè)Hello World。

原文地址

簡介

在計(jì)算機(jī)編程時(shí)創(chuàng)建一個(gè)Hello World工程已經(jīng)是慣例了。它可以讓我們在學(xué)習(xí)一些新東西時(shí)做一些簡單的練習(xí)。開始吧。

在這片文章中將會(huì)學(xué)到:

  • 創(chuàng)建并使用版本庫
  • 創(chuàng)建并管理一個(gè)新的分支
  • 對一個(gè)文件做一些改動(dòng)并使用 commits 將這些變化提交到Github上
  • 如何打開并合并一個(gè) pull request

Github是什么?

Github是一個(gè)為版本控制和合作開發(fā)提供的一個(gè)代碼管理平臺(tái)。它可以讓我們和來自各地的人合作開發(fā)同一項(xiàng)目。

這篇教程將會(huì)告訴我們Github的一些概念,比如 repositoriesbranchescommits、pull requests等。你可以創(chuàng)建一個(gè)版本庫,在這兒取名就叫Hello World,并且學(xué)習(xí)一種創(chuàng)建和檢查代碼的方式,pull request 工作流。

無需寫代碼

為了能夠完成這個(gè)教程,你需要有一個(gè)Github賬號(hào)網(wǎng)址在這并且能夠連接互聯(lián)網(wǎng)。你暫時(shí)不需要知道如何寫代碼,使用命令行,或者安裝Git。

Step1 創(chuàng)建一個(gè)版本庫

一個(gè)版本庫通常用來組織管理一個(gè)單獨(dú)的項(xiàng)目。版本庫可以包含你工程中所需要的所有類型的文件,比如 文件夾和文件,圖像,視頻,電子表格和數(shù)據(jù)集合等。我們推薦包含一個(gè)ReadMe文件,或者一個(gè)能夠說明項(xiàng)目信息的文件。當(dāng)創(chuàng)建一個(gè)新的版本庫時(shí),使用Github添加一個(gè)這樣的文件是很簡單的。并且他還提供一個(gè)像許可文件這樣的自定義選項(xiàng)。
你的 hello-world版本庫可以用來作為你保存想法、資源甚至是和別人分享討論問題的平臺(tái)。

創(chuàng)建新的版本庫

1、在右上角,你名稱的的旁邊,點(diǎn)擊+號(hào)并點(diǎn)擊 New Repository
2、將你的版本庫命名為 hello-world
3、寫一個(gè)簡短的描述
4、選中 Initialize this repository with a README

create-new-repo

Setp2創(chuàng)建一個(gè)分支

分支是實(shí)現(xiàn)同一個(gè)版本庫中同一個(gè)時(shí)間可以工作在不同版本的一種方式。
你的repository在默認(rèn)狀況下是有一個(gè)名叫master的分支的,它本認(rèn)識(shí)版本庫的最終確定的版本。我們可以創(chuàng)建一些分支,并且在提交到master之前編輯他們并測試一些東西。

創(chuàng)建一個(gè)脫離master的分支,就是給當(dāng)前狀態(tài)的master創(chuàng)建一個(gè)拷貝,或稱為快照。當(dāng)你在你的分支上工作時(shí),如果有人對master進(jìn)行了改變,你可以將這些改變更新下來。
下面的圖展現(xiàn)了:

  • master分支
  • 一個(gè)叫做 feature的分支(因?yàn)槲覀儗⒁谶@個(gè)分支上做一些‘feature work’)
  • feature 合并到master中之前所做的操作

你為一個(gè)文件的不同版本保存過類似下面這樣的文件?

  • story.txt
  • story-joe-edit.txt
  • story-joe-edit-reviewed.txt

在Github的版本庫中所有的分支都完成了類似的功能。

在Github中,我們的開發(fā)者,文案還有設(shè)計(jì)者使用與master相對獨(dú)立的分支來修復(fù)bug和添加新的功能。當(dāng)一個(gè)改變完成,將可以將其和master進(jìn)行合并。

創(chuàng)建一個(gè)新的分支

1、進(jìn)入剛創(chuàng)建的版本庫 hello-world
2、點(diǎn)擊文件列表上方的叫做branch: master的下拉按鈕
3、輸入分支的名字,這里叫做 readme-edits
4、選擇藍(lán)色的選擇框Create branch,點(diǎn)擊回車

這樣,我們的項(xiàng)目中就出現(xiàn)了兩個(gè)分支,masterreadme-edits。這會(huì)兒他們看起來是一樣的。下面我們將要對我們新建的分支做出一些改變。

Step3 改變文檔并提交這些改變

好的,現(xiàn)在,我們已經(jīng)在master的拷貝分支的代碼頁了。讓我們對其做一些編輯。

在Github中,保存改變叫做 commits。每一次的commit都有一個(gè)相關(guān)的 commit message,它用來對所做的改變做出一個(gè)詳盡的描述。Commit message記錄了你所有的改變歷史,這樣可以讓其他的貢獻(xiàn)者知道你對工程做出什么樣的改變以及為什么要做出這樣的改變。

編輯文件并將改變提交

1、點(diǎn)擊選中文件 README.md
2、點(diǎn)擊文件視圖右上角的鉛筆樣式的按鈕來編輯
3、在編輯框內(nèi),寫入一些自己想要寫入的內(nèi)容
4、寫commit message來描述你的改變
5、點(diǎn)擊 Commit change按鈕

這些改變僅僅只是發(fā)生在readme-edits分支的 README文件中,所以現(xiàn)在這個(gè)分支中包含的內(nèi)容是和master中的內(nèi)容是有區(qū)別的。

Step4、打開一個(gè)Pull Request

現(xiàn)在你的分支已經(jīng)和master有一些改變了,你可以打開一個(gè)Pull Request。

Pull Request 是Github上合作模式的核心部分。當(dāng)你打開一個(gè) Pull Request時(shí),你該確認(rèn)你的改變并且需要有人幫你復(fù)查,之后將你的改變合并到他們的分支里。Pull Request將會(huì)展示兩個(gè)分支之間內(nèi)容的不同之處。這些改變和添加或者減少都會(huì)以綠色或紅色展現(xiàn)出來。

只要你commit一次,你就可以打開一個(gè)Pull request并且展開比較討論,即使這時(shí)候你的代碼尚未完成。

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并且將他們與你自己的合并,在你參加大型項(xiàng)目之前這將是你學(xué)習(xí)Github工作流的一個(gè)好方式。

為README的改變創(chuàng)建一個(gè)pull request

步驟 截圖
選擇Pull Request選項(xiàng),在該頁點(diǎn)擊綠色的 New pull request按鈕
選擇你剛創(chuàng)建的分支readme-edits,和原始的分支master進(jìn)行比較
查看在比較頁面上你改變的所有不同處,確保提交的都是所需要的
如果你確保這些改變都是你確實(shí)需要提交的,點(diǎn)擊這個(gè)大的綠色按鈕Create Pull Request
給你的pull request 起一個(gè)標(biāo)題,并給你所做的改變寫一個(gè)簡潔的說明

當(dāng)你所有的信息都填寫好,點(diǎn)擊Create pull request吧。

Step5、合并你的 Pull Request

在最后一步,是時(shí)候?qū)⒛愕男薷暮喜⒌揭黄鹆耍褪菍?em>readme-edits分支合并到master中去。
1、點(diǎn)擊綠色按鈕Merge pull request將修改合并到master中去。
2、點(diǎn)擊按鈕 Confirm merge
3、繼續(xù)操作所有修改就會(huì)被合并,點(diǎn)擊紫色框內(nèi)的**Delete branch **按鈕將會(huì)刪除這個(gè)分支


End

愿:你我都好。。。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容