[我的翻譯]GitHub指導文件（GitHub Guides[Hello World]）

時間 2019-11-08

標籤我的翻譯 github 指導文件 guides hello world 欄目 Git 简体版

原文原文鏈接

[我的翻譯]GitHub指導文件（GitHub Guides[Hello World]）

Mirage_j我的翻譯，歡迎轉載，最好標明出處http://www.cnblogs.com/mirageJ/git

原文地址https://guides.github.com/activities/hello-world/github

2017-2-6更新：對影響閱讀的外鏈圖片換成本地上傳的縮放後的圖片，原圖地址在原文連接中。修改部分文字，非原文內容爲淺灰色。數據庫

Hello World是電腦編程史上悠久而又傳統的工程。學習新事物時咱們一般會以這個簡單的小程序做爲開始。咱們就以此爲開頭瞭解GitHub吧！編程

經過這篇指導，你會學到如何：小程序

創建並使用repository代碼庫
創建和管理branch代碼分支 （你能夠理解爲版本管理）
對文件進行修改並上傳到GitHub進行commits確認存檔
開始和融合一個pull request拉入請求（一種GitHub上的協同工做方式）

什麼是GitHub？

GitHub是一個爲版本管理和協同工做而生的代碼管理平臺。在這裏，你能夠和世界各地與你志同道合的人一塊兒實現或完成各類工程。ide

這篇指導將引導你學習GitHub的主要組成部分，包括：repository代碼庫、branch代碼分支、commits確認存檔和pull request拉入請求。Pull Request是GitHub上一種很是流行的用來構建和檢閱代碼的方法，讓咱們從創建你本身的Hello World代碼庫來開始學習Pull Request的工做流程吧。學習

不須要敲代碼

想要學習怎麼使用GitHub，你得先註冊一個GitHub帳號（固然你還得能上網）。你甚至不須要知道怎麼編程、怎麼使用命令行、或者安裝Git（一個創建GitHub的版本管理軟件）。ui

Tip：你最好用新標籤頁打開這個頁面，這樣你就能夠一邊學習一邊動手實踐了this

第一步：創建一個Repository

單個Repository常常用來管理單個工程。任何你的工程須要的東西——包括一堆文件夾、各類文件、圖片、視頻、表格和數據庫，均可以扔進Repository裏。咱們建議你的Repository裏能包含一份README說明文檔，或者一個寫着你工程信息的文件。創建新Repository時能夠很方便地加入README或者工程信息文件，以及別的常見選項如證書文件。spa

創建一個hello-world Repository吧，你能夠在裏面存放你的想法，各類資源，進行分享以及與他人進行討論。

創建一個新的Repository

GitHub頁面的右上角，你頭像或者帳號的下方，點+後選擇New repository
給你的Repository取名爲hello-world
隨便寫點描述
勾上Initialize this repository with a README （帶上說明文件來初始化你的Repository）.

點擊Creat repository,搞定！

第二步:創建一個Branch

Branching代碼分支是一種對同一Repository的不一樣版本同時工做的方法。 Repository默認自帶一個叫 master 的Branch，這個Branch是做爲你工程的最終版本而存在的（或者正式版本）。咱們利用多個Branch對工程進行調試和編輯，直到你把它確認到 master 。

當你在 master branch的下面創建一個新的branch時，你就等於複製了一個master branch，或者說是作了master在這個時間節點的快照。若是在你在本身的branch上工做的時候，有別人對master進行了修改，你能夠將那些修改直接加進來。

下面這個圖表展示了：

master branch
一個叫feature的branch（由於咱們一般都在這個branch上面作「feature work（實現功能）」的工做）
feature在融合進master以前通過的旅程

你有沒有保存過一個文件的不一樣版本？像這種：

一個故事.txt
一個故事（老李修訂版）.txt
一個故事（老李修訂版-已審覈）.txt

Branch作的事情和上面的差很少，不過它是在Repository裏面作的而已

在GitHub裏面，開發者、寫手、設計師用branch來爲 master 修復bug和增長功能。當一個修改能夠確認完成了，咱們就把這些branch把融入到 master 裏去

創建一個新branch

進入你的 hello-world Repository
點擊下拉菜單，就在文件列表的上方，寫着 branch:maser 那裏
把要新建的branch的名字，如 readme-edits ，輸到文本框裏
按藍色的 Create branch 或者按回車

如今你就有兩個branch： master 和readme-edits 了，如今它們還徹底同樣，可是不會持續好久。接下來咱們對新的branch作點修改

第三步：提出並確認修改

很好！如今你看到的是readme-edits的代碼管理頁，這個徹底是複製 master的，讓咱們來對它進行點改動

在GitHub上，確認修改被稱做 commits確認 。每一個commit都帶着一個確認消息，這條確認消息告訴你們爲何會進行這個修改，或者這個修改的具體描述。確認消息跟修着修改的歷史記錄，這樣別的合做者就會知道你作了些什麼以及你爲何這樣作。

提出並確認修改

點擊README.md文件
點擊鉛筆圖標，它在編輯頁面的右上角
在編輯欄裏寫些什麼，能夠是些關於你本身的話
寫下確認消息來描述你作的修改
點擊 Commit changes 按鈕

這些你作的修改都會在 readme-edits branch上保存，如今 readme-edits 就和 master 不同了

第四部：開啓一個Pull Request

幹得好！你已經在 master 下作了修改了，如今你能夠開啓一個Pull Request了

Pull Request是GitHub協同工做的核心。當你開啓一個Pull Request，你就是提出你作的修改並告訴別人：「來看看我作了什麼修改吧，而後將我作的這些貢獻拉到大家的branch裏去。」Pull Request展現了雙方branch裏的不一樣。這些修改、增長與刪減會以綠色和紅色進行區分

當你完成commit的同時，你能夠開啓一個Pull Request而後開始進行討論，這甚至能夠在代碼完成以前就進行

你能夠在你的pull request消息裏使用GitHub’s @mention system，經過它向特定的人或者團隊請求反饋，無論這些人就住在你樓下或者如今處在地球的另外一邊

你如今就能夠在你本身的Repository裏開啓你的pull request而且本身把它們融合到你的Repository裏，這是一種在很好的學習方法，能夠幫助你提早了解GitHub裏參與大型工程的流程。

爲README的修改開啓一個Pull Request

點擊Pull Request便籤頁，在打開的頁面裏點擊綠色的New pull request按鈕
選擇你剛剛生成的readme-editsbranch來和原始的master進行比較
在這個對比頁面裏，你能夠看到兩個branch有什麼不一樣，確保這些改動是你想確認保存的
若是以爲這些改動能夠提交了，點擊那個巨大的綠色按鈕 Create Pull Request
給你的pull request取個名字吧！你還能夠在下方的文本框裏寫點什麼（例如描述一下你作了什麼改動）

當你搞定這些東西以後，按Create pull request!

Tip:你還能夠把emoji表情和圖片拉到說明和Pull Request上

第五步：融合你的Pull Request

終於到最後一步了，是時候把你作的改動都放在一塊兒了——將你的 readme-edits branch融入到 master branch裏去

點擊那個綠色的Merge pull request來把你作的改動融合到 master 裏去
點擊Confirm merge
讓咱們深刻一點，學會怎麼刪除branch。既然這些改動已經被包含到 master 了，那咱們就能夠按紫色方框裏的Delete branch按鈕刪除掉以前的 readme-edits 了