一、Gitbook是什么
GitBook 是一个基于 Node.js 的命令行工具，支持 Markdown 和 AsciiDoc 两种语法格式，可以输出 HTML、PDF、eBook 等格式的电子书。所以，GitBook 不是 Markdown 编辑工具，也不是 Git 版本管理工具。
- Markdown编辑器对比（推荐使用vscode、Typora 、Gitbook官方编辑器）
| 名称 | 说明 | 平台 | 是否免费 |
|---|---|---|---|
| Visual Studio Code | 插件：Paste Image、Docs Markdown、Markdown Preview Enhanced | Mac OS、Windows、Linux | 免费 |
| Typora | 支持实时预览的 Markdown 文本编辑器 | Mac OS、Windows、Linux | 免费 |
| MacDown | Mac OS | 免费 | |
| Bear | 笔记应用中的瑞士军刀 | Mac OS 、iPhone、iPad | 免费+内购 |
| MarkdownPad | Windows下的一个多功能Markdown编辑器 | Windows | 免费+收费 |
| MarkdownX | Android轻量级编辑器 | Android | 免费 |
二、安装、使用Gitbook
首先安装node.js，node版本要求：V4.0.0以上。按步骤执行如下命令
1、通过npm，全局安装Gitbook ，执行命令npm install gitbook-cli -g
2、查看是否安装成功，gitbook -V
3、在 mybook 文件夹（初始化）创建一本书gitbook init，会自动生成两个必要的文件 README.md 和 SUMMARY.md。
README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置
4、预览书籍gitbook serve . --port 4200。此时可以通过http://localhost:4200/预览
5、编辑 SUMMARY.md 文件，内容修改为：
# Summary
* [简介](README.md)
* [1.Docker入门](chapter1/README.md)
* [1.1 什么是Docker](chapter1/section1.md)
* [1.2 Docker基本概念](chapter1/section2.md)
* [1.3 安装Docker](chapter1/section3.md)
* [1.4 使用Docker镜像](chapter1/section4.md)
* [1.5 操作容器](chapter1/section5.md)
* [1.6 访问仓库](chapter1/section6.md)
* [1.6 数据管理](chapter1/section7.md)
* [2.使用Docker部署web应用](chapter2/README.md)
* [2.1 编写DockerFile](chapter2/section1.md)
* [2.2 编写web应用](chapter2/section2.md)
* [2.3 构建镜像](chapter2/section3.md)
* [2.4 运行web应用](chapter2/section4.md)
* [2.5 分享镜像](chapter2/section5.md)
* [结束](end/README.md)
6、在 mybook 文件夹中再次执行 gitbook init 命令。GitBook 会查找 SUMMARY.md 文件中描述的目录和文件，如果没有则会将其创建。
7、发布书籍，执行
gitbook build命令构建书籍，默认将生成的静态网站输出到 _book 目录。
gitbook build [书籍路径] [输出路径]
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub
gitbook mobi ./ ./mybook.mobi
辅助工具： ebook-convert。 Typora + Pandoc 进行导出。
三、fixbugs
1、用gitbook想生成HTML，执行了gitbook serve时报错：Error: ENOENT: no such file or directory, stat 'C:UserscjfGitBookLibraryImportprepare_bookgitbookgitbook-plugin-fontsettingsfontsettings.js'
在book目录下，如下代码新建book.json，将如下代码copy&paste。保存文件后，运行gitbook install安装插件依赖。重新执行gitbook serve
{
"plugins": [
"fontsettings",
"sharing",
"lunr",
"search",
"highlight",
"livereload"
]
}
其他办法：我使用gitbook serve遇到同样的问题，改为 gitbook serve .\ 就OK了。我是win10平台，gitbook 3.2.3
参考地址：
1、http://www.lijiam.com/part2/gitbook/install.html
2、https://www.cnblogs.com/xiaoqi/p/8194350.html
