如何在github上参与主题【vfhky】的代码开发:开源项目协作开发实战
为了使更多的童鞋能通过github加入到主题【vfhky】的开发上来,博主把整个流程简要介绍下。其实,这也是一篇如何在github上参与一个开源项目的简单教程。
1 下载github(window客户端)
在github上用邮注册帐号后,下载github的window客户端,地址是https://help.github.com/articles/set-up-git。
2 登录github客户端
为了简单起见,这里就不使用生成ssh key的方法了,直接打开那个蓝色的GitHub图标,这个是图形界面。然后输入帐号密码,它会自动生成一个ssh key并同步到github远端上。
3 使用Git Shell
打开那个黑色的Git Shell图标,这个类似与Linux的命令终端。打开后如下图所示:
4 在github上fork主题到自己的远端仓库
打开地址主题【vfhky】在github上的主页:点击此处,会看到如下图所示。左上角的vfhky/vfhky表示“作者/项目名称”,点击右上角的fork,这样就把这个仓库复制到了自己的远端仓库(可以打开自己的github主页看到)。
5 在github上fork主题到自己的远端仓库
打开地址主题【vfhky】在github上的主页:点击此处,会看到如下图所示。左上角的vfhky/vfhky表示“作者/仓库名”,点击右上角的fork,这样就把这个仓库完整复制到了自己的远端仓库。然后打开自己的github主页下面看到新增了一个vfhky仓库,进入后把如下图中的右下角的ssh链接复制出来(类似于[email protected]:vfhky/vfhky.git)。
6 克隆自己远端仓库到本地仓库
打开那个黑色的Git Shell图标,然后输入git clone [刚才那个ssh链接],这样就把你自己的远端仓库克隆到了本地。
7 修改代码后提交到本地仓库
先使用 git add go.php ,然后 git commit -m '这是我第一次修改go.php文件'。然后 git push origin master ,把本地的仓库同步更新到自己的github远端仓库。
8 保持与主题源仓库的代码同步
打开github你自己仓库的主页,如上图右边的中上位置,有个pull request,这个就是把你更新的代码提交到源仓库,由源仓库的管理员(也就是博主我啦)来审核并决定是否合并代码。但是有种情况,就是在你修改代码的同时,博主也在修改这个主题的代码。那么这时你 pull request 就有可以会出错,因为你fork的repo和现在的仓库拥有者vfhky的repo已经不一样了,从而导致了一个conflict。所以你需要在你pull request前,更新你本地仓库的代码。
首先,在Git Shell中使用 git remote add vfhky [email protected]:vfhky/vfhky.git 。这样就在你本地仓库增加了一个上游仓库,用于保持和源仓库代码的更新。
然后,使用命令 git fetch vfhky master 表示从源仓库中的master分支拉取代码,用于本地代码更新至最新。
接着,进行代码的merger合并。
最后使用 git pull vfhky master 命令查看是否还有conflict。这样你在提交一个pull request就行了。
9 等待源仓库拥有者审核
完成上面的步骤后,在源仓库的主页右侧栏的“Issues”会显示一个更新,也就是你的提交会以一个issues显示在源仓库对应的栏目下面。如上图所示,这时你要做的是等待源仓库的拥有者(当然是博主啦)审核合并代码,或者在你提交的issues下面参与讨论。
Comments »