blog portrait
"My name is woody,but i am coder not director."
woody
Tianjin 天津
woodyhello@gmail.com
发布工具
爱丫,图
坐标转换
回到首页
a good image

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