介绍下简单的提交sublime插件到packages control的步骤:
针对新版的packages control
提交单个插件: 添加自己的插件信息到repository/文件夹里面对应字母的文件.
更多信息参考:https://sublime.wbond.net/docs/developers
example-repository.json 是插件的例子, 里面有一些注释的说明, 可以针对不同的ST版本/不同的系统设置插件源.
如果自己有多个插件: 可以创建个单独的项目, 创建个packages.json, 里面包含多个插件的信息, 格式可以参考example-repository.json.
在channel.json加上这个packages.json的url.
可以参考下我创建的:https://raw.github.com/kairyou/sublime_packages/master/packages.json
如果json内容的releases-details使用tag来自动更新版本, 那么push到github时需要加上tag来更新版本号.
git tag -a 1.0.1 -m 'init' #创建
git tag #查看
git push origin 1.0.1 #push tag
删除旧的名称为1.0.0的tag (可选):
git push origin :refs/tags/1.0.0 # 删除远端
git tag -d 1.0.0 # 删除本地
Send a pull request
修改好后, push到自己fork的分支. 接下来把自己的修改提交给packages control:
打开github上自己fork的主页, 进入"Pull Request"(右上方有个按钮).
github新版界面有个"Click to create a pull request for this comparison", 要点击输入标题和内容.
如果你做了修改, 可以看到一个表单, 输入Pull Request的标题和内容, 然后Pull Request.
之后就等作者merge了.
如果packages control作者接受了，你的修改就可以合并到主版本里了, 然后就可以在packages control官方找列表看到你的package了.
PS: 如果此时担心主版本修改, 要获取最新的文件, 可以用 git pull packages_control 将主版本的修改拉到本地.
如何更新自己Fork的packages_control代码
clone自己的fork的分支下來:
git clone git@github.com:yourName/package_control_channel.git
remote添加一个(名为upstream)的远程仓库, URL使用对方的地址:
git remote add upstream git@github.com:wbond/package_control_channel.git
git remote -v # 可查看当前的远程仓库列表
把对方的代码拉到本地: git fetch upstream
合并对方的代码: git merge upstream/master
推到自己的仓库: git push origin master
Ps: 如果放弃自己的分支(直接使用对方最新的), 也可以在自己的仓库主页点"Settings", 在选"Delete this repository". 然后去对方仓库重新点fork.
旧版本的package_control添加的方法, 可以忽略下面的内容
1. 在自己创建的package文件夹内创建: packages.json, 格式参见:
http://wbond.net/sublime_packages/package_control/package_developers#Custom_packages_json_on_GitHub
或: https://raw.github.com/kairyou/SublimeTmpl/master/packages.json
2. Fork the Package Control Channel: https://github.com/wbond/package_control_channel
在GitHub上Fork这项目, 把你fork后的分支 git clone 到本地, 编辑repositories.json, 找到里面的"repositories"(可以看到里面已经有很多package了).
加上自己的packages.json的URL(类似上面我创建的packages.json地址). 注意, 添加时, 请按URL的字母顺序排列, 不需要加URL列表的最后面.