可以将编写好的.md文件通过Gitbook处理成静态网站,然后发布到Github Pages上。
将md文件与Github Pages静态文件存放在一个仓库中。md文件为master分支,而html文件为 gh-pages
分支。
下面将介绍使用一个仓库托管源码,而使用 Travis 自动将静态网站发布到 gh-pages
分支中。这样就可以避免提交源码的同时,还需要同步一遍 gh-pages
分支。
domenic 制作了一个脚本,当 master 分支更新时,自动使用 CI Travis 拉取更新,然后和 gh-pages
分支做比较,如果有差异了,自动将 master 分支的修改提交到 gh-pages
分支。
除了上面的直接发布静态文件到Github Pages的方法以外,还可以使用一个单独的项目的Github Pages功能。
gitbook-tutorial
,这样我就得到一个gitbook-tutorial
仓库。git clone git@github.com:/USER_NAME/gitbook-tutorial.git
git checkout -b gh-pages
,注意,分支名必须为gh-pages
。git push -u origin gh-pages
。git checkout master
。经过这一步处理,我们已经创建了gh-pages
分支了,有了这个分支,Github会自动为你分配一个网址。
http://USERNAME.github.io/gitbook-tutorial
你可以在项目页面右下角setting
中看到: