生成电子书

GitBook不仅可以生成静态网站，也可以将内容输出为电子书(ePub，Mobi，PDF)格式。

＃生成PDF文件
$ gitbook pdf ./ ./mybook.pdf

＃生成ePub文件
$ gitbook epub ./ ./mybook.epub

＃生成Mobi文件
$ gitbook mobi ./ ./mybook.mobi

ebook-convert是生成电子书所必需的(epub，mobi，pdf)插件。

$ sudo aptitude install calibre

在某些Linux发行版中安装nodejs，您还需要手动创建一个nodejs软链接：

$sudo ln -s /usr/bin/nodejs /usr/bin/node

下载Caliber应用程序。将calibre.app移动到您的应用程序文件夹后，创建一个指向ebook-convert工具的软件链接：

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

这样就可以在任何目录下执行目录执行ebook-convert命令。

如果出现Operation not permitted异常，说明系统权限限制，需要配置环境变量的方式解决

$ sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin
ln: /usr/bin/ebook-convert: Operation not permitted

环境变量配置

先启动ebook-convert完成第一次启动配置，然后关闭。接着在命令行窗口修改环境配置文件，加入EBOOK_PATH（ebook-convert命令的所在目录）

vim ~/.bash_profile 

export EBOOK_PATH=/Applications/calibre.app/Contents/MacOS
export PATH=$PATH:$EBOOK_PATH

然后刷新一下刚刚的配置:

source ~/.bash_profile

最后测试一下ebook-convert指令是否能正常被调用：

$ ebook-convert --version
ebook-convert (calibre 2.81.0)
Created by: Kovid Goyal <kovid@kovidgoyal.net>

大功告成！下面就可以使用gitbook pdf ./ ./mybook.pdf 命令把你的项目生成pdf文档了！

所有格式电子书都可以创建封面。在安装完可以自己提供一个，或使用autocover插件生成一个。

要创建封面，请在您的书的根目录下放置一个 cover.jpg 文件。还可以添加 cover_small.jpg 指定一个较小版本的封面。封面图片格式必须是 JPEG 文件。

一个合格的封面应遵守以下准则：

进入文档项目目录，输入gitbook pdf ./ ./gitbook.pdf

$ cd ~/gitbook-cn

$ gitbook pdf ./ ./gitbook.pdf

Provide feedback