使用gitbook编写电子书、文档、博客

一、检查node版本

node -v 查看node版本，gitbook停止更新好久了，高版本的node可能不兼容，我使用的node版本是 10.12.0，推荐使用nvm下载多版本的node

一、下载安装GitBook

1、下载

已经安装过的先删除老版本的gitbook

npm uninstall -g gitbook
npm uninstall -g gitbook-cli

之后下载安装gitbook

npm install -g gitbook-cli

gitbook -V 查看gitbook版本

可以看到

CLI version: 2.3.2
GitBook version: 3.2.3

这里注意使用3.2.3版本的gitbook会出现很多问题，比如：
初始化的时候会出现这样的报错

所以我们要变更一下gitbook的版本

2、变更gitbook版本

首先卸载3.2.3版本的gitbook

gitbook uninstall 3.2.3

之后安装3.0.0版本的，我测试了几个发现3.0.0版本的不会报错

gitbook build --gitbook=3.0.0

安装完成之后查看gitbook版本

gitbook -V

可以看到gitbook版本为3.0.0，成功变更版本。

其他的gitbook命令：

gitbook -V 查看版本号
gitbook ls 列出本地所有的gitbook版本
gitbook init 初始化
gitbook install 安装插件
gitbook serve 预览
gitbook build 生成
gitbook build --gitbook=2.6.7 生成时指定gitbook的版本, 本地没有会先下载
gitbook uninstall 2.6.7 卸载指定版本号的gitbook
gitbook fetch [version] 获取[版本]下载并安装<版本>
gitbook --help 显示gitbook-cli帮助文档
gitbook help 列出 gitbook 所有的命令
gitbook ls-remote 列出NPM上的可用版本：

二、初始化gitbook

初始化

gitbook init

可以看到会自动生成一堆文件，之后找到 SUMMARY.md，在里面写文档的目录即可，比如我的目录是这样的：

之后再次运行

gitbook init

就可以自动生成文件了。

三、其他命令

gitbook init  //初始化
gitbook serve  //本地预览
gitbook build  //打包
gitbook build ./ ./book  //打包到book文件夹

最后贴一下我用gitbook建的博客，https://zhenyuyyk.github.io/