沫沫小公举
范文一：github使用指南
Github 使用指南!(下文针对 linux 系统而言,特指 ubuntu 系统)
第一步:
下载安装 Git 。
1. 使用新立得软件包管理工具 (Synaptic Package Manager)安装最新版本的 git 。 推荐选择安装 git-core,git-gui,git-doc 。
第二步:设置 SSH Keys
github 使用 ssh keys来确保你的电脑与 github 的连接有安全性。设置过程很简单。 但是有几个步骤。
步骤一:检查已有的 ssh keys。
$ cd ~/.ssh
如果提示说,没有这样的文件或者目录。 (No such file or directory) 则跳到步骤三。否 则继续。
步骤二:备份已有的 ssh keys。
步骤三:产生一个新的 ssh key。
我的产生过程如下:
banxi1988@banxi:~$ ssh-keygen -t rsa -C
Generating public/private rsa key pair.
Enter file in which to save the key (/home/banxi1988/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Passphrases do not match. Try again.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Y our identification has been saved in /home/banxi1988/.ssh/id_rsa.
Y our public key has been saved in /home/banxi1988/.ssh/id_rsa.pub.
The key fingerprint is:
0c:a5:4d:a7:d8:e8:42:b2:5c:75:d0:4c:e5:ff:6a:7f banxi1988@gmail.com
The key's randomart image is:
+--[ RSA 2048]----+
| o==.o |
| . Xo+ |
| . o = + . |
| . = . o . |
| o . . S . |
| . . |
| . |
| .. E|
| ..... |
+-----------------+
banxi1988@banxi:~$
步骤四:
在 gitHub 里单击账户设置。点击 SSH 公钥 ,点击添加另一个公钥。
打开前面生成的 id_rsa.pub 文件。(可能要显示隐藏文件才能看到用 gedit 或者其它的编辑器打开。 注意不要编辑,添加空格或者换行。)
然后把里面的内容复制粘贴到下面的 key 输入栏中。
步骤五:测试一下。
banxi1988@banxi:~$ ssh git@github.com
/etc/ssh/ssh_config: line 20: Bad configuration option: X11Forwrding
/etc/ssh/ssh_config: terminating, 1 bad configuration options
banxi1988@banxi:~$
After modify the ssh_config.中间要求输入上面输入的 passphrase 。
banxi1988@banxi:~$ ssh git@github.com
The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'github.com,207.97.227.239' (RSA) to the list of known hosts.
PTY allocation request failed on channel 0
Hi banxi1988! You've successfully authenticated, but GitHub does not provide shell access.
C onnection to github.com closed.
banxi1988@banxi:~$
步骤六:设置 git 的个人信息。
1. 设置用户名和 email 。 git 使用这个来验证每个提交者。除此之外 github 会使用这些信息来 与你的 github 账号相联系。下面的名字应该是你真实的名字。而不是要 GitHub 的用户名。 banxi1988@banxi:~$ git config --global user.name
banxi1988@banxi:~$ git config --global user.email
banxi1988@banxi:~$
2. 设置 GitHub 的指令环。
有些工具不使用 ssh 来连接。为了使用这些工具。你应该找出配置好你的 API Token 。
在 GitHub 上点击。账号设置(Account Settings) ,然后点击 账号管理 (Account Admin)。
在 API Token 一栏里有你的 API ToKen 。
在命令行下运行下面的代码。
banxi1988@banxi:~$ git config --global github.user banxi1988
banxi1988@banxi:~$ git config --global github.token e5ebe68d43d9820ed8d05a3d2633d7f3
banxi1988@banxi:~$
上面使用的 user 是指 GitHub 的用户名了。
最后:恭喜你!你已经正确的设置了 git 和 gitHub 。
接下来。要做的就是。 1. 创建一个仓库。 2. Fork 一个仓库。 3. 社区化。
第二节 :创建一个仓库 (Create A Repo Repositories)
直接在自己的登录后进入 github.com 首页就可以看到 , 下面一栏有四步 . 用来创建 Repository .
直接填入项目名称就可以了 . 其它的可以不填 . 要填 , 这个表单也足够自解释了 .
创建后之后 . 会跳转到一个页面 . 其中有指示接下来该怎么做的 .
如下 :
:banxi1988/tasteHibernate.git
接下来给你自己的项目创建一个基本的 Readme 文件吧 .
详细操作过程如下 :
Global setup:
Download and install Git
git config --global user.name
git config --global user.email banxi1988@gmail.com
Next steps:
mkdir tasteHibernate
cd tasteHibernate
git init
touch README
git add README
git commit -m 'first commit'
git remote add origin git@github.com:banxi1988/tasteHibernate.git
git push -u origin master
Existing Git Repo?
cd existing_git_repo
git remote add origin git@github.com:banxi1988/tasteHibernate.git
git push -u origin master
Importing a Subversion Repo?
Click here
When you're done:
Continue
banxi1988@banxi:~/github/tasteHibernate$ git init
Initialized empty Git repository in /home/banxi1988/github/tasteHibernate/.git/
banxi1988@banxi:~/github/tasteHibernate$ touch README
banxi1988@banxi:~/github/tasteHibernate$ vi README
banxi1988@banxi:~/github/tasteHibernate$ git add README
banxi1988@banxi:~/github/tasteHibernate$ git commit -m 'first commit'
[master (root-commit) 6ec8aae] first commit
1 files changed, 6 insertions(+), 0 deletions(-)
create mode 100644 README
banxi1988@banxi:~/github/tasteHibernate$ git remote add origin git@github.com:banxi1988/tasteHibernate.git banxi1988@banxi:~/github/tasteHibernate$ git push origin master
ERROR: banxi1988/tasteHibernate.git doesn't exist. Did you enter it correctly?
fatal: The remote end hung up unexpectedly
banxi1988@banxi:~/github/tasteHibernate$ git push -u origin master
Counting objects: 3, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 383 bytes, done.
T otal 3 (delta 0), reused 0 (delta 0)
T o git@github.com:banxi1988/tasteHibernate.git
* [new branch] master -> master
Branch master set up to track remote branch master from origin.
banxi1988@banxi:~/github/tasteHibernate$
关于 Git 的命令请参见 Git 手册 .
现在我们已经可以创建了一个库了 . 创建了一个文件 , 并且提交了 . 并且把它推向了 github.
接下来我们将做什么呢 ?
第三节 : Fork A Repo
有些时候你发现自己想要为别人的项目做贡献 . 或者希望来使用别人的项目做为自己的起点 . 也就称 之为 Fork.
1. Fork 一个项目 . 在你想 fork 的项目的首页 . 找到 fork 按 钮 . 点击 .
2. 接下来设置你本 地 仓库 .
B. .
当 你 克隆 了一个项目之后 . 它有一个 默认 的 remote. 叫 做 .origin. 这是指你是在 github 上 fork 的 . 而不是在 原 来的仓库 . 为了 跟踪原 本的仓库 , 你 需 要添加另一个 叫 做 upstream 的选项 .
$cd projectname
$ git remote add upstream git://github.com/username/projectname.git
$ git fetch upstream
3. 接下来 . 你要做的就是 .
A. 推 送 提交 .
一 旦 你做出了 某 些提交到你 fork 的仓库里 , 你可能想要将其推 送 到你 fork 的项目 去 . 你要做 就 跟平常 的项目一样 .
$git push origin master
4. 接 收 upstream 变更 .
如果你 fork 的 那 个 原 来的仓库 改变 了 , 你可以使用下面的命令来 更 新你 fork 到本 地 的仓库 . $ git fetch upstream
$ git merge upstream/master
后面的 更多 使用指南请参 考 相关文 档 . 例 如创建 分支等 .
本指南是 由 banxi1988根据 github 提 供 的 帮助 . 进行的实 践 之后 , 翻译 过来的 . 由 于本人 水平 有 限 . 所 以 翻译 得不好 , 你可以向我提意见或者直接到 github 里面的 去 看 帮助 . (;banxi-iyan ~_~)
范文二：github使用教程
1、什么是 GIT
Git 是一个强调速度的分布式 版本控制 软件和源代码管理系统(SCM ,
source code management)。 Git 最初是由 Linus Torvalds为内核开发而设计的管理软件。自 从 Git 推出以来,已经被很多开源项目所采纳。每一个 Git 工作目录是一个带有完全历史记 录和版本信息的仓库, 不依赖于网络和中央服务器。 Git 是一个免费的开源软件, 遵从 GNU v2协议。
Git 这个词在英语中的原意是很笨拙,没用的人。 Linus 自嘲说:“我是一个任性的笨蛋, 所以我把我的所有的项目的名字都和我很相似。第一个是 Linux ,现在是 Git 。” Git 的帮助 文档中描述 Git 为:笨拙的内容跟踪者(the stupid content tracker)。 (翻译自 WIKI)
关于开发 Git 的一些历史由来,可以看看这个网站:https://lkml.org/lkml/2005/4/6/121 2、为什么要用 GIT
?更顺畅的工作流程,开发过程中,完全可以离线操作
?快速, Git 分布式架构使得本地仓库包含所有的历史版本信息, 你可以在不同的版本 之间快速切换
?弹性的本地分支,在 svn 下,你建一个分支需要把源代码复制到另外一个文件夹, 而在 Git 下,创建分支的代价是非常小的,只需一条命令
?仓库目录结构简洁,用 Git 复制一个项目,只会在项目根目录创建一个 .git 的目录, 而其他目录很干净
?内容按元数据方式存储,所有的版本信息都位于 .git 目录下
?完整性好,更易于协作开发
?用户群大, 现在已经有成千上万个开源项目采用 Git 来做项目管理, github 上更是有 无数个代码仓库
3、 GIT 安装与配置
a) 安装
1. 从源码安装
在安装之前,你必须保证以下几个依赖包已经安装在你的系统上:
curl, zlib, openssl, expat, libiconv。如果你的系统是 Ubuntu ,你可以这样安装:
apt-get install curl-devel expat-devel gettext-devel openssl-devel zlib-devel
当所有的依赖项已经解决, 就可以从 http://git-scm.com/download上下载 Git 的源码, 然后编 译安装,具体命令如下:
tar -zxf git-1.*.*.*.tar.gz
cd git-1.*.*
make prefix=/usr/local all
sudo make prefix=/usr/local install
2. 在 Linux 上安装
如果你的系统是 Linux 或者 Fedora ,你可以通过以下命令直接安装 Git :
yum install git-core (fedora)
apt-get install git-core (ubuntu)
3. 在 Windows 上安装
尽管 Git 是发源于 Linux ,但现在 Windows 上也有能够正常使用 Git ,只不过不支持中文, 在 Windows 下所有的中文都显示问号, 另外还有一些功能上的 BUG 。 所以建议还是在 Linux 上去使用 Git ,如果你不得不工作在 Windows 上,你可以到 http://msysgit.github.com/上下 载 msysgit 的最新版,安装过程和其他 Windows 程序差不多,基本上点下一步就 OK 了。 Msysgit 默认会安装 git bash和 git GUI这两个程序,一般用 git bash就可以了,它支持常用 的命令。如果对 Linux 命令行不熟,你也可以用用 git GUI,但功能有限制。
b) 第一次使用 GIT
在你安装好 Git 之后,你需要修改一些配置,才能正常使用 Git 。
Git 通过“ git config”命令来配置 Git ,这个命令有 2个选项:--system, --global, 加上默认选 项,分别对应 Git 上 3级配置文件。第一个是 /etc/gitconfig文件,和 --system 对应,这是全 局配置文件,修改这个文件,将会影响系统上所有的用户,所有的仓库。第二个是你家目录 下的 /.gitconfig文件,与 --global 对应,修改它会对你当前用户的所有仓库产生影响。第三个 是你仓库中的 .git/.gitconfig文件,这是“ git config”默认修改的配置文件,它只会对你当前 仓库产生影响。
在第一次使用 Git 时, 你需要告诉你的协同开发者, 你是谁以及你的邮箱, 在你提交的时候, Git 需要这两个信息。具体通过以下命令设置:
git config --global user.name “Test OSS”
git config --global user.email oss.lzu.edu.cn@gmail.com
当然你也可以不用 --global 选项,但这意味这你在每一个仓库中都要这样设置。
同时,你也可以指定你的编辑器,你的 Diff 工具:
git config --global core.editor vim
git config --global merge.tool vimdiff
你还可以通过 ”git config --list” 命令来查看你的设置。
当你把 Git 设置好之后,如果你要和从 Git 服务器上获得仓库,或者向 Git 服务器提交你的 代码(比如 github ),你可能需要生成你自己的 ssh 密钥对。 Git 支持 4种与服务器端通信 的协议:git 、 http 、 ssh 和 https 。其中 git 只是一个只读协议,也就是说你只可以从服务器端 获取仓库,但是你不能提交你自己的代码。而 http 和 https 用的很少,大部分都只支持 ssh 协议和 Git 协议。
当你通过 ssh 协议与远端服务器进行通信的时候,你可以通过以下命令生成 ssh 密钥对: ssh-keygen -t rsa
如果你没有指定密钥名称和存放路径的话,它默认把两个不对称密钥放在你的家目录下 的 .ssh 目录下,密钥文件默认名称为 id_rsa和 id_rsa.pub,前者是私钥,后者是公钥。中间 可能会要你设定访问密钥密码, 这个可以设, 可以不设, 但为了安全考虑, 还是建议你设一 个访问密码。否则,意味着任何持有你密钥的人都可以使用该密钥。
然后把你的公钥发给 Git 仓库管理员,然后你就可以通过 ssh 协议来访问服务器端,期间程 序会自动进行密钥对匹配,如果你设了访问密码,你可能需要输入密码。
更多关于 ssh 的内容,请访问这里:
http://www.freebsd.org/doc/zh_CN/books/handbook/openssh.html
这些设定完之后,你可以通过获得任何一个公开的代码仓库来检测你的 git 是否工作正常。 比如下面这个:
git clone git://git2.kernel.org/pub/scm/git/git.git
4、 GIT 仓库
Git 做为一个资源管理和跟踪系统,如果想要把自己的文件托管在 Git 上,那么首先你得让 Git 知道你需要管理的文件在哪。 比如说现在我有一个项目, 它在 test 文件夹里, 我想让 Git 管理这个项目,这个时候你需进入到这个目录,然后运行“ git init”命令。这个时候 Git 就 会在该目录下生成一个 .git 的隐藏目录, Git 用来进行版本控制和内容跟踪的所有文件都在 该文件夹下。
处于 git 跟踪下的文件只具有三种状态:
?Modified(working directory):被修改过的文件
?Staged(staging area):通过 git add添加到暂存区域的文件
?Committed(git directory):通过 git commit提交到仓库的文件
所以,一般的 git 工作流程可能是这样:修改过某些文件,然后把这些文件添加都暂缓区, 再提交到仓库中形成一个版本或快照,最后提交到 git 服务器上。而在中间,可能伴随着分 支管理,分支切换,撤消与合并。
可能有些人会觉得很奇怪,为什么 git 会有暂存区域这个概念,直接提交到仓库中不就 ok 了。其实这是 git 为了做版本控制用的,试想如果没有暂存区域,每修改一个文件,就会形 成一个版本,太过频繁, 不易于管理。暂存区域其实就是下一个版本的文件清单, 你可以自 由控制该往仓库中提交什么文件, 这也可以避免在一个版本中包含一些中间文件, 比如编译 后的文件。
5、 GIT 基本流程
1. 初始化仓库
初始化仓库有两种情况,一种是直接在一个空目录里建立一个项目,这时候你可以这样干: git init
另一种是从其他机器复制一个仓库,比如这样:
git clone git://git2.kernel.org/pub/scm/git/git.git (远程仓库 )
git clone https://github.com/jQuery /jquery.git (远程仓库 )
git clone git@github.com:wengpingbo/MicroBlog.git (远程仓库 )
git clone /home/oss/test.git (本地仓库 )
第一次从服务器上复制一个仓库,可能比较慢,因为 git 要把所有的历史记录和版本全部复 制下来,这也算 git 的一个弊端吧!
复制完后, 就会在当前目录下生成一个工作目录, 名字以仓库名字命名。 如果你不想指定目 录,那就在上面的命令后加一个目录就 ok 了。比如我想把 test 仓库放到 oss 仓库中: git clone /home/oss/test.git oss
之后,你就可以开始你的工作啦!
2. 添加文件
在编辑了几个文档之后,你可能突然想起来,好像文件还没有让 git 跟踪。 Git 并不会实时 的跟踪你的文件, 只在你明确让它记录你的文件时, 它才会把指定的文件的当前状态记录到 仓库中去,然后又撒手不管了。我想这就是说 git 笨的原因吧。这个时候,你需要手动添加 你的文件当暂存区域:
git add filename1 filename2
如果你懒得一个一个加,你可以试试这个:
git add -A
它会把当前目录下所有的文件都添加到暂存区域。
3. 添加一个版本
在添加完文件后,你可能觉得应该创建一个 commit 了。
git commit
怎么样?是不是有点不对劲, 好像这个命令并没有按你想象的那样跳出一个提交成功的提示, 而是直接跑到了你在配置中指定的编辑器中了。 仔细看一下, 原来是让你给这个版本做一些 备注,随便写点什么,然后保存退出就 ok 了。如果你不想这么麻烦,可以这么干:
git commit -m ?initial version?
可能你觉得之前讲的太罗嗦了,提交一个 commit 还这么麻烦,其实有一个捷径可以使你跳 过添加文件这个过程:
git commit -a -m ?initial version?
大功告成,这个命令会把之前所有的已经添加的文件都加入到这个版本中。
可能你又有疑问了, 之前添加的文件不是自动会加入到下一个版本中吗,问什么还加这个 -a 参数?
其实 git add命令只是把指定文件的当前状态添加到暂存区域, 并不代表一个文件一旦添加, 就会一直存在每个版本中。 如果你添加一个文件后对这个又进行了修改, 在你 commit 时候, 只会 commit 这个文件添加时的状态, 不会把之后的修改也 commit 进去, 除非你再次添加。 4. 推送变更
在你 commit 完之后,你可能想把自己的代码提交到 github 或者其他 git 服务器上,与他人 交流共享,这时候就需要和远程服务器打交道了。
如果你是在本地建立起的仓库, 默认情况下是没有任何服务器地址的, 如果你是从其他服务 器复制过来的仓库,这个服务器地址会自动添加到你的仓库中,你可以这样查看:
git remote -v
如果只输入 ”git remote” ,就只会列出服务器端的别名,不会列出地址来。
一个仓库可以有多个服务器地址, 这就意味着, 你可以从不同的人手中复制同一个仓库, 但 这并不会打乱你自己的分支, 哪怕双方的分支名字都一样。 假如你现在在和另外两个人做同 一个项目中的同一个分支,你发现 A 的一个模块正是你想要的,你想把他的代码合并到你 现在的版本中,这时候你可以这样做:
git remote add code_a git://url/test.git //添加对方的地址 ,code_a是别名
git fetch code_a //复制对方的仓库到本地,但不合并, git pull会自动合并
git merge code_a/master //把对方 master 分支合并到自己当前版本下
合并完之后, 你可能想提交你的代码到其他的服务器上, 这时候你可以先把要提交的服务器 地址添加进来,然后这样做:
git push origin master
上面的命令就是把自己 master 的分支提交到名字为 origin 的服务器上
5. 创建并管理分支
在做项目的时候, 你可能会想写一些扩展性的功能, 或者做一些小实验, 但是你又不想影响 你现在的项目。 这时候, 你可以创建一个分支,然后在这个分支里写东西, 当觉得不好的时 候, 你可以把这个分支删除掉, 对你之前的主分支没有任何影响。 或者你觉得这个新特性超 出了自己的预想,可以合并到主分支里,这时候你只要把工作转回主分支,然后合并分支, 最后删除分支,然后就跟那个分支没创建一样。具体操作如下:
git branch test //创建一个 test 分支
git checkout test //转到 test 分支
edit something...commit something...
git checkout master //转到 master 分支
git merge test //合并 test 分支
git checkout -b test2 //创建 test2分支,并转到 test2分支
git branch -d test //删除 test 分支
git branch //列出分支列表
git branch -v //列出分支列表和当前 commit
Git merge的实质是把两个版本合在一起, 然后在当前分支创建一个新的 commit , 如果你在 两个分支的同一个文件的同一个地方都做了修改,这时候 merge 就会失败, git 就不会自动 创建一个新的 commit ,而是直接停住。你需要手动修改这些冲突的文件,选择这两个分支 中的一个版本,或者自己重写这个部分,然后手动添加这些文件到暂存区域,再 commit 一 下就 ok 了。要查看哪些文件冲突了,可以用 ”git status” 查看。
6. 撤消改动
是人就会犯错。当你执行某个命令之后,突然发现,自己写错了,或者漏了一个文件,这时 候怎么办?
如果你提交得太早,忘了添加某些文件,你可以这样做:
git commit -m ?add something ?
git add file1
git commit --amend
最后一个命令会把你当前暂存区域最为上一次的 commit 。 如果你 commit 以后, 马上 amend , 这时候 git 会直接跳到编辑 commit 备注里面,这样你可以修改你上次 commit 的备注。 如果你添加了不该添加的文件,你可以这样挽回:
git add . //把所有的文件都添加进去
git reset HEAD readme //把 readme 文件从暂存区域去除
如果你发现你编辑错了一个文件,你想把它恢复到上一个版本的状态,这时候你可以这样: git checkout -- filename1 //只撤消这一个文件
如果你觉得这个版本糟糕透了,想完全回滚到上一个版本,你可以干如下事情:
git reset --hard HEAD^
HEAD 是指向当前版本, ^指当前版本的父版本,这个操作无法撤消。你可以把 --hard 换成 --soft ,这只会回退 commit 信息。还有一个 --mixed 默认选项,大家可以参考官方文档,查 看这 3个选项的具体区别。
6、 GIT 常用命令
Git add
Git clone
Git commit
Git push
Git checkout
Git reset
Git pull
Git status
Git branch
//advanced
Git tag
Git log
Git merge
7、学习 GIT 相关资料
《 pro git》 :http://git-scm.com/book/zh
《 git magic》 :http://www.csc.kth.se/utbildning/kth/kurser/DD2385/material/gitmagic.pdf Git manual :http://git-scm.com/docs
范文三：github的使用
github 的使用
Github
?成立于 2008年 。基于 Git ,提供 协作式代码版本控制服务 。
?总部在旧金山。
Git 是一种良好的、 支持分支管理的代码管理方式, 能很好地解决团队之间协作的问题。 每个工程师在自己本地分支 上开发,完成功能之后再将所有人的代码合并。
吉祥物
?名称:Octocat 。
起源
?最早从 Rails 开发社区 兴起, Github 本身也是用 RoR 框架写的。
?早期的 Rails 多人协作开发团队,在代码提交和协作时遇到了很多的麻烦。 为了解决团队之间开发协作困难的这一 个问题 , 创始人 Scott 和其他 3个程序员朋友, 决定完善一个基于 Git 的代码分支管理工具, 用来帮助 Rails 项目本 身的开发。
?这个项目做完之后,很多程序员发现,这个工具不但很好用,而且有着非常友好的用户界面,容易上手和操作。于 是 Scott 等几个人干脆建立了一个网站, 名叫
创始人:5人骨干小组。
?Scott Chacon:GithubGit 布道师, Pro Git作者等。此外,还经常参加各种会议和活动,包括在全球范围内为企 业提供 Git 培训。
?Tekkub :客户关系。
?Melissa Severini:行政。
?Kyle Neath:设计。
?Ryan Tomayko:开发。
公司经历
?2011.10.26:Github 开源 Camfire 机器人 Hubot 。
?2012.2.28:YC 孵化项目 Coderwall 聚合你在 Github 等网站上的项目,打造属于 Geek 的
?2012.5.22:获得 Andreessen Horowitz投资, 1亿美金投资,估值达 8亿。
?2012.10.6:推出单独教学页面,通过网络及面对面实体模式教授协同编程。
?2013.2.1:创投界奥斯卡
?2013.2.16:发布 Boxen 套件,帮助你一键备份和部署新电脑。
?2014.1.10:收购基于 Web 的页面设计工具 Easel 。
客户
?KPI :注册用户突破 400万,托管项目超过 800万个。
?商业模式:Freemium 模式。免费用户能够进行项目代码托管,但是只能使用公共仓库。付费用户能够在 Github 上托管私人的库。
Github 基本功能
Repository
分为公共仓库和私人仓库。仓库包含了所有的:版本、分支、标记信息。
Explore
发现、查看、研究 Github 上公共仓库中托管的代码项目。
Gist
有版本控制的代码粘贴服务,由此可以方便地共享文本或代码。
Blog
个人博客,只要向 Github 提交 Commit 就能发布新文章。
Watch
将感兴趣的仓库加入关注列表,如果所关注的仓库有更新会动态的进行邮件通知。
Star
一种更新的方式管理你所感兴趣的仓库的记录,任何之前预览过的仓库都能在其页面中找到。
Fork
最重要的功能之一,克隆别人仓库的代码到自己的项目中。可以作为子模块的形式使用,或二次开发。
Github 项目前 10名(根据 Star 数)
?
bootstrap :The most popular front-end framework for developing responsive, mobile first projects on the web , 66640 ?
jquery :JavaScript Library, 30328 ?
node :evented I/O for v8 javascript, 28908 ?
html5-boilerplate :A professional front-end template for building fast, robust, and adaptable web apps or sites , 24871 ?
d3:A JavaScript visualization library for HTML and SVG, 24483 ?
angular.js :http://angularjs.org, 22589 ?
Font-Awesome :The iconic font designed for Bootstrap, 22060 ?
rails :Ruby on Rails, 21436 ?
impress.js :It's a presentation framework based on the power of CSS3 transforms and transitions in modern browsers and inspired by the idea behind prezi.com, 19852 ?
backbone :Give your JS App some Backbone with Models, Views, Collections, and Events, 17611 ? homebrew :The missing package manager for OS X, 16755 我们一直用 GitHub 作为免费的远程仓库,如果是个人的开源项目,放到 GitHub 上是完全没有问题的。其实 GitHub 还是一个开源协作社区,通过 GitHub ,既可以让别人参与你的开源项目,也可以参与别人的开源项目。
在 GitHub 出现以前,开源项目开源容易,但让广大人民群众参与进来比较困难,因为要参与,就要提交代码,而给每 个想提交代码的群众都开一个账号那是不现实的,因此,群众也仅限于报个 bug ,即使能改掉 bug ,也只能把 diff
文件用邮 件发过去,很不方便。
但是在 GitHub 上,利用 Git 极其强大的克隆和分支功能,广大人民群众真正可以第一次自由参与各种开源项目了。 如何参与一个开源项目呢?比如人气极高的 bootstrap 项目,这是一个非常强大的 CSS 框架,你可以访问它的项目主页 https://github.com/twbs/bootstrap,点“Fork”就在自己的账号下克隆了一个 bootstrap 仓库,然后,从自己的账号下
clone :
本文作者:liaoxuefeng
范文四：使用github作为博客引擎
2010-08-26
在介绍之前，先普及一下基础知识，大鸟们直接跳过。
什么是git
git是一个分布式版本控制工具(DVCS)，不需要服务端软件支持(即使在地铁里也可以正常commit)，Linux内核开发用的版本控制工具就是它。
常用的SVN属于集中式版本控制工具(CVCS)，需要在服务端开启SVN服务，然后客户端checkout,commit,update。
更详细的介绍请参考维基百科
什么是github
github 的标语是："secure source code hosting and collaborative development"。一个基于git的类似google code的代码仓库，付费版的用户可以创建私有仓库，支持多人开发。很多项目都选择了github来保存代码，如"jQuery/reddit/RoR/CakePHP/Redis"等等。
github pages
先说说pages功能，blog就是在pages的基础上搭建的。如果英文不错的话，可以直接浏览此页
创建一个用户的页面很简单，假设你的用户名为foo
1. 新建一个仓库(repository)，名称填"foo.github.com"，创建
2. 在本地新建一个文件夹，假如为foo,在foo里面新建一个index.html页面，随便输入点内容
3. `git init` 初始化，`git add .` 把index.html加入到仓库中，`git commit` 提交修改
4. 添加github的分支 `git remote add origin git@github.com:foo/foo.github.com.git`
5. 提交到github分支 `git push origin master`
过1分钟左右，浏览foo.github.com，就可以看到刚刚创建的index.html文件了。
除了创建用户页面，还可以针对每个项目单独创建项目的主页，这不是本文的重点，有兴趣的可以浏览此页
创建blog
终于扯到正题上了(-,-)，前面已经说过如何创建html页面，其实已经可以写博客了，创建一个index.html页面，在里面列出写过的文章，点击标题进去后又是一个手动创建的html页。就是太麻烦了，一点都不酷，说不定还会被MM鄙视。
github当然知道这个问题，所以他们创建了jekyll模板引擎 。简单来说，就是你可以用textile 或者markdown语法来写博客，提交到github后，会自动转换成html。
这里有很多网站/博客，都是基于github的jekyll模板开发的，如果觉得哪个不错，可以查看source。
先来看看这个仓库，里面有一些特殊的文件/文件夹：
_config.yml
存储了一些设置，大部分的设置都可以通过命令行指定，但放到配置文件里更方便些
_layouts
_layouts文件夹存放的是模板文件，文章会被渲染到这些模板里，变量指代的是文章内容
_posts
这里就是真正存放博客文章的地方了，文件命名要遵守这种格式:year-month-day-title.markup
_site
这个文件夹是程序生成的，如果本地没有安装jekyll的话，是不会有这个文件夹的，如果想要先本地预览一下，再提交到github，最好通过.gitignore把这个文件夹排除。
index.html
这个文件也有一个yaml前缀 ，可以指定使用哪个模板，标题等等，所有根文件夹下的.html/.htm/.textile/.markdown都会被解析。
other files/folders
上面没有列出的文件/文件夹都会被jekyll放到_site文件夹下，如css/image/script等等。
jekyll的安装
参考安装页 ，如果使用时提示"liquid requires RubyGems version >= 1.3.7"，可以在这里 下载对应的文件，安装即可。
安装完之后，为了避免路径调用问题，可以在apache/nginx里给对应的文件夹(/path/to/_site)绑定一个本地域名，如"lc.foo.github.com"，在终端里输入"jekyll —pygments"，然后就可以用该域名访问本地博客了，如果一切正常，再提交到github
PS:如果你之前的博客是基于wordpress/movable type/typo 4+，可以参考这篇迁移指南
绑定域名
这个就更简单了，新建一个CNAME文本文件，在里面输入域名，如"blog.leezhong.com"，然后在域名提供商里，指定该域名的CNAME为"foo.github.com"，搞定
添加评论功能
使用disqus ，整个注册和使用流程还是挺清晰易懂的，这里就不多说了。
参考文章
jekyll wiki
github blog
publishing a blog with github and jekyll
后记
之前一直用的wordpress，但是太臃肿了，而且有安全隐患，还得有一个PHP空间，访问速度也得不到保证。平时github用得比较多，正好他们提供"博客"服务，正合我意，初步使用下来，没有什么问题，能在本地用vim写textile语法的博客是一件多么爽的事情啊，还可以本地预览最终效果，数据也不会轻易丢失。
最后再次感谢github提供了这么好的服务，如果对github的创业历程感兴趣，可以参考这篇文章
--EOF-- 若无特别说明，本站文章均为原创，转载请保留链接，谢谢
范文五：Eclipse与github安装使用
Eclipse 与 github 安装使用
作者:轻描淡写
Android 交流群 31802077
github
你需要在 github 上注册一个 id, 并且上创建一个 Repository. 如果有疑问请点击
https://help.github.com/articles/creating-a-new-repository.
安装 github 基础环境
Windows 安装下载文件:Git-1.7.9-preview20120201.exe (直接默认安装即可! )
Linux Mac按照 github 上的指南配置(http://help.github.com/win-set-up-git/)基础的 git 环境。
安装 egit
1、 egit 目前应该是 eclipse 上最好的 git 工具了 , 如果你使用的是 eclipse Indigo,你可以直接 点击 help->eclipse marketplace,然后在 search tab页上 find “egit”, 找到后直接 install.
2、如果你使用的不是 Indigo, Egit 下载 . http://www.eclipse.org/egit/download/ Eclipse -> Help -> Install New Software -> add 安装!!
ssh key生成
Repository 创建好以后需要提交自己的 ssh key.一般来说 ,key 的生成有两种方式 :
1. 使用官方指南提供的 msysgit 工具的 ssh-keygen 命令生成 .
2. 使用 eclipse 自带的 ssh2工具生成 .
我们这里选用第二方式 , 使用 eclipse 自带的 ssh2工具 , 具体步骤 :
1. 如果你的 ssh2已经有了需要使用的 id key,请先备份 , 然后将目录清空 .
2. 点击 Window->Preferences->General->Network->SSH2,点击 Key Management tab 页 , 点击 Generate RSA Key,然后点击 Save Private key,将 key 保存自定义目录 . ( C:\Documents and Settings\hc360\.ssh 该目录下检查文件是否生成 ~! ! )
3. 点击 Export Via SFTP,在弹出窗口填入 git@github.com,此时你的 ssh 目录会多出一 个 known_hosts文件 , 此文件与 id_rsa.pub一样重要 . (Passphrase 密码可为空)
4. 将生成的 id_rsa.pub打开 , 删除空行复制里面的内容 , 然后粘贴到 github 的 ssh keys中 . 步骤如下!(成功添加你的注册邮箱会收到一封提示邮件)
5. 查看 ssh 选项卡中点击 Load Existing key 查看是否生成 RSA Key与 known hosts,
如果不能检查以上步骤 , 否则你是连不上 github 的 . 成功!重启 eclipse ! 6. ssh 验证本机是否与 github.com 建立了连接!!
菜单 -> Git Bash ->输入命令:$ ssh -T git@github.com
输入 yes
key 设置了密码会提示输入 passphrase(密码),输入前面自己设置的 passphrase。回车,没有密码直接回车 提示 Hi amdx! Hi amdx! 说明 说明 说明成功 成功 成功连接 连接 连接! !
Egit 本地库提交
创建一个 java 项目
选择
选择 repository type
选择
点击
初始化一个新的 HelloWorld 项目的 Git 仓库。
(可选择本地已创建的版本库 )
点击
项目点击右键
项目装饰图标如下:
项目点击右键
请注意,提交的文件装饰改变。 (恭喜项目提交成功! ) Egit 提交到 Github
这样就完成 EGIT 最基本的创建和上传功能。
Egit 从 Github 下载创建 HelloWorld 1、打开 egit eclipse 的窗口
2、点击 Clone a Git repository 从 github 克隆一个版本库
3、回到 github 复制 HelloWorld 的 SSH 地址
4、粘贴到下窗口 URI 地址栏如图
5、 Next finish 后 eigt 建立好了一个 C:\Document… 下的本地版本库如图
6、选择 egit 连接 HellWorld 右键弹出功能菜单,然后选择‘ Import Projects..’导出项目
7、向导窗口选择 ‘ Import existing projects ’ ‘ Next ’ ‘ Finish ’
8、
eclipse 窗口切换到 Java EE 窗口导出项目如图, 此时恭喜你大功告成可以 欢庆了!!
转载请注明出处范文大全网 » github使用指南
