gitbook

Gitbook与Docker 最近在学习k8s容器相关，了解了docker的优势，而本身对于特别在意环境的干净，之前的Gitbook不想安装原因，是因为要安装node等信息。借此机会尝试下使用docker进行安装。 1. Docker安装 这个比较简单，直接官网下载安装，无异常 2. docker-compose 编写 # 在对应的目录下创建compose的yaml文件，我放在`Workspaces/Docker/GitBook`下 services: gitbook: image: bloodstar/gitbook-builder ports: - "4000:4000" volumes: - ./gitbook:/gitbook command: gitbook build 由于我只是使用gitbook的build，不需要serve，所以端口无所谓 3.command命令修改 3.1 初始化 修改command命令为gitbook init 3.2 插件安装 修改command命令为gitbook install，这中间会存在异常，主要是网络连接github会有一定问题 3.3 编译 修改command命令为gitbook build 4. 异常处理 4.1 初始化失败 直接建README.md SUMMARY.md 两个文件后 4.2 插件安装失败 需要特殊渠道，让服务可以可以访问 5. 部署 使用nginx做代理，直接root指向Workspaces/Docker/GitBook/gitbook/_book目录 到对应的目录夹下，运行命令docker-compose up -d

环境 nodejs nodejs目前的版本比较高，如果直接使用14版本，会存在gitbook安装失败，最好使用12版本 yum install nodejs # 检查是否安装成功 node -v 安装 npm install -g gitbook-cli # 检查是否安装成功 gitbook --version # 出现错误 `cb.apply is not a function`，修复方法，详见`https://mizeri.github.io/2021/04/24/gitbook-cbapply-not-a-function/` # 修改`/usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js`文件的65行起3行，具体内容如下 // fs.stat = statFix(fs.stat) // fs.fstat = statFix(fs.fstat) // fs.lstat = statFix(fs.lstat) 生成book 如何 html gitbook build ./Thief ./ThiefTarget/ 配置nginx server { listen 80; listen [::]:80; listen 81 http2; server_name gitbook.micah.wiki; root /xxx; location / { } location = /robots.txt {} } server { listen 443 ssl; server_name gitbook....