一篇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。为了既能保证服务器上的代码使用相同的换行符，在各自的电脑上又能使用各自的换行符，所以有三种处理方式：
下载时把换行符变成\r\n，提交时变成\n
下载时不转换，提交时变成\n
下载和提交时都不处理
作为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 [email protected]:hotplay/playframework-document-cn.git
期间会提示你输入你生成密钥时的密码，如果正确，将如下图所示：
下载egit
如果你使用eclipse，可下载egit插件。地址：http://eclipse.org/egit/download/
关于egit的使用太琐碎，请自行研究。
tags: github
posted in Play by Freewind