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编译( 在有些浏览器下估计不太完美 )