gitbook 使用命令

我用的是mac pro本，因为硬盘存储空间有限，同时gitbook的客户端用户交互感一般，所以我不推荐下载。

我一般是在线编写文章后，用命令下载同步到本地，在生成html。我喜欢用离线的html文档形式，无论是编写api还是技术文档查看传阅都很方便。

我写这篇文章是2018年2月，引用gitbook升级版频繁并且前后的命令和操作方式不一致，所以请慎重参考。

1. 下载gitbook

sudo npm install -g gitbook-cli

2. 创建目录并初始化

mkdir test
cd test
git init                      #初始化git
git pull http://url.git       #将网站上的book下载同步到本地

1. 生成html文档

gitbook build --gitbook=2.6.7

好像从 3.0.0 版起, gitbook build 生成的 website 就不支持 local 打开了（其实也能打开，会有问题如点击左侧目录并不跳转的问题）, 必需要 webserver 开启;

实在要完全静态的, 需要以 2.6.7 版build编译( 在有些浏览器下估计不太完美 )