GitHub使用入門:Hello World

Github吉祥物 Octocat

簡介

GitHub是一個(gè)通過Git進(jìn)行版本控制的軟件源代碼托管服務(wù)雾鬼,由GitHub公司(曾稱Logical Awesome)的開發(fā)者Chris Wanstrath、PJ Hyett和Tom Preston-Werner使用Ruby on Rails編寫而成宴树。
GitHub同時(shí)提供付費(fèi)賬戶免費(fèi)賬戶策菜。這兩種賬戶都可以創(chuàng)建公開的代碼倉庫,但是付費(fèi)賬戶還可以創(chuàng)建私有的代碼倉庫森渐。根據(jù)在2009年的Git用戶調(diào)查做入,GitHub是最流行的Git訪問站點(diǎn).
除了允許個(gè)人和組織創(chuàng)建和訪問保管中的代碼以外,它也提供了一些方便社會(huì)化共同軟件開發(fā)的功能同衣,即一般人口中的社區(qū)功能竟块,包括允許用戶追蹤其他用戶、組織耐齐、軟件庫的動(dòng)態(tài)浪秘,對(duì)軟件代碼的改動(dòng)和bug提出評(píng)論等蒋情。GitHub也提供了圖表功能,用于概觀顯示開發(fā)者們?cè)鯓釉诖a庫上工作以及軟件的開發(fā)活躍程度耸携。
截止到2015年棵癣,GitHub已經(jīng)有超過九百萬注冊(cè)用戶和2110萬代碼庫。
事實(shí)上已經(jīng)成為了世界上最大的代碼存放網(wǎng)站和開源社區(qū)
更多:維基百科


開始使用GitHub

本文是我對(duì)于官方文檔:Hello World 的翻譯夺衍。


Hello World 項(xiàng)目是計(jì)算機(jī)編程中一個(gè)歷史悠久的傳統(tǒng)狈谊。 這是一個(gè)在你開始學(xué)習(xí)新東西時(shí)候的簡單練習(xí)。 讓我們開始使用GitHub吧沟沙!
您將學(xué)會(huì):

  • 創(chuàng)建和使用存儲(chǔ)庫(repository)河劝;
  • 啟動(dòng)和管理新分支(branch);
  • 對(duì)文件進(jìn)行更改并將其推送提交(commit)到GitHub 矛紫;
  • 打開并合并一個(gè)Pull請(qǐng)求赎瞎。

什么是GitHub?

GitHub是用于版本控制和協(xié)作的代碼托管平臺(tái)颊咬。 它可以讓你和其他人在任何地方協(xié)同工作同一個(gè)項(xiàng)目务甥。
本教程教你GitHub的要素,如倉庫(repositories)喳篇,分支(branches)敞临,提交(commits)Pull請(qǐng)求。 您將創(chuàng)建自己的Hello World 項(xiàng)目存儲(chǔ)庫杭隙,并學(xué)習(xí)GitHub的Pull Request工作流程哟绊,這是一種流行的創(chuàng)建和審查代碼的方法。

無需編碼

要完成本教程痰憎,您需要一個(gè)GitHub帳戶和可以連接的Internet網(wǎng)絡(luò)票髓。 您不需要知道如何編碼,使用命令行铣耘,或安裝Git(GitHub的版本控制軟件被建立于此)洽沟。

提示:在單獨(dú)的瀏覽器窗口(或選項(xiàng)卡)中打開此指南,以便在完成教程中的步驟時(shí)可以看到它蜗细。


步驟1.創(chuàng)建存儲(chǔ)庫(Repository)

存儲(chǔ)庫(repository)通常用于組織單個(gè)項(xiàng)目裆操。 存儲(chǔ)庫可以包含文件夾和文件,圖像炉媒,視頻踪区,電子表格和數(shù)據(jù)集 - 即項(xiàng)目需要的任何內(nèi)容。 我們建議您包括一個(gè)README文件吊骤,或包含有關(guān)您的項(xiàng)目信息的文件缎岗。 GitHub使得在創(chuàng)建新存儲(chǔ)庫的同時(shí)添加一個(gè)README文件很容易實(shí)現(xiàn)。 它還提供其他常見選項(xiàng)白粉,如許可證文件传泊。
你的 hello-world 存儲(chǔ)庫 可以是一個(gè)你存儲(chǔ)想法鼠渺,資源,甚至與他人分享和討論內(nèi)容的地方眷细。

創(chuàng)建新存儲(chǔ)庫(Repository)
  1. 在右上角拦盹,在您的頭像或識(shí)別碼旁邊,單擊 + 然后選擇“Create new...”溪椎。
  2. 命名您的存儲(chǔ)庫名稱為hello-world普舆。
  3. 寫一個(gè)簡短的描述(description)。
  4. 勾選 Initialize this repository with a README(使用README初始化此存儲(chǔ)庫校读。)
    [圖片上傳失敗...(image-7fa7f1-1513732778552)]
    點(diǎn)擊 Create repository(創(chuàng)建存儲(chǔ)庫)奔害。

步驟2.創(chuàng)建分支(Branch)

分支(Branching) 是同時(shí)在同一個(gè)存儲(chǔ)庫中創(chuàng)建不同版本的方式。
默認(rèn)情況下地熄,你的倉庫有一個(gè)名稱為master的分支,它被認(rèn)為是最終分支芯杀。 我們使用分支進(jìn)行實(shí)驗(yàn)和編輯端考,然后將分支提交到master
當(dāng)您在主master分支上創(chuàng)建分支時(shí)揭厚,您就創(chuàng)建了主master節(jié)點(diǎn)在該時(shí)間點(diǎn)的副本或快照却特。 如果有人在您在分支上工作時(shí)對(duì)主master分支進(jìn)行了更改拆讯,你就可以提取這些更新凌受。
此圖顯示:

  • 主分支 The master branch
  • 一個(gè)新的分支稱之為 映像(feature)(因?yàn)槲覀冊(cè)谶@個(gè)分支上做“映像工作”)
  • 在映像(feature)被合并到主 master分支上的旅程
    [圖片上傳失敗...(image-b704e5-1513732778552)]

你曾經(jīng)保存過一個(gè)文件的不同版本嗎? 就像是:

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

分支(Branch) 在GitHub存儲(chǔ)庫中實(shí)現(xiàn)類似的目標(biāo)纬黎。
在GitHub上太援,我們的開發(fā)人員闽晦,作家和設(shè)計(jì)師使用分支來保持錯(cuò)誤的修復(fù)和功能工作在獨(dú)立于我們的主(產(chǎn)品)分支上。 當(dāng)更改準(zhǔn)備就緒時(shí)提岔,它們將其分支合并到主master()節(jié)點(diǎn)上仙蛉。

創(chuàng)建一個(gè)新的分支
  1. 進(jìn)入您的新存儲(chǔ)庫hello-world
  2. 單擊文件列表頂部叫做 branch:master 的下拉列表碱蒙。
  3. 在新分支文本框中鍵入分支名稱readme-edits荠瘪。
  4. 選擇藍(lán)色的 Create branch 框或按鍵盤上的“Enter”。
    [圖片上傳失敗...(image-900a77-1513732778552)]
    現(xiàn)在你有兩個(gè)分支赛惩,masterreadme-edits哀墓。 他們看起來完全一樣,但不長久喷兼! 接下來篮绰,我們將把更改添加到新分支。

步驟3.制作并提交更改

哇哦褒搔! 現(xiàn)在阶牍,你在readme-edits分支的代碼視圖上喷面,這是master的副本。 讓我們做一些編輯走孽。
在GitHub上惧辈,保存的更改稱為提交(commit)。 每個(gè)提交都有一個(gè)相關(guān)的提交消息磕瓷,這是一個(gè)描述為什么進(jìn)行特定更改的描述盒齿。 提交消息會(huì)捕獲您更改的歷史記錄,因此其他參與者可以了解您的操作以及原因困食。

制作并提交更改
  1. 單擊README.md文件边翁。
  2. 在文件視圖的右上角單擊?鉛筆圖標(biāo)編輯。
  3. 在編輯器中硕盹,寫一點(diǎn)關(guān)于你自己的東西符匾。
  4. 編寫提交消息來描述您的更改的內(nèi)容。
  5. 單擊 Commit changes 提交更改按鈕瘩例。
    [圖片上傳失敗...(image-8c610f-1513732778552)]
    這些更改將只發(fā)生在readme-edits分支上的README文件啊胶,因此現(xiàn)在此分支包含的內(nèi)容與master不同。

步驟4.開啟拉取請(qǐng)求(Pull Request)

干得漂亮垛贤! 現(xiàn)在焰坪,您在master的分支中有更改,您可以開啟拉取請(qǐng)求了聘惦。
Pull Request 請(qǐng)求是GitHub協(xié)作的核心某饰。 當(dāng)您開啟拉取請(qǐng)求時(shí),您就會(huì)提出您的更改和請(qǐng)求善绎,并要求某人審核并提交您的貢獻(xiàn)黔漂,并將其合并到他們的分支中。 拉取請(qǐng)求會(huì)顯示來自兩個(gè)分支的內(nèi)容的差異或差異禀酱。 更改瘟仿,添加和減少以綠色和紅色顯示。
一旦提交(commit)以后比勉,您就可以開啟一個(gè)拉取請(qǐng)求(Pull Request)并劳较,在代碼完成之前展開討論。
通過在您的請(qǐng)求消息中使用GitHub的@提醒系統(tǒng)浩聋,您可以請(qǐng)求特定人員或團(tuán)隊(duì)的反饋观蜗,無論他們是在大廳還是在10個(gè)時(shí)區(qū)以外。
您甚至可以在您自己的存儲(chǔ)庫中開啟拉取請(qǐng)求并自行合并它們衣洁。 這是一個(gè)在更大的項(xiàng)目之前學(xué)習(xí)GitHub流的偉大的方式墓捻。

開啟一個(gè)對(duì)README的更改的Pull Requset

點(diǎn)擊圖片獲得更大的版本

步驟 截圖
單擊 Pull Requset 選項(xiàng)卡,然后在拉請(qǐng)求頁面,單擊綠色的 New pull request 按鈕砖第。 [圖片上傳失敗...(image-eae31e-1513732778552)]
選擇您所做的分支readme-edits撤卢,以與master(原始)進(jìn)行比較。 [圖片上傳失敗...(image-92ee70-1513732778552)]
查看比較頁面上的差異更改梧兼,確保它們是您要提交的內(nèi)容放吩。 [圖片上傳失敗...(image-72991b-1513732778552)]
當(dāng)您確定這些是您要提交的更改時(shí),單擊大的綠色“Create Pull Request”按鈕羽杰。 [圖片上傳失敗...(image-45bab3-1513732778552)]
給你的Pull Request寫一個(gè)標(biāo)題渡紫,并寫一個(gè)簡短的描述你的更改。 [圖片上傳失敗...(image-870051-1513732778552)]

當(dāng)你完成填寫以上信息后考赛,點(diǎn)擊 Create pull request惕澎。

提示:您可以使用表情符號(hào)并將圖片和GIF拖放到你的評(píng)論和拉取請(qǐng)求上。


步驟5.合并(merge)您的請(qǐng)求

在這最后一步颜骤,是時(shí)候把你的更改放在一起了 - 合并你的readme-edits分支到master分支唧喉。

  1. 單擊綠色Merge pull request按鈕將更改合并到master中。
    [圖片上傳失敗...(image-fc048d-1513732778552)]
  2. 單擊確認(rèn)合并(Confirm merge)忍抽。
  3. 繼續(xù)并刪除分支欣喧,因?yàn)樗母囊驯缓喜ⅲ瑒h除分支(Delete branch)按鈕在紫色框中梯找。
    [圖片上傳失敗...(image-9a4969-1513732778552)]

恭喜

通過完成本教程,您已經(jīng)學(xué)會(huì)了創(chuàng)建一個(gè)項(xiàng)目益涧,并在GitHub上發(fā)出pull request了


:tada:

:octocat:

:zap:

锈锤!

這里是你在本教程中完成的:

  1. 創(chuàng)建了一個(gè)開源庫
  2. 開始和管理一個(gè)新的分支
  3. 更改了一個(gè)文件并將這些更改提交給GitHub
  4. 開啟并合并一個(gè)Pull Request

看看你的GitHub個(gè)人資料,你會(huì)看到你的新貢獻(xiàn)方塊闲询!
如果您想了解有關(guān)Pull Request的更多功能久免,我們建議您閱讀GitHub Flow Guide。 您還可以訪問GitHub探索并參與開源項(xiàng)目.

提示:請(qǐng)參閱我們的其他指南和YouTube頻道扭弧,了解更多GitHub操作方法阎姥。


參考

遇到的問題

最后更新:20190105

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市鸽捻,隨后出現(xiàn)的幾起案子呼巴,更是在濱河造成了極大的恐慌,老刑警劉巖御蒲,帶你破解...
    沈念sama閱讀 206,723評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件衣赶,死亡現(xiàn)場離奇詭異,居然都是意外死亡厚满,警方通過查閱死者的電腦和手機(jī)府瞄,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,485評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來碘箍,“玉大人遵馆,你說我怎么就攤上這事鲸郊。” “怎么了货邓?”我有些...
    開封第一講書人閱讀 152,998評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵秆撮,是天一觀的道長。 經(jīng)常有香客問我逻恐,道長像吻,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,323評(píng)論 1 279
  • 正文 為了忘掉前任复隆,我火速辦了婚禮拨匆,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘挽拂。我一直安慰自己惭每,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,355評(píng)論 5 374
  • 文/花漫 我一把揭開白布亏栈。 她就那樣靜靜地躺著台腥,像睡著了一般。 火紅的嫁衣襯著肌膚如雪绒北。 梳的紋絲不亂的頭發(fā)上黎侈,一...
    開封第一講書人閱讀 49,079評(píng)論 1 285
  • 那天,我揣著相機(jī)與錄音闷游,去河邊找鬼峻汉。 笑死,一個(gè)胖子當(dāng)著我的面吹牛脐往,可吹牛的內(nèi)容都是我干的休吠。 我是一名探鬼主播,決...
    沈念sama閱讀 38,389評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼业簿,長吁一口氣:“原來是場噩夢(mèng)啊……” “哼瘤礁!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起梅尤,我...
    開封第一講書人閱讀 37,019評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤柜思,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后巷燥,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體酝蜒,經(jīng)...
    沈念sama閱讀 43,519評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,971評(píng)論 2 325
  • 正文 我和宋清朗相戀三年矾湃,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了亡脑。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,100評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖霉咨,靈堂內(nèi)的尸體忽然破棺而出蛙紫,到底是詐尸還是另有隱情,我是刑警寧澤途戒,帶...
    沈念sama閱讀 33,738評(píng)論 4 324
  • 正文 年R本政府宣布坑傅,位于F島的核電站,受9級(jí)特大地震影響喷斋,放射性物質(zhì)發(fā)生泄漏唁毒。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,293評(píng)論 3 307
  • 文/蒙蒙 一星爪、第九天 我趴在偏房一處隱蔽的房頂上張望浆西。 院中可真熱鬧,春花似錦顽腾、人聲如沸近零。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,289評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽久信。三九已至,卻和暖如春漓摩,著一層夾襖步出監(jiān)牢的瞬間裙士,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,517評(píng)論 1 262
  • 我被黑心中介騙來泰國打工管毙, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留腿椎,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,547評(píng)論 2 354
  • 正文 我出身青樓锅风,卻偏偏與公主長得像,于是被迫代替她去往敵國和親鞍泉。 傳聞我的和親對(duì)象是個(gè)殘疾皇子皱埠,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,834評(píng)論 2 345

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

  • 1.git的安裝 1.1 在Windows上安裝Git msysgit是Windows版的Git,從https:/...
    落魂灬閱讀 12,649評(píng)論 4 54
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理咖驮,服務(wù)發(fā)現(xiàn)边器,斷路器,智...
    卡卡羅2017閱讀 134,600評(píng)論 18 139
  • 前言:這個(gè)是官方教程,看完覺得寫的挺淺顯易懂的,于是翻譯一下給需要的人,本人才疏學(xué)淺,有翻譯的不到位的地方歡迎指正...
    道阻且長_行則將至閱讀 1,501評(píng)論 0 9
  • 閑人是無所事事托修、吃閑飯的人忘巧,估計(jì)大多數(shù)人都不喜歡這個(gè)標(biāo)簽。俗話說睦刃,人閑是非多砚嘴,想想還真是這么回事呢。如果你很忙,就...
    小考拉俱樂部閱讀 208評(píng)論 0 2
  • 當(dāng)我們都成為學(xué)霸 再不會(huì)有人報(bào)尲食ぃ科 誰還去新東方做廚子 誰肯跑藍(lán)翔成老司機(jī) 當(dāng)我們有了清明的政治 卻找不到慶功宴的...
    夢(mèng)斷桃源閱讀 152評(píng)論 0 1