简介

Gitbook是一个基于Markdown语言的文档编写实用工具。支持离线文档和在线文档两种发布方式。本文主要是描述如何使用gitbook生成离线的PDF文档。

准备

1. Windows 10
2. node v10.21.0
3. npm v6.14.4
4. gitbook v3.2.3
5. calibre v3.48.0

请将上述工具在windows上安装并配置好。

安装 node

Node的版本必须是10.21.0，版本太高gitbook会报错。

下载并安装配置好环境变量即可
https://cdn.npm.taobao.org/dist/node/v10.21.0/node-v10.21.0-win-x64.zip

npm建议更改成淘宝源

npm config set registry https://registry.npm.taobao.org

安装calibre

calibre是一个支持PDF/EPUB/MOBI等文件格式转换的工具，可以前往官网查看下载并安装。

安装完成后需要设置环境变量，将calibre安装目录增加到环境变量

默认安装的目录
C:\Program Files\Calibre2

安装 gitbook

npm install -g gitbook-cli
gitbook fetch 3.2.3

生成PDF

下载一个项目以供测试

前往网站下载
https://github.com/apachecn/dataviz-zh

或者使用git
git clone https://github.com/apachecn/dataviz-zh.git

命令行界面切入到目录下面，运行以下命令生成PDF

gitbook pdf

或者生成其他文件格式
gitbook <pdf|epub|mobi>

output

成功会在当前目录下生成book.pdf文件

PDF文件