前言
对于经常阅读的人来说，制作本地电子书，算是刚需了。网上的很多教程都不太好用，所以我特地整理出一个详细的教程。亲测有效，一劳永逸。
当你意外发现，想要集中阅读上面的每一篇文章，恨不得一口气看完，你会怎么做呢？你可能会把它添加到“微信读书”App 的书架上：
但上面这种曲线救国的方式并非最佳，仍然不尽人意，存在不少问题。
我知道，现在有很多的第三方服务，可以将任意公众号的文章制作成电子书，我试过很多次，但都是付费的。一听说要钱，你又不干了：
再列举一种场景：当你在 GitHub 上发现一个很全面很丰富的项目文档时，仿佛发现了新大陆。可 GitHub 网站的的服务器在国外，国内的访问速度实在感人，你想要把它下载到本地查看，会怎么做呢？你估计会直接选择“Download ZIP”，然后用 Typora 或者 VS Code 软件打开这个项目文档，在本地查看：
总之，你能想到的方式，我都想到了，而且都尝试过。
现在的需求就是，如果你经常阅读网上的资料，肯定会有这样一个需求：怎么把这些几百页、甚至几千页的内容整理成 PDF、ePub、mobi 等格式的电子书呢？
要么花钱请别人做，要么自己做。
今天这篇文章，就是来告诉你”自己动手制作 PDF、ePub、mobi 等格式电子书“的最佳方式。如果你是码农出身，下面讲的这些步骤，根本难不倒你。如果你不是码农出身，也没关系，只要你有一台电脑，跟着我讲的教程研究下去，肯定能搞定。
问题的关键不在于难不难、会不会，而是在于你是不是爱折腾。
制作电子书的具体步骤
整体流程
先说一下整体步骤：
(1)安装 gitbook 工具。
(2)安装 calibre 软件，配置 ebook-convert工具。
(3)将md格式的多个文件素材导出为电子书(支持 PDF、ePub、mobi 等格式)。
(4)高级进阶：配置电子书的目录、封面、页眉页脚等。
整理流程如下：
接下来我们看看详细的完整步骤。
步骤 1：通过 npm 安装 gitbook-cli
安装命令如下：
npm install -g gitbook-cli安装成功之后，再执行gitbook -V命令确认是否安装成功：
gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3备注：如果你不知道 npm 是什么，可以自行查阅如何安装 Node.js 和 npm 环境。
步骤 2：安装 ebook-convert(针对 Windows 用户)
ebook-convert 是能够自由转化格式的一个命令行工具，已经包含在 calibre 软件里面了。
(1)安装 calibre 软件。calibre 的官网如下：(我们可以去官网下载安装)
(2)在终端输入如下命令，验证 ebook-convert 是否能正常使用：
ebook-convert --version如果输入上面的命令后提示错误，说明你还需要将 calibre 的安装目录添加到系统的环境变量中。
步骤 2：安装 ebook-convert(针对 Mac 用户)
ebook-convert 是能够自由转化格式的一个命令行工具，已经包含在 calibre 软件里面了。
(1)安装 calibre 软件。calibre 的官网如下：(我们可以去官网下载安装)
(2)配置 ebook-convert。针对 Mac 系统，需要执行如下命令，把 ebook-convert 软链接到 bin 目录：
sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin如果出现Operation not permitted异常，说明系统权限限制，此时需要配置环境变量。
(3)环境变量配置：
vim ~/.bash_profile
# 将下面这两行配置，添加到 .bash_profile 文件中
export EBOOK_PATH=/Applications/calibre.app/Contents/MacOS
export PATH=$PATH:$EBOOK_PATH备注：可以自行研究下，在命令行环境，如何通过 vim 编辑文件。
然后刷新一下刚刚的配置：
source ~/.bash_profile验证ebook-convert是否能正常使用：
ebook-convert --version步骤 3：配置电子书的目录
本地新建一个空的文件夹，作为我们的电子书项目。文件夹的名字随便起，但建议用英文命名。
(1)项目初始化。
在当前项目下，执行如下命令，进行初始化：
gitbook init此时，项目下会自动生成如下两个文件：(非常重要，必不可少)
README.md：书籍的简介放在这个文件里。SUMMARY.md：书籍的目录结构在这里配置。
这两个文件创建后，内容为空白，可使用 Markdown 语言自定义内容。
(2)配置电子书的目录。
我们先把本地的 markdown 文件(也就是我们的电子书素材)放到项目中，然后在SUMMARY.md文件中配置电子书的目录。
比如说， 我的项目中有下面这些文件：
那么，我在SUMMARY.md文件中就要这样配置：
# 目录制作成的目录，将会是下面这种效果：
步骤 4：导出电子书
(1)本地预览电子书：
gitbook serve执行上方命令后，工具会对项目里的 Markdown 格式的文件进行转换，默认转换为 html 格式，最后提示 Serving book on http://localhost:4000。
我们打开浏览器输入http://localhost:4000，预览一下电子书的效果：
(2)制作并导出电子书。接下来就是见证奇迹的时刻。
生成 PDF 格式的电子书：(PDF 是最常见的文档格式)
gitbook pdf ./ ./mybook.pdf生成 epub 格式的电子书：(epub 是最常见、最通用的电子书格式)
gitbook epub ./ ./mybook.epub生成 mobi 格式的电子书：(mobi 格式可以在 kindle 中打开)
gitbook mobi ./ ./mybook.mobi上面这三种格式的电子书生成之后，项目里会看到这三个新增的文件：
我们把电子书打开，验收一下成果。
打开 pdf 电子书看看效果：
打开 epub 电子书看看效果：
怎么样，自制电子书就这样做好了，是不是很有成就感？
制作电子书的高级配置
电子书做好之后，我猜你肯定想进一步做个性化配置，比如：怎么加封面？怎么修改页眉页脚？还有其他的一些配置。
我们来看看亲手制作的电子书，有哪些常见的高级配置。
制作书籍封面
为了让书籍显示得更加优雅，我们可以指定一个自定义的封面。操作如下：
在项目的根目录下准备好 cover.jpg (大封面)和 cover_small.jpg (小封面)这两种封面图片。注意，图片的文件名和后缀名必须严格按照这句话来。
GitBook 的官方文档建议：cover.jpg (大封面)的尺寸为 1800x2360 像素，cover_small.jpg(小封面)的尺寸为 200x262 像素。图片的制作，建议遵循如下规范：
- 没有边框
- 清晰可见的书本标题
- 任何重要的文字在小封面中应该清晰可见
book.json ：电子书的各种配置
我们可以在项目的根目录下新建一个文件book.json(注意，文件名是book，后缀名是json)，这个book.json就是电子书的配置文件，可以在里面填一些常见的配置。
关于 book.json 的配置项有很多，我们可以在网上搜索“GitBook book.json”找到。这里大致列举一些。
1、常规配置如下：
配置 book.json 的示例如下：
{
"title": "前端入门和进阶图文教程",
"description": "前端入门到进阶图文教程，超详细的Web前端学习笔记。从零开始学前端，做一名精致优雅的前端工程师。公众号「千古壹号」作者。",
"author": "千古壹号",
"language": "zh-hans",
"gitbook": "3.2.3",
"root": "."
}备注：上面的root根目录为当前目录，使用默认的就好，此项可以删掉，这里仅做演示。
2、pdf 的配置如下：(使用 book.json 中的一组选项来定制 PDF 输出)
配置项 | 描述 |
pdf.pageNumbers | 将页码添加到每个页面的底部(默认为 true) |
pdf.fontSize | 基本字体大小(默认是 12) |
pdf.fontFamily | 基本字体样式(默认是 Arial) |
pdf.paperSize | 页面尺寸，选项有：a0、a1、 a2、 a3、a4、a5、a6、b0、b1、b2、b3、b4、b5、b6、legal、letter (默认值是 a4) |
pdf.margin.top | 上边距(默认值是 56) |
pdf.margin.bottom | 下边距(默认值是 56) |
pdf.margin.left | 左边距(默认值是 62) |
pdf.margin.right | 右边距(默认值是 62) |
定制 PDF 文档输出格式的示例代码如下：
{
"pdf": {
"pageNumbers": false,
"fontSize": 12,
"paperSize": "a4",
"margin": {
"top": 36,
"bottom": 36,
"left": 62,
"right": 62
}
}
}备注：如果你不需要对输出的 pdf 做任何特定的配置，则不需要添加上面的内容，让 pdf 的输出格式保持默认就好。
3、plugins 插件：
插件及其配置在 book.json 中指定，让电子书的配置能力更加强大。
通过插件，我们可以做很多事情，比如：修改页眉页脚、自动生成并显示图片的标题等。
另外，针对在线版的 GitBook 电子书，也有很多插件，这里列举几个：
- 自带的 search 插件不支持中文搜索，使用起来非常不方便，还好
search-pro插件横空出世，让搜索功能焕发出新的生机。插件地址：地址：https://github.com/gitbook-plugins/gitbook-plugin-search-pro - 默认侧边栏宽度是不能够调节的，如果想通过拖拽的方式自由调节侧边栏宽度，可以使用插件
splitter。插件地址：https://github.com/yoshidax/gitbook-plugin-splitter - donate 插件支持定义和显示支付宝和微信打赏。插件地址：http://github.com/willin/gitbook-plugin-donate
关于插件的具体配置，感兴趣的同学可以自行研究下。
自动生成目录(重要)
如果你的电子书素材里有很多 markdown 文件，那么，如何将多个 markdown 文件的文件名，在SUMMARY.md里快速生成对应的目录？
难道要一个一个地手动 copy 吗？这不可能。
说白了，这个需求就是：如何自动生成电子书的目录？改变世界的程序员用「脚本」就能搞定，一键执行。
网上有很多好用的脚本，我给你推荐一个亲测好用的脚本：
GitBook 自动生成目录的脚本：https://github.com/fushenghua/gitbook-plugin-summary
操作方法很简单，把上面这个链接中的项目下载下来，进入到这个项目的目录，执行 $ python gitbook-plugin-summary.py dirPath 即可自动生成电子书的目录，亲测有效。备注：这里的dirPath指的是你的电子书目录的绝对路径。
对了，在执行上面这个脚本之前，记得先安装 Python 环境。
电子书用什么软件打开
用什么软件打开 PDF
Windows 平台：可以用「福昕阅读器」或者「Acrobat Reader DC」。「福昕阅读器」既有 Windows 平台，也有 Mac 平台。
Mac 平台：可以用自带的「预览」打开。
其实，不管你用的是 Windows 电脑还是 Mac 电脑，你都可以用 Chrome 浏览器打开 PDF。
iPhone 或 iPad 平台：可以用自带的「iBooks」打开，或者用「WPS Office」打开。也可以用第三方软件「GoodReader」，不过需要 40 人民币。
Android 手机：可以用「WPS Office」等第三方办公软件打开。
用什么软件阅读 ePub 电子书
Windows 平台：可以用「calibre」软件阅读 epub 电子书。
Mac & iPhone & iPad 平台：用自带的「iBooks」阅读即可。iBooks 可以非常方便地对电子书进行标注和搜索，无疑是体验最好的 ePub 电子书阅读软件。
Android 手机：可以用「多看阅读」App 来阅读 epub 格式电子书。
用什么方式阅读 mobi 电子书
kindle 电子书有两种常见的电子书格式：「mobi」格式和「azw3」格式。
- 针对 mobi 格式的电子书，你既可以通过邮件的形式将其发送到 kindle 阅读器(可以自行网上查一下相关教程)，也可以将其拷贝到 kindle 阅读器(是连接 usb 进行拷贝)。
- 针对 azw3 格式的电子书，就只能通过拷贝的形式(是连接 usb 拷贝)传输到 kindle 阅读器。
小结
我在 2017 年 1 月写过一篇电子书科普的文章，快三年过去了，如今回过头来看，那篇文章一点也不过时，不妨看看：《电子书有哪些常见格式？以及该怎样阅读它》
最后一段
如果你一时半会儿找不到可用的素材来制作电子书，可以拿我的项目练练手。项目地址：
我用上面的项目制作成了一个电子书。在“千古壹号”的公众号后台回复“pdf”，给你看看我制作的电子书效果。
不瞒你说，这篇文章，我在一年多以前就写好了初稿并放在了 GitHub 上，当时专门折腾过一次。
最近几天，我突然又有了制作电子书的需求。一年多过去了，我还以为有啥新的方法可以试试，然而我在网上找了一圈，好用的方法还是没变。所以，我今天整理一下发出来，希望让更多人看到。
其他的各种自制电子书的方法我都试过了，都不太好使，唯独 GitBook + calibre 是最佳选择，信我没错！
参考链接
- GITBOOK 使用：https://kuang.netlify.app/blog/gitbook.html
- GitBook 制作 Kindle 电子书详细教程：https://github.com/fushenghua/gitbook-plugin-summary/blob/master/gitbook-guide.md
- gitbook-plugin-summary 工具(自动生成目录)：https://github.com/fushenghua/gitbook-plugin-summary
- gitbook-plugin-atoc(自动生成目录的插件)：https://github.com/willin/gitbook-plugin-atoc
- 自动生成目录：https://github.com/mofhu/GitBook-auto-summary
- 使用 Gitbook 打造你的电子书：
- 书籍《了不起的 Markdown》的第 8 章：自由地写作——GitBook
- gitbook 的 book.json 配置示例：https://blog.ujwd.cn/archives/349
- 关于更加详细的 book.json 文件配置：https://zhousiwei.gitee.io/mybook/notes/gitbook_config.html
- GitBook 简明使用教程：https://www.phpjieshuo.com/archives/153/
- gitbook 入门教程之导出电子书：
- GitBook 插件整理 - book.json 配置：
- 如何把 Markdown 文件批量转换为 PDF(不好用)：https://sspai.com/post/47110
