# Git基本知識與Github使用
[TOC=2,3]
## Git
從一般開發者的角度來看，git有以下功能：
1. 從服務器上克隆數據庫（包括代碼和版本信息）到單機上。
1. 在自己的機器上創建分支，修改代碼。
1. 在單機上自己創建的分支上提交代碼。
1. 在單機上合并分支。
1. 新建一個分支，把服務器上最新版的代碼fetch下來，然后跟自己的主分支合并。
1. 生成補丁（patch），把補丁發送給主開發者。
1. 看主開發者的反饋，如果主開發者發現兩個一般開發者之間有沖突（他們之間可以合作解決的沖突），就會要求他們先解決沖突，然后再由其中一個人提交。如果主開發者可以自己解決，或者沒有沖突，就通過。
1. 一般開發者之間解決沖突的方法，開發者之間可以使用pull 命令解決沖突，解決完沖突之后再向主開發者提交補丁。
從主開發者的角度（假設主開發者不用開發代碼）看，git有以下功能：
1. 查看郵件或者通過其它方式查看一般開發者的提交狀態。
1. 打上補丁，解決沖突（可以自己解決，也可以要求開發者之間解決以后再重新提交，如果是開源項目，還要決定哪些補丁有用，哪些不用）。
1. 向公共服務器提交結果，然后通知所有開發人員。
### Git初入
如果是第一次使用Git，你需要設置署名和郵箱：
~~~
$ git config --global user.name "用戶名"
$ git config --global user.email "電子郵箱"
~~~
將代碼倉庫clone到本地，其實就是將代碼復制到你的機器里，并交由Git來管理：
~~~
$ git clone git@github.com:someone/symfony-docs-chs.git
~~~
你可以修改復制到本地的代碼了（symfony-docs-chs項目里都是rst格式的文檔）。當你覺得完成了一定的工作量，想做個階段性的提交：
向這個本地的代碼倉庫添加當前目錄的所有改動：
~~~
$ git add .
~~~
或者只是添加某個文件：
~~~
$ git add -p
~~~
我們可以輸入
~~~
$git status
~~~
來看現在的狀態，如下圖是添加之前的：
Before add
下面是添加之后 的
After add
可以看到狀態的變化是從黃色到綠色，即unstage到add。
## Github
Wiki百科上是這么說的
> GitHub 是一個共享虛擬主機服務，用于存放使用Git版本控制的軟件代碼和內容項目。它由GitHub公司（曾稱Logical Awesome）的開發者Chris Wanstrath、PJ Hyett和Tom Preston-Werner 使用Ruby on Rails編寫而成。
當然讓我們看看官方的介紹:
> GitHub is the best place to share code with friends, co-workers, classmates, and complete strangers. Over eight million people use GitHub to build amazing things together.
它還是什么?
- 網站
- 免費博客
- 管理配置文件
- 收集資料
- 簡歷
- 管理代碼片段
- 托管編程環境
- 寫作
等等。看上去像是大餐，但是你還需要了解點什么?
### 版本管理與軟件部署
jQuery[^jQuery]在發布版本`2.1.3`，一共有152個commit。我們可以看到如下的提交信息:
- Ajax: Always use script injection in globalEval … bbdfbb4
- Effects: Reintroduce use of requestAnimationFrame … 72119e0
- Effects: Improve raf logic … 708764f
- Build: Move test to appropriate module fbdbb6f
- Build: Update commitplease dev dependency
- …
### Github與Git
> Git是一個分布式的版本控制系統，最初由Linus Torvalds編寫，用作Linux內核代碼的管理。在推出后，Git在其它項目中也取得了很大成功，尤其是在Ruby社區中。目前，包括Rubinius、Merb和Bitcoin在內的很多知名項目都使用了Git。Git同樣可以被諸如Capistrano和Vlad the Deployer這樣的部署工具所使用。
> GitHub可以托管各種git庫，并提供一個web界面，但與其它像 SourceForge或Google Code這樣的服務不同，GitHub的獨特賣點在于從另外一個項目進行分支的簡易性。為一個項目貢獻代碼非常簡單：首先點擊項目站點的“fork”的按鈕，然后將代碼檢出并將修改加入到剛才分出的代碼庫中，最后通過內建的“pull request”機制向項目負責人申請代碼合并。已經有人將GitHub稱為代碼玩家的MySpace。
### 在Github創建項目
接著,我們試試在上面創建一個項目:
Github Roam
就會有下面的提醒:
Github Roam
它提供多種方式的創建方法:
> …or create a new repository on the command line
~~~
echo "# github-roam" >> README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin git@github.com:phodal/github-roam.git
git push -u origin master
~~~
> …or push an existing repository from the command line
~~~
git remote add origin git@github.com:phodal/github-roam.git
git push -u origin master
~~~
如果你完成了上面的步驟之后,那么我想你想知道你需要怎樣的項目。
## Github流行項目分析
之前曾經分析過一些Github的用戶行為，現在我們先來說說Github上的Star吧。(截止: 2015年3月9日23時。)
| 用戶 | 項目名 | Language | Star | Url |
|-----|-----|-----|-----|-----|
| twbs | Bootstrap | CSS | 78490 | [https://github.com/twbs/bootstrap](https://github.com/twbs/bootstrap) |
| vhf | free-programming books | - | 37240 | [https://github.com/vhf/free-programming-books](https://github.com/vhf/free-programming-books) |
| angular | angular.js | JavaScript | 36,061 | [https://github.com/angular/angular.js](https://github.com/angular/angular.js) |
| mbostock | d3 | JavaScript | 35,257 | [https://github.com/mbostock/d3](https://github.com/mbostock/d3) |
| joyent | node | JavaScript | 35,077 | [https://github.com/joyent/node](https://github.com/joyent/node) |
上面列出來的是前5的，看看大于1萬個stars的項目的分布，一共有82個:
| 語言 | 項目數 |
|-----|-----|
| JavaScript | 37 |
| Ruby | 6 |
| CSS | 6 |
| Python | 4 |
| HTML | 3 |
| C++ | 3 |
| VimL | 2 |
| Shell | 2 |
| Go | 2 |
| C | 2 |
類型分布:
- 庫和框架: 和`jQuery`
- 系統: 如`Linux`、`hhvm`、`docker`
- 配置集: 如`dotfiles`
- 輔助工具: 如`oh-my-zsh`
- 工具: 如`Homewbrew`和`Bower`
- 資料收集: 如`free programming books`，`You-Dont-Know-JS`，`Font-Awesome`
- 其他:簡歷如`Resume`
## Pull Request
除了創建項目之外，我們也可以創建Pull Request來做貢獻。
### 我的第一個PR
我的第一個PR是給一個小的Node的CoAP相關的庫的Pull Request。原因比較簡單，是因為它的README.md寫錯了，導致我無法辦法進行下一步。
~~~
const dgram = require('dgram')
- , coapPacket = require('coap-packet')
+ , package = require('coap-packet')
~~~
很簡單，卻又很有用的步驟，另外一個也是：
~~~
else
cat << END
$0: error: module ngx_pagespeed requires the pagespeed optimization library.
-Look in obj/autoconf.err for more details.
+Look in objs/autoconf.err for more details.
END
exit 1
fi
~~~
### CLA
CLA即Contributor License Agreement，在為一些大的組織、機構提交Pull Request的時候，可能需要簽署這個協議。他們會在你的Pull Request里問你，只有你到他們的網站去注冊并同意協議才會接受你的PR。
以下是我為Google提交的一個PR
Google CLA
以及Eclipse的一個PR
Eclipse CLA
他們都要求我簽署CLA。
