從0開(kāi)始學(xué)習(xí) GitHub 系列之「07.GitHub 常見(jiàn)的幾種操作」

　　之前寫(xiě)了一個(gè) GitHub 系列，反響很不錯(cuò)，突然發(fā)現(xiàn)竟然還落下點(diǎn)東西沒(méi)寫(xiě)，前段時(shí)間 GitHub 也改版了，借此機(jī)會(huì)補(bǔ)充下。

　　我們都說(shuō)開(kāi)源社區(qū)最大的魅力是人人多可以參與進(jìn)去，發(fā)揮眾人的力量，讓一個(gè)項(xiàng)目更完善，更強(qiáng)壯。那么肯定有人疑問(wèn)，我自己目前還沒(méi)有能力開(kāi)源一個(gè)項(xiàng)目，但是想一起參與到別的開(kāi)源項(xiàng)目中，該怎么操作呢?那么今天，就來(lái)給大家一起介紹下 GitHub 上的一些常見(jiàn)的操作，看完之后你就知道方法了。

　　我們姑且以 Square 公司開(kāi)源的 Retrofit 為例來(lái)介紹。

　　打開(kāi)鏈接：

　　https://github.com/square/retrofit

　　然后看到如下的項(xiàng)目主頁(yè)：

　　可以看到一個(gè)項(xiàng)目可以進(jìn)行的操作主要就是兩部分，第一部分包括 Watch、Star、Fork ，這三個(gè)操作之前的系列介紹過(guò)了，這里就不啰嗦了。

　　我們著重來(lái)介紹第二部分，分別包括 Code、Issues、Pull requests、Projects、Wiki、Pulse、Graphs。接下來(lái)我們來(lái)一個(gè)個(gè)解釋下。

　　Code

　　這個(gè)好理解，就是你項(xiàng)目的代碼文件而已，這里說(shuō)明一下，每個(gè)項(xiàng)目通常都會(huì)有對(duì)該項(xiàng)目的介紹，只需要在項(xiàng)目的根目錄里添加一個(gè) README.md 文件就可以，使用 markdown 語(yǔ)法，GitHub 自動(dòng)會(huì)對(duì)該文件進(jìn)行渲染。

　　Issues

　　Issues 代表該項(xiàng)目的一些問(wèn)題或者 bug，并不是說(shuō) Issues 越少越好，Issues 被解決的越多說(shuō)明項(xiàng)目作者或者組織響應(yīng)很積極，也說(shuō)明該開(kāi)源項(xiàng)目的作者很重視該項(xiàng)目。我們來(lái)看下 Retrofit 的 Issues 主頁(yè)，截至目前 close(解決) 了 1305 個(gè) Issue，open (待解決)狀態(tài)的有 37 個(gè)，這解決問(wèn)題的比例與速度值得每位開(kāi)源項(xiàng)目的作者學(xué)習(xí)。

　　同樣的，大家在使用一些開(kāi)源項(xiàng)目有問(wèn)題的時(shí)候都可以提 Issue，可以通過(guò)點(diǎn)擊右上角的 New Issue 來(lái)新建 Issue，需要添加一個(gè)標(biāo)題與描述就可以了，這個(gè)操作很簡(jiǎn)單。

　　Pull requests

　　我們都知道 GitHub 的最大魅力在于人人都可參與，比如別人開(kāi)源一個(gè)項(xiàng)目，我們每個(gè)人都可以一起參與開(kāi)發(fā)，一起來(lái)完善，而這都通過(guò) Pull requests 來(lái)完成，簡(jiǎn)稱(chēng) PR。這個(gè)沒(méi)法在 Retrofit 演示，下面我就以我自己在 GitHub 上的一個(gè)項(xiàng)目 9GAG 來(lái)給大家詳細(xì)演示下怎么給一個(gè)項(xiàng)目發(fā)起 PR：

　　提前說(shuō)明下，你必須確保你可以正常向 GitHub 提交代碼，如果不可以的話(huà)，請(qǐng)看我之前的系列文章。

　　第一步登錄你的 GitHub 賬號(hào)，然后找到你想發(fā)起 PR 的項(xiàng)目，這里以 9GAG 為例，點(diǎn)擊右上角的 Fork 按鈕，然后該項(xiàng)目就出現(xiàn)在了你自己賬號(hào)的 Repository 里。

　　請(qǐng)注意，這個(gè)項(xiàng)目原本是屬于 GitHub 賬號(hào) stormzhang 下的，為了演示，我自己又重新注冊(cè)了另一個(gè)賬號(hào)叫 googdev 單純?yōu)榱搜菔径谩?/p>

　　Fork 之后，在賬號(hào) googdev 下多了一個(gè) 9GAG 的項(xiàng)目，截圖顯示如下：

　　可以看到 Fork 過(guò)來(lái)的項(xiàng)目標(biāo)題底部會(huì)顯示一行小字：fork from stormzhang/9GAG ，除此之外，項(xiàng)目代碼跟原項(xiàng)目一模一樣，對(duì)于原項(xiàng)目來(lái)說(shuō)，相當(dāng)于別人新建了一個(gè)分支而已。

　　第二步，把該項(xiàng)目 clone 到本地，然后修改的 bug 也好，想要新增的功能也好，總之把自己做的代碼改動(dòng)開(kāi)發(fā)完，保存好。為了方便演示，我這里只在原項(xiàng)目的 README.md 文件添加了一行文字：Fork from stormzhang !

　　接著，把自己做的代碼改動(dòng) push 到 你自己的 GitHub 上去。

　　相信看過(guò)我前面教程的同學(xué)這一步應(yīng)該都會(huì)，不會(huì)的可以滾回去看前面的教程了。

　　第三步，點(diǎn)擊你 Fork 過(guò)來(lái)的項(xiàng)目主頁(yè)的 Pull requests 頁(yè)面，

　　點(diǎn)擊 New pull request 按鈕緊接著到如下頁(yè)面：

　　這個(gè)頁(yè)面自動(dòng)會(huì)比較該項(xiàng)目與原有項(xiàng)目的不同之處，最頂部聲明了是 stormzhang/9GAG 項(xiàng)目的 master 分支與你 fork 過(guò)來(lái)的 googdev/9GAG 項(xiàng)目 master 分支所做的比較。

　　然后最頂部可以方便直觀的看到到底代碼中做了哪些改動(dòng)，你們也看到我就是加了一句 Fork from stormzhang !

　　同樣的我寫(xiě)好標(biāo)題和描述，然后我們點(diǎn)擊中間的 Create pull request 按鈕，至此我們就成功給該項(xiàng)目提交了一個(gè) PR。

　　然后就等著項(xiàng)目原作者 review 你的代碼，并且決定會(huì)不會(huì)接受你的 PR，如果接受，那么恭喜你，你已經(jīng)是該項(xiàng)目的貢獻(xiàn)者之一了。

　　Projects

　　這個(gè)是最新 GitHub 改版新增的一個(gè)項(xiàng)目，這個(gè)項(xiàng)目就是方便你把一些 Issues、Pull requests 進(jìn)行分類(lèi)，反正我覺(jué)得該功能很雞肋，起碼到目前為止基本沒(méi)人用該功能，你們了解下就好。

　　Wiki

　　一般來(lái)說(shuō)，我們項(xiàng)目的主頁(yè)有 README.me 基本就夠了，但是有些時(shí)候我們項(xiàng)目的一些用法很復(fù)雜，需要有詳細(xì)的使用說(shuō)明文檔給開(kāi)源項(xiàng)目的使用者，這個(gè)時(shí)候就用到了 Wiki。

　　使用起來(lái)也很簡(jiǎn)單，直接 New Page ，然后使用 markdown 語(yǔ)法即可進(jìn)行編寫(xiě)。

　　Pulse

　　Pulse 可以理解成該項(xiàng)目的活躍匯總。包括近期該倉(cāng)庫(kù)創(chuàng)建了多少個(gè) Pull Request 或 Issue，有多少人參與了這個(gè)倉(cāng)庫(kù)的開(kāi)發(fā)等，都可以在這里一目了然。

　　根據(jù)這個(gè)頁(yè)面，用戶(hù)可以判斷該項(xiàng)目受關(guān)注程度以及項(xiàng)目作者是否還在積極參與解決這些問(wèn)題等。

　　Graphs

　　Graphs 是以圖表的形式來(lái)展示該項(xiàng)目的一個(gè)整體情況。比如項(xiàng)目的全部貢獻(xiàn)人，比如 commits 的圍度分析，比如某天代碼提交的頻繁程度等。

　　Settings

　　如果一個(gè)項(xiàng)目是自己的，那么你會(huì)發(fā)現(xiàn)會(huì)多一個(gè)菜單 Settings，這里包括了你對(duì)整個(gè)項(xiàng)目的設(shè)置信息，比如對(duì)項(xiàng)目重命名，比如刪除該項(xiàng)目，比如關(guān)閉項(xiàng)目的 Wiki 和 Issues 功能等，不過(guò)大部分情況下我們都不需要對(duì)這些設(shè)置做更改。感興趣的，可以自行看下這里的設(shè)置有哪些功能。

　　以上就包含了一個(gè) GitHub 項(xiàng)目的所有操作，相信大家看完之后對(duì) GitHub 上一些常用的操作都熟悉了，從現(xiàn)在開(kāi)始，請(qǐng)一起參與到開(kāi)源社區(qū)中來(lái)吧，開(kāi)源社區(qū)需要我們每個(gè)人都貢獻(xiàn)一份力，這樣開(kāi)源社區(qū)才能越來(lái)越強(qiáng)大，也才能對(duì)更多的人有幫助!