目录
一、简介
制作电子书的工具有很多,常用的免费工具推荐:
- Sigil Ebook Editor
- 应是最早的电子书制作软件(大概在10年左右就有了)
- 可视化编辑内容、插入封面、编辑作者、生成目录
- ePUBee Maker(ePUBee智多星)
- 一款Microsoft Word的插件,将Word文档无损的存为电子书
- 可导入电子书进行编辑,完美的编辑内容与元数据信息
- GitBook
- 同GitHub一样,将电子书作为一个工程,方便的控制版本
- 提供GitBook Editor直接集成GitBook、Git、Markdown等功能
我选择的是GitBook,因为我是程序员,对git有不一样的信赖。
此文主要对在MacOS上使用GitBook做入门级说明。
二、安装
其实可以直接使用homebrew来安装,这里不做具体说明,命令如下:
brew cask install gitbook gitbook-editor
我采取的的方式是安装 gitbook-cli,具体方式如下:
1. 安装node.js
因为gitbook基于node.js,所以需要先安装node
# 可以先 brew search node 查看版本,然后安装你想要的版本
brew install node
查看版本,即安装是否成功
node -v
npm -v

2. 安装gitbook
# 注意 -g 参数
npm install -g gitbook-cli
安装之后会多出一个 gitbook 的命令,直接操作就可以了
三、使用
新建文件夹test,作为一本书,并完成初始化
mkdir test
cd test
# 初始化
gitbook init
第一次执行时间会比较长,看到如下内容即为成功
执行后在test目录中会生成如下两个文件
- README.md:书籍的介绍写在这个文件里
- SUMMARY.md:书籍的目录结构在这里配置

编辑这两个文件输入任意内容,目录格式举例
注明:我这里使用的是 Typora 做为markdown编辑器
编辑内容之后,回到终端,再次执行
gitbook init
,生成目录,如图:
然后我们就可以编辑自己的电子书了
四、常用命令
1. 初始化 或 编辑目录
gitbook init
2. 编辑内容之后编译书籍
可以指定目录,默认当前
gitbook build [书籍路径] [输出路径]
3. 启动web服务通过浏览器预览数据
默认端口4000
gitbook serve --port 1234
4. 生成电子书
# 生成 PDF 格式的电子书
gitbook pdf ./ ./book_name.pdf
# 生成 epub 格式的电子书
gitbook epub ./ ./book_name.epub
# 生成 mobi 格式的电子书
gitbook mobi ./ ./book_name.mobi
初次生成电子书的时候,可能会出现如下错误:

解决方式:根据提示通过安装calibre-ebook来安装ebook-convert
- 下载地址:https://calibre-ebook.com/dist/osx
安装之后,建立软链
ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin/ebook-convert