纸壳CMS是基于GPL v3.0开源协议开源的自由软件,可以免费使用它来做任何开源项目。同时也可以提交您的代码到官方仓库,让您的修改不被覆盖。比如你修改了一个已知的BUG,就可以将你的修改提交给主仓库,这样你的修改就会被保留下来。要参与纸壳CMS的开发很简单,只需要有一个GitHub的账号就可以了。
仓库地址
Fork
做的第一件事情就是“Fork”。简单的说,就是在你自己的账户下,克隆一个一模一样的仓库。为什么要Fork?因为别人账户下的仓库,你没有权限进行提交代码,但自己仓库下的可以,所以要先加纸壳CMS Fork到自己的账号下。Fork的方式很简单,直接点击右上角的"Fork“即可。
这样,在你自己的GitHub账号下就多了一个纸壳CMS的仓库
Clone
接下来要做的事情就是把仓库代码Clone到本地。注意这里克隆的是你自己账户下的纸壳CMS项目,而不是官方的项目地址。如:
git clone https://github.com/Timynore/ZKEACMS.Core.git
克隆的时间长短与个人的网速有关,请耐心等待。
Coding
开发的时候,您可以选择创建新的分支,这样可以与主分支分开。用单独分支开发是推荐的做法。
Commit
在代码修改完成以后,就要提交代码了。先将您的代码提交到本地仓库,并在提交的时候做一些简单的说明。
鼠标右键,选择Commit:
输入这次修改的说明,并点击提交(Commit)。
这样,刚修改的代码就提交到了本地仓库。接下来需要把代码同步到远端仓库GitHub上。可以在刚才提交完成以后,直接点击Push:
或者鼠标右键>TortoiseGit>Push:
然后直接点击确定,等待代码推送完成。
推送完成时显示如下:
这样,刚修改的代码就已经提交到了GitHub上了。
Pull Request
在代码提交到GitHub以后,就可以发起来个Pull Request(拉取请求)。意思就是请求纸壳CMS主仓库拉取你仓库的代码进行合并。点击GitHub上项目主界面上的”New pull request“:
注意选择将代码合并到开发分支(develop)
最后,点击”Create pull request“:
输入简单说明,再次点击”Create pull request“就可以了:
你的代码并不会马上就合并到纸壳CMS的分支中,需要等待作者的查阅后才会被合并。
Synchronization
在Fork了代码仓库一段时间后,你账号里的仓库可能就不是最新的了。可以通过发起拉取请求同步最新代码。GitHub会告诉你当前分支的差异信息,然后点击拉取请求即可。
这里要注意,GitHub上的显示是把右边的代码合并到左边,所以要把自己的仓库转到左边如果不是在左边的话。
右边选择纸壳CMS官方仓库:
然后点击”Create pull request“,再合并即可:
点击确认合并,就可以将代码合并过来了: