gitbook实战 （可适用个人笔记、项目在线使用手册、个人博客等场景）

最近项目进行到一定阶段，开始准备写用户手册了，但是传统用word来写用户手册，用户查阅起来不太方便，后续项目更新后，用户手册更新，还得在发送给用户，较为繁琐，所以结合之前经验，采用在线的方式来写用户手册，将链接挂在系统内，用户点击即可在线阅读用户手册，手册更新后，用户也不需要做任何操作，点击手册链接，即可获取最新的使用说明，有点类似现在的金山、腾讯等在线文档，话不多说，开始记录。 效果图：

本地文件效果图：

我们在demo文件夹里新增系统管理和区域管理两个文件夹，为了分类管理，用来存放md写书文件。 新增一个assets文件夹用来存放图片、视频资源。 新增styles文件夹，用来修改书籍样式。 新增一个book.json,用来安装插件，让我们的书更友好。

进入命令行，重启服务，打开本机4000端口。 点击左侧导航栏，即可切换不同的文件说明。 基本上至此我们的框架已基本建立完毕，下面说一下如何运用插件、样式去优化书籍,可以看到我们左侧导航目录是没有折叠的，在目录层级特别多的时候，就不好阅读了，可以在在我们的demo文件里新增一个book.json文件，在里面写我们需要安装的插件。 book.json文件内容：

可以看到 我们还引用了一个样式文件夹，我们在demo文件夹内新增styles文件夹，新增website.css文件。 website.css

新增文件并填充完毕后，进入命令行，demo文件路径下执行gitbook install，表示我们要安装book.json里面的插件，一定要执行该命令，不然会报错，安装成功后，运行gitbook serve，查看效果。 更多插件效果，大家可以查看这篇帖子写的比较详细 http://gitbook.zhangjikai.com/plugins.html

除此之外，还可以在md文件里面插入图片，插入视频来丰富我们的书籍，这里为大家举一个小例子，在demo路径下新建一个assets文件夹，里面存放书籍里所有的音视图片资源，网上随便找一个图片扔进去，然后在系统管理文件夹内的role.md文件里引入，输入 产品简介.jpg代表了那个图片的名称和类型，进入命令行，重启服务，效果如下。