五. 详细解说GitHub的功能
GitHub有以下几个重要功能:
- 键盘快捷键
在各个页面按下shift+/都可以打开键盘快捷键一览表,查看当前页面的快捷键。 - Issue
在GitHub上,Issue可以作为开发者之间的交流工具;遇到下面几种情况时,各位就可以使用这个功能:
●发现软件的BUG并报告
●有事想向作者询问、探讨
●事先列出今后准备实施的任务 - Pull Request
Pull Request是用户修改代码后向对方仓库发送采纳请求的功能,也是GitHub的核心功能。正因为有了这个功能,才会让众多开发者轻松地加入到开源开发的队伍中来。 - Wiki
Wiki是一个使用简单的语法就能编写文档的功能。所有有权限的人都可以对文章进行修改,所以比较适合多人共同编写文章的情况。创建、编辑文档时不必另外启动软件,用起来十分方便,非常适合用来针对更新频率较高的软件进行文档等信息方面的汇总。
以下着重来看一看Pull Request功能:
1. 什么是Pull Request?
假如我们正在使用GitHub上的开源软件过程中发现了bug,我们对它进行了改正,这是就需要使用Pull Request功能请求对方仓库采纳该修改,这样像我们一样使用这款软件的人就不会再遇到相同的问题;
发送Pull Request后,对方会收到一个附带源码的Issue,这就是Pull Request;只要Pull Request被顺利采纳,我们就会成为这个项目的Contributor(贡献者),我们编写的这段代码也将被全世界的人使用。
2. 发送Pull Request
- Fork
首先将访问的仓库Fork一份到自己的GitHub上的远程仓库; - clone
把这个仓库克隆到当前开发环境中,并修改源代码进行push,GitHub账户的远程仓库就会被修改; - branch
当前Git的主流开发模式都会使用特性分支,应该养成这样的好习惯; - 添加代码
在特性分支下编辑代码; - 提交修改
将修改后的代码提交至本地Git仓库; - 创建远程分支
要从GitHub发送Pull Request, GitHub端的仓库中必须有一个包含了修改后代码的分支,所以现在将此特性分支push到远程仓库; - 发送Pull Request
在确保内容无误后创建Pull Request并发送;
注:如果用户对该仓库有编辑权限,则可以直接创建分支,从分支发送Pull Request。利用这一设计,团队开发时不妨为每一名成员赋予编辑权限,免去Fork仓库的麻烦。
3. 接收Pull Request
在仓库的Pull Request标签页中显示别人发送过来的Pull Request的一览表。查看详情后没有问题的话,可以Merge pull request,Pull Request的内容就会自动合并到仓库;当然在合并之前需要对代码进行审查,确保其是有效的;
4. 说明
本文为《GitHub入门与实践》读书笔记,如有错误,还请兄弟们指正,大家一起进步。