gitbook 既可以将源码文件单独输出, 也可以仅输出单个文件, 常见的导出电子书格式主要有三种(ePub, Mobi, PDF), 而这三种格式都依赖于系统本身提供的 ebook-convert 工具.
安装依赖
如果直接运行 gitbook pdf 相关命令, 可能会报错, 提示需要安装 ebook-convert 插件, 根据提示本地需要安装 calibre 软件, 这样 gitbook 才能正常导出电子书.
calibre 官网: https://calibre-ebook.com/
linux 系统
下载地址: https://calibre-ebook.com/dow…
下载应用
$ sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
配置软链接
$ sudo ln -s /usr/bin/nodejs /usr/bin/node
mac 系统
下载地址: https://calibre-ebook.com/dow…
下载应用
将 calibre.app 移动到应用程序文件, 然后尝试是否能正常打开应用.
配置软链接
$ sudo ln -s ~/Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin
测试命令
$ ebook-convert –version
如果没有输出 ebook-convert 版本信息, 可能需要配置环境变量.
配置封面
所有格式的电子书都可以配置自定义封面, 在项目的根目录下提供 cover.jpg 和 cover_small.jpg 两种封面图片时, 生成电子书会自动增加封面页.
当然你也可以使用 autocover 插件 自动生成封面, 不过本人才疏学浅, 几经尝试始终没有成功, 如果有人成功了记得给我留言下哈!
封面的基本要求:
cover.jpg 尺寸大小: 1800X2360 px,cover_small.jpg 尺寸大小: 200×262 px;
无边界
清晰可见的书名
任何重要的文字在小版本封面图片中也要清晰可见
更多封面相关规范请参考 https://toolchain.gitbook.com/ebook.html
基本命令
语法格式: gitbook pdf 或 gitbook epub 或 gitbook mobi
示例:
# 生成 `pdf` 文件并输出 `debug` 级别日志
$ gitbook pdf ./ ./myBook.pdf –log=debug
# 生成 `epub` 文件并输出 `debug` 级别日志
$ gitbook epub ./ ./myBook.epub –log=debug
# 生成 `mobi` 文件并输出 `debug` 级别日志
$ gitbook mobi ./ ./myBook.mobi –log=debug
相信大家对 PDF 格式比较熟悉, 其余两种格式只是不同电子书格式, 因而需要相应软件支持.
生成 PDF 文件
示例:
$ gitbook pdf
默认在当前项目的根目录下生成 book.pdf 文件名, 如果配有封面, 则首页显示封面, 否则无封面.
生成 ePub 文件
示例:
$ gitbook epub
默认在当前项目的根目录下生成 book.epub 文件名, 如果配有封面, 则首页显示封面, 否则无封面.
生成 mobi 文件
示例:
$ gitbook mobi
默认在当前项目的根目录下生成 book.mobi 文件名, 如果配有封面, 则首页显示封面, 否则无封面.
小结
本节主要介绍了如何导出电子书, 概括来说, 首先系统需要安装 ebook-convert 工具, 然后配置电子书封面, 最后直接导出为目标格式 (ePub, Mobi, PDF) 进行输出.
随着电子书内容越来越多, 生成电子书所花费的时间也越来越久, 实属正常, 耐心等待即可.
输出 PDF 文件并输出 debug 日志: gitbook pdf –log=debug