Mac环境安装Gitbook，并导出PDF教程

在经过了长时间的折腾之后，终于在Mac环境成功的安装了Gitbook。

安装Gitbook的主要流程如下：

安装node.js>安装Gitbook>安装Gitbook编辑器>安装calibre>导出PDF。

1. 安装node.js

安装node.js，在node.js官网下载，直接安装。

下载地址：https://nodejs.org/en/。

这里需要注意的是，node.js有两个版本，一个是大多数人使用的，也就是稳定版；另一个是最新版，拥有最新的特性。在这里，我们下载稳定版即可。

安装成功之后输入node -v，显示node.js版本代表安装成功。

huixingdeMacBook-Air:~ huixing$ node -v
v6.10.2

2. 安装Gitbook

这个点是最坑的。尤其是在Mac环境下，我先后尝试了以下代码：

npm install gitbook -g
npm install -g gitbook-cli

还有好几个，先说明下，以上代码都是错误的，不是卡主了就是不能动。原来，Mac环境下需要用到sudo这个指令。

sudo npm install gitbook-cli -g

一定要用到-g，这个代表全局安装，我去掉-g安装了一次，也成功了，但是在终端使用gitbook -V查看的时候发现根本没安装，这是我遇到的坑最多的地方。

在终端输入gitbook -V之后即可查看当前Gitbook版本，代表安装成功。需要注意的是“V”一定要大写。

huixingdeMacBook-Air:~ huixing$ gitbook -V
CLI version: 2.3.0
GitBook version: 3.2.2

3. 安装Gitbook编辑器

接下来就是安装Gitbook桌面编辑器了。有的人可能会问，你都已经安装了终端环境下的Gitbook了，为什么还要安装桌面端呢？

下载地址：https://www.gitbook.com/editor/

其实，使用Gitbook桌面编辑器能够很方便的进行文章书写，终端环境下的Gitbook只是为了生成HTML文档与PDF文档而使用的。

安装了Gitbook桌面端之后，你可以在客户端中新建一本书籍。然后用终端生成HTML。

使用gitbook build命令。

huixingdeMacBook-Air:import huixing$ cd jianli
huixingdeMacBook-Air:jianli huixing$ gitbook build
info: 7 plugins are installed 
info: 6 explicitly listed 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 1.0s ! 
huixingdeMacBook-Air:jianli huixing$ 

看到success的提示没，这个时候系统文件根目录下就生成了一个_book的文件夹。打开就是该书籍的HTML格式了。

你也可以直接将该书籍在本地预览。

使用gitbook serve命令

huixingdeMacBook-Air:jianli huixing$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed 
info: loading plugin "livereload"... OK 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 1.2s ! 

Starting server ...
Serving book on http://localhost:4000

Gitbook编辑器需要同终端里安装的Gitbook配合，完美实现在线HTML的生成，PDF的生成。当然，如果愿意将文档公开到gitbook或者gitbub仓库的看到这里就可以了，因为Gitbook网站上可以直接导出PDF，MOBI，EBUP等电子书格式。如果不想将书籍公开，那么可以往下面继续看了！

4. 安装calibre插件

玩过kindle的都知道，calibre是一款非常方便的开源电子书转换软件。在这里，我们也是用到ebook-convert这个插件。

首先在calibre官网下载插件，下载链接：https://calibre-ebook.com/download。下载适合自己系统的版本。

下载到电脑之后我做了很多尝试，刚下载之后我兴冲冲的去使用gitbook pdf . mypdf.pdf指令，结果发现提示ebook-convert未安装。

这里我通过咨询了一些大神，在这个过程中他们给了我很大的帮助。也查看了很多教程，所有教程中都说了两个问题。

• 将安装的calibre放在系统应用中，然后将app添加到path中。

  这个说实话我也没怎么看懂，但是下面我会详细的说这一步如何操作。

• 执行一个命令sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin。

以上两部我都做了，最终也成功的将Gitbook导出了PDF，但具体是哪一步起了作用，我估计是第二步，不过在教程中我优先推荐使用第二步。第二步遇到的坑是，在网上我们找到的教程只是输入ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin，但是执行多次都没有结果，WIN系统执行这步可能已经正确了。因为Mac环境权限的原因，这里加入sudo重新执行即可。

执行完成之后，重新进入书籍目录。

huixingdeMacBook-Air:import huixing$ cd jianli
huixingdeMacBook-Air:jianli huixing$ gitbook pdf . jianli.pdf
info: 7 plugins are installed 
info: 6 explicitly listed 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 7.5s ! 
info: >> 1 file(s) generated 

执行完以上代码，进入书籍目录，即可看到已经转换完成的PDF了。大功告成！

特别感谢：Dandy，烟头γ两位大神的指导。