GitBook生成电子书并发布到GitHub Pages

看英文书，总得留下点什么，索性就机翻一下吧。之前想在GitHub的Pages上做连载，但是Pages的页面之间跳转不方便，所以转而寻求GitBook。

没有VPN，GitBook无法登录，所以在线版是用不了了，只能用命令行。

本地安装GitBook

首先要安装Node.js，对版本有要求，要10.21.0以下，否则生成pdf时会报错。

安装失败可以更换国内源：

npm config set registry https://registry.npm.taobao.org

安装好Node.js后，使用npm install -g gitbook-cli安装命令行工具，然后再使用gitbook -V安装gitbook。因为GitBook已经停止更新、全部转为线上版本了，所以命令行工具停在了2.3.2，GitBook停在了3.2.3，这是安装后的结果：

$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

在一个新的目录内执行gitbook init，会创建README.md和SUMMARY.md，前者是电子书的第一页，后者是目录。写几个Markdown后，通过gitbook build就可以构建电子书了，通过gitbook serve可以在本地浏览器查看。

通过gitbook pdf可以生成PDF文件，不过会报错：

$ gitbook pdf
info: 7 plugins are installed
info: 6