[工具使用] Mac 使用 GitBook 制作电子书

一、简介#

很多时候我们看到好的 GitBook 资料，无法转换成文档本地浏览，十分的不方便。这时候就思考有没有工具能帮助我们完成这个操作。

二、安装#

其实可以直接使用homebrew来安装，这里不做具体说明，命令如下：

brew cask install gitbook gitbook-editor

我采取的的方式是安装 gitbook-cli，具体方式如下：

npm i gitbook-cli -g
gitbook -V

因为gitbook基于node.js，所以需要先安装node， 我现在用的 gitbook 3.+，装node v12版本就好了：

# 可以先 brew search node 查看版本，然后安装你想要的版本
# 我现在用的 gitbook 3.+，装node v12版本就好了。
brew install node

查看版本，即安装是否成功：

node -v
npm -v

三、使用#

新建文件夹test，作为一本书，并完成初始化：

mkdir test
cd test
# 初始化
gitbook init

生成两个文件

• README.md：书籍的介绍写在这个文件里
• SUMMARY.md：书籍的目录结构在这里配置

编辑这两个文件输入任意内容，目录格式举例：

编辑内容之后，回到终端，再次执行 gitbook init ，生成目录，如图：

然后我们就可以去制作了

四、常用命令#

1. 初始化 或 编辑目录#

gitbook init

2. 编辑内容之后编译书籍#

可以指定目录，默认当前

gitbook build [书籍路径] [输出路径]

3. 生成电子书#

# 生成 PDF 格式的电子书
gitbook pdf ./ ./book_name.pdf
# 生成 epub 格式的电子书
gitbook epub ./ ./book_name.epub
# 生成 mobi 格式的电子书
gitbook mobi ./ ./book_name.mobi

初次生成电子书的时候，可能会出现如下错误：

解决方式：根据提示通过安装calibre-ebook来安装ebook-convert：
下载地址：https://calibre-ebook.com/dist/osx
安装之后，建立软链

ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin/ebook-convert