一、GitHub的基本操作
[1] GitHub仓库在HTTPS协议下的URL形式:
https://github.com/USERNAME/REPOSITORY.git
[2] GitHub仓库在 SSH 协议下的URL形式:
git@github.com:USERNAME/REPOSITORY.git
1、在GitHub任意页面按 shift + / 键,可显示GitHub的快捷键。如图:
(1)、在某一仓库页面按 t 后,输入要查找的文件,可以在该仓库中快速查找该文件。
(2)、选中某一评论,再按 R 键,可以方便的引用评论。
(3)、评论某一行代码时点击代码的行号,选择 Reference in new issue 即可在Markdown语法下进行编辑评论。
2、将GitHub上的分支下载到本地的方式
将当前的分支中的文件以Download ZIP形式打包下载时,与Git 的clone 方式不同。Download ZIP只是单纯将文件下载到本地,所以无法通过Git 查看日志或对仓库进行更改,无法使用Git进行管理。如果只是想使用仓库中的文件,比较适合用这种方式下载。如下图
3、如果一个处于Open 状态的Issue 已经处理完毕,只要在该提交中,以下列任意一种格式描述提交信息,对应的Issue 就会被Close。
#24 表示关闭第24对应内容的一个编号
fix #24
fixes #24
fixed #24
close #24
closes #24
closed #24
resolve #24
resolves #24
resolved #24
二、在GitHub上进行 Pull Requests
将自己 Fork 其他仓库的分支修改之后,再请求合并到别人的仓库上。使用 Pull requests 来进行操作:
1、首先将需要的分支 Fork 到自己的仓库中,然后在通过 git clone 来将其克隆到本机上进行编辑(也可以在GitHub网页端进行编辑)。
首先将目标仓库的Ftu分支 Fork 到自己的仓库中,再将其克隆到本机:
$ git clone https://github.com/username/first-pr.git
进入克隆到本机的仓库 first-pr 中:
$ cd first-pr
2、对该克隆的分支建立特性分支,然后对特性分支进行编辑,而不是在原分支上进行编辑。在后面的请求合并的时候也是用的编辑后的特性分支。这样可以让 Pull Request 拥有了更明确的特性(主题)。让对方了解自己修改代码的意图,有助于提高代码审查的效率。所以要养成先创建特性分支,再在特性分支上修改代码的习惯。
先查看一下克隆出的仓库的分支,及当前所在分支:
$ git branch -a
创建特性分支,如下 Ftu 的特性分支为 work 。此时work分支即为
特性分支,用来发送 Pull Request :
$ git checkout -b work Ftu
可以检查确认一下当前是否在特性分支 work 下:
$ git branch -a
在特性分支work下修改需要编辑的代码和内容,并提交修改:
$ git add <filename>
$ git commit -m "The message about this commit"
将本地修改好的特性分支 work 推送到GitHub远程仓库中。将会在远程仓库中
创建与本地仓库对应的远程分支work
$ git push -u origin work
查看分支,确认一下是远程分支/origin/work 是否被创建:
$ git branch -a
3、将特性分支 work 推送到GitHub的远程仓库中后,就可以在GitHub页面发送 Pull Request
(1)、首先在GitHub页面切换到特性分支work上(1处),再点击 2 处。
(2)、在3处填写请求对方采纳的评论。检查4处的修改内容是否正确(添加的内容用绿色显示,且添加内容前有+号;删除内容用红色显示,且内容前面有 - 号)。确认无误后点击5处,发送Pull request