使用Gitbook来写作

一、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 文件中描述的目录和文件，如果没有则会将其创建。

图片.png

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