gitbook编写文档

一、编辑器

1、编辑器可以使用官方的

https://www.gitbook.com/editor

2、输出离线pdf\html

由于最新的editor不再支持输出离线，所以要配合gitbook 2.6.7的本地命令行工具实现

二、配置gitbook 本地命令行工具步骤（以mac为例）：

1、安装npm ,https://nodejs.org/en/  下载Node.js ，首页会自动识别你的系统，直接点绿色的按钮即可。推荐LTS版本

2、在终端执行 sudo -s 

3、在终端执行  npm install -g gitbook-cli

4、在终端执行 gitbook -V 查看gitbook是否安装成功

三、输出离线html

1、找到editer编辑好的文档目录

2、在终端执行 gitbook build --gitbook=2.6.7 ,将在目录下生成一个_book的文件夹。里面的Index.html即为主页

注意事项：一定要加--gitbook=2.6.7，否则生成的html左边导航栏无法跳转

最新的npm编译2.6.7版本会失败，需要将npm切换到6版本。

sudo npm install -g n

sudo n 6