一篇github基礎教程，大手勿噴。看別人的。本身剛照着這個學會

文檔都放在github上（地址：https://github.com/hotplay/playframework-document-cn），參與者可經過git進行合做。

但很快有羣友問怎麼用。考慮到git與github在國內使用得還不夠普遍，我打算寫個博客，講解一下基本用法。

首先須要下載git

官方主頁：http://www.git-scm.com/

當前最新版本v1.7.6.1下載地址：http://code.google.com/p/msysgit/downloads/detail?name=Git-1.7.6-preview20110708.exe&can=3&q=

安裝git

安裝比較簡單，一路next便可，其中有兩個地方須要注意一下。

Git Bash是指git安裝好以後，有一個專用的命令行工具（開始->Git->Git Bash），像cmd同樣，截圖以下：

它能夠執行一些linux上的命令，方便操做。但在windows上，不能複製粘貼，不太好用。因此咱們通常會選擇第2項或第3項，在windows的cmd上直接運行git命令。

另外一個窗口是：

讓咱們選擇如何處理文本文件中的選行符。git考慮到合做者可能在不一樣的操做系統下，如windows下使用\r\n，linux下使用\n，mac下使用\r。爲了既能保證服務器上的代碼使用相同的換行符，在各自的電腦上又能使用各自的換行符，因此有三種處理方式：

1. 下載時把換行符變成\r\n，提交時變成\n

2. 下載時不轉換，提交時變成\n

3. 下載和提交時都不處理

做爲windows用戶，咱們應該選擇第一項。

關於git gui

安裝好git後，還有一個git gui，以下圖：

我的以爲這個東西實在太難用，不如不用。咱們可使用命令行，也能夠在eclipse下使用egit。其它如idea下也有對應的工具。

此時咱們已經能夠下載github上的代碼

對於咱們只想下載不打算提交的項目，如今已經能夠下載了。以playframework-document-cn爲例：

打開https://github.com/hotplay/playframework-document-cn，點擊下圖中的Git Readonly按鈕：

把右邊顯示的git://github.com/xxx這一串地址拷貝下來，而後打開命令行，輸入命令：

git clone git://github.com/hotplay/playframework-document-cn.git

 

git會自動把代碼下載下來，放在當前目錄下的playframework-document-cn目錄下：

注意這是readonly的，只能看，不能提交。

嘗試以SSH方式下載

若是咱們想提交，除了咱們的賬號已經加入到該項目的提交者白名單中，最最基本的條件是，咱們要生成公私鑰，並把公鑰填到github上。如今嘗試SSH方式，會提示錯誤：

提示說咱們沒有權限。

生成公私鑰

公私鑰的認證方式在不少地方均可以使用，具備較好的安全性。咱們可使用一些工具生成，當心保管好生成的公鑰和私鑰，它能夠重複使用。公鑰的信息能夠公開（它實際上就是一段字符串），而私鑰必定不可讓其它人知道。

關於生成方式，在github上有專門的幫助內容，請參看：http://help.github.com/ssh-issues/

由於此處比較難講，因此省略，請自行google或baidu

把生成的公私鑰放在用戶目錄下

個人用戶目錄是C:\Documents and Settings\nowind，放在.ssh目錄下（若是沒有，新建）。其中前兩個文件是咱們生成的，known_hosts是後來本身生成的，不需管。

將公鑰上傳到github上

再次下載

git clone git@github.com:hotplay/playframework-document-cn.git

 

期間會提示你輸入你生成密鑰時的密碼，若是正確，將以下圖所示：

下載egit

若是你使用eclipse，可下載egit插件。地址：http://eclipse.org/egit/download/

關於egit的使用太瑣碎，請自行研究。

tags: github
posted in Play by Freewind