GitBook的使用方式，快速创建网页文档

gitbook的安装方式有硬性要求，如果这么操作就会报错。

第一步安装gitbook-cli

npm install -g gitbook-cli

第二步安装gitbook

gitbook -V

出错信息

如果不是按照上面这种安装方式就会报错：

You need to install "gitbook-cli" to have access to the gitbook command anywhere on your system.
If you've installed this package globally, you need to uninstall it.
>> Run "npm uninstall -g gitbook" then "npm install -g gitbook-cli"

创建网页文档

这时候可以开始创建写网页文档模板了

新建一个你要写网页文档的文件夹

在当前文件夹下启动cmd执行：

gitbook init

创建成功，这时候我们可以看见文件夹下出现了两个文件README.md 和 SUMMARY.md 

README.md 是说明文档，而 SUMMARY.md 其实就是书的章节目录

预览书籍

接下来，我们执行：gitbook serve ，然后在浏览器地址栏中输入 http://localhost:4000 便可预览书籍

浏览器显示：

 

md转html实现离线阅读

当我们不想开启服务器，可以执行：

gitbook build

这时候我们就可以直接本地打开_book文件夹下的index.html

SUMMARY.md

这个文件主要决定 GitBook 的章节目录，它通过 Markdown 中的列表语法来表示文件的父子关系，如下：

对应的目录就是下面这样