一篇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