一篇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 git@github.com:hotplay/playframework-document-cn.git

期间会提示你输入你生成密钥时的密码，如果正确，将如下图所示：

下载egit

如果你使用eclipse，可下载egit插件。地址：http://eclipse.org/egit/download/

关于egit的使用太琐碎，请自行研究。

tags: github
posted in Play by Freewind