build ebook with gitbook and git

build ebook with gitbook and git

💡 原文中文,约6600字,阅读约需16分钟。
📝

内容提要

本文介绍了使用Git和Gitbook创建和管理电子书的方法,包括编写Markdown文件、推送到服务器生成HTML格式的电子书以及发布和更新电子书。该方式类似于GitHub Pages,但部署速度更快,可以定制Git hooks脚本,还可以利用服务器渲染动态页面。

🎯

关键要点

  • 使用 Git 和 Gitbook 创建和管理电子书的方法。

  • 新建 git 项目并创建子目录,编写 Markdown 文件。

  • 通过 git push 推送到服务器,触发 hooks 脚本生成 HTML 格式电子书。

  • 更新电子书内容只需修改 Markdown 文件并推送。

  • 创建新的仓库并修改用户归属以确保权限。

  • 使用 vscode 编辑电子书,添加框架代码。

  • 主要目录和文件包括 bin/www、mybook.json、mygitbook 和 scripts/deploy.js。

  • mybook.json 配置文件定义了需要发布和下线的书籍。

  • deploy.js 脚本负责将 Markdown 内容转换为 HTML 并发布书籍。

  • post-receive hooks 脚本在 git server 接受 push 后自动触发部署。

  • 项目配置完成后,通过 push 更新电子书并自动部署。

➡️

继续阅读