從0開始學習 GitHub 系列之「07.GitHub 常見的幾種操做」

以前寫了一個 GitHub 系列，反響很不錯，忽然發現居然還落下點東西沒寫，前段時間 GitHub 也改版了，藉此機會補充下。

咱們都說開源社區最大的魅力是人人多能夠參與進去，發揮衆人的力量，讓一個項目更完善，更強壯。那麼確定有人疑問，我本身目前尚未能力開源一個項目，可是想一塊兒參與到別的開源項目中，該怎麼操做呢？那麼今天，就來給你們一塊兒介紹下 GitHub 上的一些常見的操做，看完以後你就知道方法了。

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

打開連接：

https://github.com/square/retrofit

而後看到以下的項目主頁：

能夠看到一個項目能夠進行的操做主要就是兩部分，第一部分包括 Watch、Star、Fork ，這三個操做以前的系列介紹過了，這裏就不囉嗦了。

咱們着重來介紹第二部分，分別包括 Code、Issues、Pull requests、Projects、Wiki、Pulse、Graphs。接下來咱們來一個個解釋下。

• Code

這個好理解，就是你項目的代碼文件而已，這裏說明一下，每一個項目一般都會有對該項目的介紹，只須要在項目的根目錄裏添加一個 README.md 文件就能夠，使用 markdown 語法，GitHub 自動會對該文件進行渲染。

• Issues

Issues 表明該項目的一些問題或者 bug，並非說 Issues 越少越好，Issues 被解決的越多說明項目做者或者組織響應很積極，也說明該開源項目的做者很重視該項目。咱們來看下 Retrofit 的 Issues 主頁，截至目前 close（解決） 了 1305 個 Issue，open （待解決）狀態的有 37 個，這解決問題的比例與速度值得每位開源項目的做者學習。

一樣的，你們在使用一些開源項目有問題的時候均可以提 Issue，能夠經過點擊右上角的 New Issue 來新建 Issue，須要添加一個標題與描述就能夠了，這個操做很簡單。

• Pull requests

咱們都知道 GitHub 的最大魅力在於人人均可參與，好比別人開源一個項目，咱們每一個人均可以一塊兒參與開發，一塊兒來完善，而這都經過 Pull requests 來完成，簡稱 PR。這個無法在 Retrofit 演示，下面我就以我本身在 GitHub 上的一個項目 9GAG 來給你們詳細演示下怎麼給一個項目發起 PR：

提早說明下，你必須確保你能夠正常向 GitHub 提交代碼，若是不能夠的話，請看我以前的系列文章。

第一步登陸你的 GitHub 帳號，而後找到你想發起 PR 的項目，這裏以 9GAG 爲例，點擊右上角的 Fork 按鈕，而後該項目就出如今了你本身帳號的 Repository 裏。

請注意，這個項目本來是屬於 GitHub 帳號 stormzhang 下的，爲了演示，我本身又從新註冊了另外一個帳號叫 googdev 單純爲了演示而用。

Fork 以後，在帳號 googdev 下多了一個 9GAG 的項目，截圖顯示以下：

能夠看到 Fork 過來的項目標題底部會顯示一行小字：fork from stormzhang/9GAG ，除此以外，項目代碼跟原項目如出一轍，對於原項目來講，至關於別人新建了一個分支而已。

第二步，把該項目 clone 到本地，而後修改的 bug 也好，想要新增的功能也好，總之把本身作的代碼改動開發完，保存好。爲了方便演示，我這裏只在原項目的 README.md 文件添加了一行文字：Fork from stormzhang !

接着，把本身作的代碼改動 push 到 你本身的 GitHub 上去。

相信看過我前面教程的同窗這一步應該都會，不會的能夠滾回去看前面的教程了。

第三步，點擊你 Fork 過來的項目主頁的 Pull requests 頁面，

點擊 New pull request 按鈕緊接着到以下頁面：

這個頁面自動會比較該項目與原有項目的不一樣之處，最頂部聲明瞭是 stormzhang/9GAG 項目的 master 分支與你 fork 過來的 googdev/9GAG 項目 master 分支所作的比較。

而後最頂部能夠方便直觀的看到到底代碼中作了哪些改動，大家也看到我就是加了一句 Fork from stormzhang !

一樣的我寫好標題和描述，而後咱們點擊中間的 Create pull request 按鈕，至此咱們就成功給該項目提交了一個 PR。

而後就等着項目原做者 review 你的代碼，而且決定會不會接受你的 PR，若是接受，那麼恭喜你，你已是該項目的貢獻者之一了。

• Projects

這個是最新 GitHub 改版新增的一個項目，這個項目就是方便你把一些 Issues、Pull requests 進行分類，反正我以爲該功能很雞肋，起碼到目前爲止基本沒人用該功能，大家瞭解下就好。

• Wiki

通常來講，咱們項目的主頁有 README.me 基本就夠了，可是有些時候咱們項目的一些用法很複雜，須要有詳細的使用說明文檔給開源項目的使用者，這個時候就用到了 Wiki。

使用起來也很簡單，直接 New Page ，而後使用 markdown 語法便可進行編寫。

• Pulse

Pulse 能夠理解成該項目的活躍彙總。包括近期該倉庫建立了多少個 Pull Request 或 Issue，有多少人蔘與了這個倉庫的開發等，均可以在這裏一目瞭然。

根據這個頁面，用戶能夠判斷該項目受關注程度以及項目做者是否還在積極參與解決這些問題等。

• Graphs

Graphs 是以圖表的形式來展現該項目的一個總體狀況。好比項目的所有貢獻人，好比 commits 的圍度分析，好比某天代碼提交的頻繁程度等。

• Settings

若是一個項目是本身的，那麼你會發現會多一個菜單 Settings，這裏包括了你對整個項目的設置信息，好比對項目重命名，好比刪除該項目，好比關閉項目的 Wiki 和 Issues 功能等，不過大部分狀況下咱們都不須要對這些設置作更改。感興趣的，能夠自行看下這裏的設置有哪些功能。

以上就包含了一個 GitHub 項目的全部操做，相信你們看完以後對 GitHub 上一些經常使用的操做都熟悉了，從如今開始，請一塊兒參與到開源社區中來吧，開源社區須要咱們每一個人都貢獻一份力，這樣開源社區才能愈來愈強大，也才能對更多的人有幫助！