Gitbook 学习链接

Gitbook 学习链接：http://gitbook.hushuang.me/structure.html

1. 下载并安装node。

2、用cnpm命令安装gitbook-cli

在系统上使用gitbook命令，需要安装“gitbook CLI”，执行以下命令
//安装命令
npm install -g gitbook-cli
//卸载命令
npm uninstall -g gitbook
但npm的服务器在境外，安装cnpm后安装软件速度会更快，用下述命令可将npm指向国内镜像源：
npm install cnpm -g --registry=https://registry.npm.taobao.org
然后，用cnpm命令安装gitbook-cli，cnpm install -g gitbook-cli

3、创建自己的gitbook目录并初始化

1）创建自己的gitbook目录，mkdir d:\gitbook
2）进入自己的gitbook目录下，初始化gitbook，输入gitbook init
3）初始化后，生成HTML发布，输入gitbook build

4、启动gitbook服务

在cmd中输入gitbook serve,启动gitbook服务:

 

在浏览器访问：http://127.0.0.1:4000，就可以看到自己的电子书了！

注：启动服务前可以修改README.md，和SUMMARY.md，增加自己的markdown文件。

README.md一般是这本书的简介部分。SUMMARY.md是gitbook的目录结构，可以参照格式增加章节目录。01.md就是每个章节的markdown文件。

 

解决Gitbook目录生成问题：

gitbook不支持markdown的TOC命令自动生成目录。

解决方案：

使用gitbook插件gitbook-plugin-toc。
在book.json中添加

{
    "plugins": ["toc"]
}

在book.json所在目录运行gitbook install，安装完成后，在使用TOC命令的地方使用<!-- toc -->代替。即可自动生成文档目录。