support gitbook 3.2.3, 其他版本自测, 解决 gitbook 太慢的问题
gitbook 3.2.3 为历史项目,插件下载需要整体拉取,非常缓慢,也不支持单个拉取,这样gbook
就应运而生了,
配置好后将有以下特性:
- 拉取插件特别快
- 不用频繁的切换 node 版本
node
<= 10, 建议 Node 版本 10.24.1gitbook-cli
必须- 请自行设置好 npm 加速镜像,如淘宝镜像,建议使用
nrm
设置
将 BOOK_NODE_HOME 变量设置为需要的 node 版本路径,加入到系统变量中, 这样gbook
会使用对应 node 版本执行命令了,不再受全局其他版本 node 影响。
gbook install
将是核心功能,你只需关注该命令即可
version: "3.7"
services:
gbook-doc:
image: q9090960bnb3/gbook
ports:
- "4000:4000"
volumes:
- .:/doc
working_dir: /doc
command: bash -c "gbook install && gbook serve"
以上可使用 docker 快速构建 gbook 文档, 如果自己写好了文档也可参考进行构建
- 在 https://github.com/gofulljs/gbook/releases 获取二进制版本直接使用
- 源码安装
go install github.com/gofulljs/[email protected]