Home

Welcome to the docker-gitbook wiki!

gitbook 社区维护版

下面包大部分插件兼容gitbook，很容易迁移

https://github.com/honkit/honkit

gitbook-cli 的行为设计

gitbook-cli 在运行时的顺序如下：

1. 看当前项目是否安装了 gitbook（即 node_modules/gitbook）；

2. 如果没有，看你是否设置了 GITBOOK_VERSION 环境变量；

3. 如果都没有，它会：

   • 自动下载最新版本（通常是 3.2.3）

   • 存在 ~/.gitbook/versions/X.X.X/ 目录中

   • 使用下载的版本运行

报错

Q: [429:429:0518/215930.122250:ERROR:zygote_host_impl_linux.cc(90)] Running as root without --no-sandbox is not supported.

A: 这是 Chrome/Chromium/QtWebEngine 的通病：以 root 身份运行时，必须手动禁用 sandbox。

可以直接docker run时设置环境变量

docker run -ti --name="gitbook-builder" \
  -v "$PWD:/gitbook" \
  -e QTWEBENGINE_DISABLE_SANDBOX=1 \
  bloodstar/gitbook-builder \
  /bin/bash

或者进入容器之后运行 export QTWEBENGINE_DISABLE_SANDBOX=1

然后再容器中运行

cd /gitbook
gitbook install
gitbook pdf .

还可以在dockerfile中设置

# 设置 PDF 生成时所需环境变量
ENV QTWEBENGINE_DISABLE_SANDBOX=1