gitbook制作电子书

GitBook 是一个开源的文档编辑和托管平台 ，用于创建和维护文档、手册和电子书。它基于 Markdown 和 Git 技术，帮助用户方便地编写、编辑和发布文档。

GitBook 支持将文档输出为多种格式，包括网页、PDF、ePub 等，适用于不同的阅读和分享场景。

GitBook 还提供了团队协作的功能，可以方便多人共同编辑和维护文档。

从功能角度，可以把 gitbook 看作网页版的 obsidian 或者 hexo。gitbook工具实现前端，用户只需要关心文档的内容，遵循gitbook定义的规范，然后使用gitbook提供的命令行工具即可。

从逻辑角度看，它以主题为中心，可以把一个系列的文章梳理集中在同一主题之下，更有章法，适合用来写书或者手册。

其底层基于 Markdown，git，以及一些前端和文档转换技术。

用法和 vue, react, hexo 这些前端工具差不多。

GitBook 的客户端工具是 GitBook CLI，它是一个命令行的工具，用于创建、构建和发布 GitBook 项目；使用 JavaScript 编写的，依赖于 Node.js 环境。

其主要功能包括：

下载可用的 node docker 环境

shell 复制代码

$ docker pull node:9
$ docker run --rm -it -name node_9 --network host -v /exports/:/opt/xieyan  node:9 bash

注意：这个项目产生比较早，使用最近的工具链可能出现各种问题。l建议使用低版本的 node，否则可能因为工具链版本不匹配报graceful-fs 包相关的错误，我用 node 16 docker 后试降 graceful-fs 版本，但没有成功。

shell 复制代码

$ npm install gitbook-cli -g
$ gitbook --version # 第一次使用时自动安装 gitbook

shell 复制代码

$ mkdir book
$ cd book
$ gitbook init
$ tree -Na

shell 复制代码

$ gitbook serve --port 4001

shell 复制代码

$ gitbook build

shell 复制代码

$ gitbook pdf . 输出文件路径.pdf
$ gitbook epub . 输出文件路径.epub
$ gitbook mobi . 输出文件路径.mobi

注意：gitbook 借助 ebook-convert 实现格式转换，因此需要安装 calibre。