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

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

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

　　我們姑且以 Square 公司開源的 Retrofit 為例來介紹。

　　打開鏈接：

　　https://github.com/square/retrofit

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

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

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

　　Code

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

　　Issues

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

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

　　Pull requests

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

　　提前說明下，你必須確保你可以正常向 GitHub 提交代碼，如果不可以的話，請看我之前的系列文章。

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

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

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

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

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

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

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

　　第三步，點(diǎn)擊你 Fork 過來的項(xiàng)目主頁的 Pull requests 頁面，

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

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

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

　　同樣的我寫好標(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)行分類，反正我覺得該功能很雞肋，起碼到目前為止基本沒人用該功能，你們了解下就好。

　　Wiki

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

　　使用起來也很簡單，直接 New Page ，然后使用 markdown 語法即可進(jìn)行編寫。

　　Pulse

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

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

　　Graphs

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

　　Settings

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

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