目录
一、简介
制作电子书的工具有很多，常用的免费工具推荐：
- 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 -vnpm -v

2. 安装gitbook
# 注意 -g 参数npm install -g gitbook-cli
安装之后会多出一个 gitbook 的命令，直接操作就可以了
三、使用
新建文件夹test，作为一本书，并完成初始化
mkdir testcd 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
- 下载地址：
安装之后，建立软链
ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin/ebook-convert