1. 安装Nodejs
由于gitbook依赖于nodejs来实现的,所以需要首先安装nodejs,才能使用gitbook
关于Nodejs的安装参见:https://www.runoob.com/nodejs/nodejs-install-setup.html
2. 安装gitbook
npm install gitbook -g
npm install gitbook-cli -g
执行如下命令,正常返回版本信息即表示安装成功:
# gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
3. 安装 calibre
calibre
是一个功能强大的电子书管理软件,下载地址:https://calibre-ebook.com/download,选择对应的系统并安装即可
4. gitbook转PDF、epub
进入到gitbook项目目录下,执行如下命令生成PDF:
gitbook pdf .
执行如下命令将生成epub:
gitbook epub .
5. 存在问题
可能部分同学在执行转换命令时,会包如下错误:
InstallRequiredError: "ebook-convert" is not installed.
Install it from Calibre: https://calibre-ebook.com
此原因是由于calibre
未安装或安装目录未加入环境变量,我的是Mac系统,calibre
的安装目录为:/Applications/calibre.app/
,其相关转换程序存储在 /Applications/calibre.app/Contents/MacOS/
目录下,只需要将此路径加入环境变量即可,这里我们只需要用到ebook-convert
这一个程序,只需要为ebook-convert
创建软链即可:
ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
其他操作系统在安装目录下寻找到ebook-convert
,将其所在路径加入环境变量即可使用