定制化gitbook
服务
Docker
- 安装docker服务:
https://docs.docker.com/install/#supported-platforms
- 安装docker-compose:
https://docs.docker.com/compose/install/
- 进入根目录执行
docker-compose up -d
本地运行
- 安装 GitBook-cli
npm install gitbook-cli -g
- cmd切到book路径下,gitbook 初始化SUMMARY
gitbook init
注: 超过node10的版本,需替换掉/xxx/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js文件,或注释掉61-63
- 下载依赖项,执行
gitbook install
注: 4,5可选一个执行
- 服务形式启动,默认端口4000:执行
gitbook serve
- 构建成静态文件:执行
gitbook build
,使用代理工具,如下是nginx的例子
location /gitbook {
alias /xxx;
index index.html index.htm;
try_files $uri $uri/ /gitbook/index.html;
charset utf-8;
}
- 在./book文件夹下创作
- 使用markdown语法进行开发
- 在summary.md文件配置目录结构