脚本宝典收集整理的这篇文章主要介绍了

使用 travis + gitbook + github pages 优雅地发布自己的书

脚本宝典小编觉得挺不错的,现在分享给大家,也给大家做个参考,希望能帮助你少写一行代码,多一份安全和惬意。

作者: 一波不是一波

转载请注明出处并保留原文链接( https://github.com/riskers/bl... )和作者信息。

这篇文章教你怎么用 gitbook + travis 在 github pages 上优雅地发布书籍。

模板: https://github.com/riskers/gi...

效果: https://riskers.github.io/git...

项目结构

git clone https://github.com/riskers/gitbook-template

cd gitbbok-template && rm -rf .git # 去掉模板中的历史记录

修改模板:

  • .travis.yml:

    • recipients: 修改成你的邮件
    • REF: 修改你项目的 github 地址
  • book.json: 修改 gitbook 相应配置,不是这里的重点,不多介绍。配置结果见 https://riskers.github.io/git...,可根据喜好自己修改
  • chap01chap02 对应 SUMMARY.md 中的地址,就是这本书的内容了。

然后就是在 github 上新建一个项目,并且 push 上去,然后你能看见这样的项目结构:

github pages

如果没有注册过 github pages 服务,还要先注册(注册过程略)。

新建 gh-pages 分支:

git checkout -b gh-pages
git push origin gh-pages

在项目『Settings』-> 『GitHub Pages』开启 github pages 服务:

https://i.imgur.com/mLt9b1L.j...; width="300" />

Travis

给这个项目开启 Travis 服务: https://github.com/marketplac...

最后你应该能看到这个界面:

个人设置里申请 token 好让 Travis 有权限改这个项目:

然后选择 repo,点击生成按钮:

复制生成的 token,填写在 Travis 的设置-全局变量中,并且取名为 TOKEN:

试试效果

添加一行字:

然后 push 上去,可以看到 Travis CI 在跑了:

稍作等待,跑完之后,可以在 gh-pages 下看到 Travis CI 给我们推过来了 gitbook build 之后的内容:

可以在 github pages https://riskers.github.io/git... 上看到效果:

完成!

后续

这一阵在用 gitbook 写一本电子书,发现多于两本就要收费了,而老版本是不收费的,所以我最近一直在用老版本。但可能是维护少的原因,老版本的同步总是不及时,于是我放弃了 gitbook 服务。

本来想在本地 gitbook build,然后 push 到 pages 服务,但是这样太不优雅了,就琢磨了一下怎么用 CI 来做这件事,刚好之前在公司折腾过一阵 gitlab ci,很快就解决了。

至此,我做到了在 master 上写 md,然后 push 到 master, Travis 自动执行 gitbook build,并且把生成好的文档 push 到 gh-pages,好让 pages 服务生效。全自动的,是不是很优雅?哈哈。

顺便做个广告,这两本书都是按照这种方式写的:


向我捐助 | 关于我 | 工作机会


总结

以上是脚本宝典为你收集整理的

使用 travis + gitbook + github pages 优雅地发布自己的书

全部内容,希望文章能够帮你解决

使用 travis + gitbook + github pages 优雅地发布自己的书

所遇到的程序开发问题,欢迎加入QQ群277859234一起讨论学习。如果觉得脚本宝典网站内容还不错,欢迎将脚本宝典网站推荐给程序员好友。 本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。

80%的人都看过