起因#
在 Github 上有许多电子书是以 Markdown 文件形式编写的，它们通常是由若干个文件夹包括若干个 md 文件构成的。这种 Repo 可以使用 GitBook 构建成网页，可供在线浏览。我想将这些文件转换成 epub 格式并导入到自己的阅读器中阅读，以便更方便地管理注释。
在网页上查询后发现 gitbook 有命令行版本，可以生成 html/pdf/epub。下载之后发现初始化的时候会报错：
Installing GitBook 3.2.3
/opt/homebrew/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287
if (cb) cb.apply(this, arguments)
^
TypeError: cb.apply is not a function
at /opt/homebrew/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287:18
at FSReqCallback.oncomplete (node:fs:192:5)
Node.js v19.7.0
查了一下报错，发现是 gitbook 命令行的依赖版本太老了，而且 gitbook 命令行已经不再开发更新。在 Stack Overflow 上发现有人推荐了 honkit，一个 gitbook 的 fork。
流程#
安装 honkit#
在使用 honkit 之前，需要先安装 Node.js。
安装 honkit：
$ npm init --yes
$ npm install honkit --save-dev
安装 Calibre#
下载 Calibre 并安装。
Windows 下需要将 Calibre 安装路径添加到环境变量。
Mac 下需要使用如下命令：
$ sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
转换：#
在文件夹内初始化：
$ npx honkit init
会生成如下形式的文件结构：
.
├── files
├── README.md
└── SUMMARY.md
其中，README.md 文件包含书籍的前言或介绍信息，SUMMARY.md 文件则包含书籍的内容目录。
接下来，可以根据书籍的内容编写目录。假设该书的内容结构如下：
.
├── ch1
│ ├── ch1.1.md
│ └── ch1.2.md
└── ch2
└── ch2.1.md
SUMMARY.md的内容应该是
# Summary
### ch1
* [ch1](ch1/ch1.1.md)
* [ch1](ch1/ch1.2.md)
### ch2
* [ch2](ch2/ch2.1.md)
如果书籍内容较多，可以使用 ChatGPT 来加速目录文件的构建。使用 tree 命令获取文件结构，将目录要求和文件结构发送给 ChatGPT，就可以生成目录文件了。
如果需要自定义书籍元信息，需要在当前文件夹下新建 book.json 文件。
以下是一个示例：
{
"root": "./",
"title": "xxx",
"author": "xxx"
}
更多自定义选项可以参考官方文档。
在我的经验中，如果在元数据中使用中文可能会出现一些问题。因此，我建议使用默认设置生成电子书，并将电子书导入到 Calibre 中编辑元数据。编辑完成后，转换书籍即可应用元数据。这样更为直观和简单。
如果想要添加封面，可以在目录下添加 cover.jpg 文件。
设置完成后，即可构建电子书。命令如下：
$ npx honkit build
$ npx honkit pdf
$ npx honkit epub
这样可以生成 html/pdf/epub 文件了。
Docker 使用#
我更推荐直接使用 Docker 版本，更加方便，只需在目录下执行命令即可。
docker pull honkit/honkit
docker run -v `pwd`:`pwd` -w `pwd` --rm -it honkit/honkit honkit build
docker run -v `pwd`:`pwd` -w `pwd` --rm -it honkit/honkit honkit pdf
docker run -v `pwd`:`pwd` -w `pwd` --rm -it honkit/honkit honkit epub
其他#
这个方法也可以用来把一些网页专栏制作成 epub 电子书。流程是先用 简悦 将网页转换成 Markdown 文件并保存，然后再用 Honkit 将其转换成 epub，这样就可以导入到 Apple Books/Readwise Reader 等阅读器中查看并管理标注。