自动化需求
文档仓库只管提交文档代码,发布gh-pages的任务完全交给了circle-ci
说明
众所周知,GitHub的gh-pages分支是一个静态页面,好多人用来当做博客文档,这里重点说一下文档,书写文档本人最喜欢MarkDown格式,而gitbook完美支持MarkDown,gitbook build 后的文件就是一个静态文档页面,将build文件放在gh-pages分支,那么大家就可以愉快的访问了,这里参考本人的插件文档仓库,点击查看插件文档
要将build文件放到gh-pages分支上,npm刚好有gh-pages模块提供了这个功能,当文档编写完毕,需要发布时,使用命令
gh-pages -d _book
就可以一键更新文档,很完美,但是每次都需要自己手动发布有点繁琐,而circle-ci又和GitHub完美无缝对接,完全可以依赖circle-ci进行自动化发布,具体的操作说明见文章,现在可以很愉快的专心编写文档了,编译发布的任务完全交给了circle-ci。
其他参考
- https://tech.quartetcom.co.jp/2016/03/17/cleaver-cicleci-github-pages/
- 在这里发现一个仓库采用circle-ci进行打包cocos2dx项目,可以参考学习
网友评论