前言
对于经常阅读的人来说,制作本地电子书,算是刚需了。网上的很多教程都不太好用,所以我特地整理出一个详细的教程。亲测有效,一劳永逸。
当你意外发现某个宝藏公众号时,想要集中阅读上面的每一篇文章,恨不得一口气看完,你会怎么做呢?你可能会把它添加到“微信读书”App 的书架上:
但上面这种曲线救国的方式并非最佳,仍然不尽人意,存在不少问题。
我知道,现在有很多的第三方服务,可以将任意公众号的文章制作成电子书,我试过很多次,但都是付费的。一听说要钱,你又不干了:
再列举一种场景:当你在 GitHub 上发现一个很全面很丰富的项目文档时,仿佛发现了新大陆。可 GitHub 网站的服务器在国外,国内的访问速度实在感人,你想要把它下载到本地查看,会怎么做呢?你估计会选择git clone
或者直接选择“Download ZIP”,然后用 Typora 或者 VS Code 软件打开这个项目文档,在本地查看:
总之,你能想到的方式,我都想到了,而且都尝试过。
现在的需求就是,如果你经常阅读网上的资料,肯定会有这样一个需求:怎么把这些几百页、甚至几千页的内容整理成 PDF、ePub、mobi等格式的电子书呢?
要么花钱请别人做,要么自己做。
今天这篇文章,就是来告诉你”自己动手制作 PDF、ePub、mobi 等格式电子书“的最佳方式。如果你是码农出身,下面讲的这些步骤,根本难不倒你。如果你不是码农出身,也没关系,只要你有一台电脑,跟着我讲的教程研究下去,肯定能搞定。
问题的关键不在于难不难、会不会,而是在于你是不是爱折腾。
制作电子书的具体步骤
整体流程
先说一下整体步骤:
(1)安装 gitbook 工具。
(2)安装 calibre 软件,配置 ebook-convert
工具。
(3)将md
格式的多个文件素材导出为电子书(支持 PDF、ePub、mobi 等格式)。
(4)高级进阶:配置电子书的目录、封面、页眉页脚等。
整理流程如下:
接下来我们看看详细的完整步骤。
编译环境
node.js和calibre版本:
- node:v12.18.4
- calibre:5.11.0
gitbook -V:
- CLI version: 2.3.2
- GitBook version: 3.2.3
步骤 1:通过 npm 安装 gitbook-cli
安装命令如下:
1 | npm install -g gitbook-cli |
安装成功之后,再执行gitbook -V
命令确认是否安装成功,此时会自动安装 GitBook:
1 | gitbook -V |
备注:如果你不知道 npm
是什么,可以自行查阅如何安装 Node.js 和 npm 环境。
如果你在执行gitbook -V
命令的时候提示错误TypeError: cb.apply is not a function
,有两个解决办法:
方法1:原因是 Node.js版本不对。Node.js 建议安装 10.X版本(比如 10.21.0 版本)。参考链接:https://www.bilibili.com/read/cv6932054/
方法2:打开文件
node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js
,将下面这三行代码注释掉:
1 | fs.stat = statFix(fs.stat) |
参考链接:https://flaviocopes.com/cb-apply-not-a-function/
步骤 2:安装 ebook-convert(针对 Windows 用户)
ebook-convert 是能够自由转化格式的一个命令行工具,已经包含在 calibre 软件里面了。
(1)安装 calibre
软件。calibre 的官网如下:(我们可以去官网下载安装)
(2)在终端输入ebook-convert --version
命令,验证 ebook-convert
是否能正常使用:
1 | ebook-convert --version |
如果输入上面的命令后提示错误,说明你还需要将 calibre 的安装目录添加到系统的环境变量中。
步骤 2:安装 ebook-convert(针对 Mac 用户)
ebook-convert 是能够自由转化格式的一个命令行工具,已经包含在 calibre 软件里面了。
(1)安装 calibre
软件。calibre 的官网如下:(我们可以去官网下载安装)
(2)配置 ebook-convert
。针对 Mac 系统,需要执行如下命令,把 ebook-convert
软链接到 bin
目录:
1 | sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin |
执行上面的命令后,如果出现Operation not permitted
异常,说明系统权限限制,此时需要配置环境变量。
(3)环境变量配置:
1 | vim ~/.bash_profile |
备注:可以自行研究下,在命令行环境,如何通过 vim 编辑文件。
然后刷新一下刚刚的配置:
1 | source ~/.bash_profile |
(4)在终端输入ebook-convert --version
命令,验证ebook-convert
是否能正常使用:
1 | ebook-convert --version |
步骤 3:配置电子书的目录
本地新建一个空的文件夹,作为我们的电子书项目。文件夹的名字随便起,但建议用英文命名。
(1)项目初始化。
在当前项目下,执行如下命令,进行初始化:
1 | gitbook init |
此时,项目下会自动生成如下两个文件:(非常重要,必不可少)
README.md
:书籍的简介放在这个文件里。SUMMARY.md
:书籍的目录结构在这里配置。
这两个文件创建后,内容为空白,可使用 Markdown 语言自定义内容。
(2)配置电子书的目录。
我们先把本地的 markdown 文件(也就是我们的电子书素材)放到项目中,然后在SUMMARY.md
文件中配置电子书的目录。
比如说, 我的项目中有下面这些文件:
那么,我在SUMMARY.md
文件中就要这样配置:
1 | # 目录 |
制作成的目录,将会是下面这种效果:
步骤 4:导出电子书
(1)本地预览电子书:
1 | gitbook serve |
执行上方命令后,工具会对项目里的 Markdown 格式的文件进行转换,默认转换为 html 格式,最后提示 Serving book on http://localhost:4000
。
我们打开浏览器输入http://localhost:4000
,预览一下电子书的效果:
(2)制作并导出电子书。接下来就是见证奇迹的时刻。
生成 PDF 格式的电子书:(PDF 是最常见的文档格式)
1 | gitbook pdf ./ ./mybook.pdf |
生成 epub 格式的电子书:(epub 是最常见、最通用的电子书格式)
1 | gitbook epub ./ ./mybook.epub |
生成 mobi 格式的电子书:(mobi 格式可以在 kindle 中打开)
1 | 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 的示例如下:
1 | { |
备注:上面的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 文档输出格式的示例代码如下:
1 | { |
备注:如果你不需要对输出的 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
使用 Gitbook 打造你的电子书:https://juejin.im/post/6844903793033740302
书籍《了不起的 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 入门教程之导出电子书:https://juejin.im/post/5caa0fb46fb9a05e5a2e53b3
GitBook 插件整理 - book.json 配置:https://www.cnblogs.com/mingyue5826/p/10307051.html
如何把 Markdown 文件批量转换为 PDF(不好用):https://sspai.com/post/47110