Mac安装Gitbook并导出电子书

2017-09-22 | 阅读：次

安装Gitbook并导出电子书

安装Gitbook客户端

输入如下命令进行安装，一定要用到-g，这个代表全局安装

$ sudo npm install gitbook-cli -g

在终端输入如下命令即可查看当前Gitbook版本，出现版本信息代表安装成功。

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

安装Gitbook编辑器

终端环境下的Gitbook只是为了生成HTML文档与电子书使用的，为了方便进行文章书写建议安装Gitbook编辑器。

下载地址：GitBook Editor

安装了Gitbook桌面端之后，你可以在客户端看见gitbook上已有的书籍，也可进行新建一本书籍。创建书籍一般在~/GitBook/Library/目录下

创建电子书

有了书籍后，在对应电子书目录，通过如下命令生成HTML

$ 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 13 pages
info: found 1 asset files
info: >> generation finished with success in 3.1s !

看到success的提示表示成功，这个时候对应电子书目录下就生成了一个_book的文件夹。打开就是该书籍的HTML格式了。

通过如下命令启动服务，就可以在本地浏览了

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 13 pages
info: found 1 asset files
info: >> generation finished with success in 3.3s !

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

看到Serving book on http://localhost:4000，这个时候就可以在浏览器中输入http://localhost:4000进行查看电子书了。

如果愿意将文档公开到gitbook，可通过Gitbook编辑器提交到gitbook服务器，Gitbook网站上可以直接导出PDF，MOBI，EBUP等电子书格式。如果不愿意将文档公开，可以不提交然后在本地生成电子书，方法如下。

本地生成电子书

首先需要安装ebook-convert插件，下载calibre并安装.

安装好后执行如下命令

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

插件安装并配置完成，接下来生成电子书，执行如下命令

$ gitbook pdf . ename.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 13 pages
info: found 1 asset files
info: >> generation finished with success in 6.6s !
info: >> 1 file(s) generated

执行完以上代码，进入书籍目录，即可看到已经转换完成的pdf文件了。同理将gitbook pdf . ename.pdf改为gitbook mobi . ename.mobi即可生成mobi文件。