GitHub的简单使用记录

记录于：2013/4/24

 

GitHub（网址  https://github.com/）是一个面向开源及私有软件项目的托管平台，由于只支持Git做为惟一的版本库格式进行托管，故名GitHub。

 

GotGitHub内容：http://www.worldhello.net/gotgithub/

---

GitHub为托管的Git版本库提供SSH协议支持，即用户能够用公钥认证的方式链接到GitHub的SSH服务器。下面的示例用ssh命令链接github.com的SSH服务，登陆用户名为git（全部GitHub用户共享此SSH用户名，不要写成其余）。

如成功则显示以下信息；不成功参考 http://www.worldhello.net/gotgithub/02-join-github/010-account-setup.html 

 

$ ssh -T git@github.com

Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access.

 

---

使用任意一种协议都可克隆该Git版本库，但要注意只有Git 1.6.6及以上版本才支持智能HTTP协议，低版本Git则没法用HTTP协议克隆GitHub上的版本库 [2]。

 

$ git clone https://github.com/gotgit/gotgit.git

 

或者使用Git-daemon协议。

 

$ git clone git://github.com/gotgit/gotgit.git

 

 

---

 

3.1. 建立新项目

点击首页中的建立。

 

接下来使用下面的步骤完成“helloworld”版本库的初始化。

• 本地创建一个Git版本库。
   

  $ mkdir helloworld

  $ cd helloworld

  $ git init
• 而后在版本库中添加示例文件，如 README.md文件，内容同前。
   

  $ git add README.md

  $ git commit -m "README for this project."
• 为版本库添加名为origin的远程版本库。
   

  $ git remote add origin git@github.com:gotgithub/helloworld.git
• 执行推送命令，完成GitHub版本库的初始化。注意命令行中的-u参数，在推送成功后自动创建本地分支与远程版本库分支的追踪。
   

  $ git push -u origin master 

---

根目录下的文件 README.md格式化为HTML输出。

GitHub内置了多种文本标记语言的支持，如Markdown、Textile、reStructuredText、asciidoc、Wiki等。当发现根目录下的README文件后，会根据其扩展名判断所用的标记语言类型，自动转换为HTML格式显示。

 

---

在GitHub的页面中能够使用键盘快捷键，按下问号（?）会在弹出窗口显示当前页面可用的快捷键。