billryan/gitbook
billryan
自动构建
支持Unicode的GitBook Docker容器，可快速初始化、预览、构建GitBook文档，并生成PDF、EPUB等格式，无需本地安装GitBook环境即可使用。
21 次收藏下载次数: 0状态：自动构建维护者：billryan仓库类型：镜像最近更新：8 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
docker-gitbook
一个用于https://github.com/GitbookIO/gitbook%E7%9A%84Docker%E5%AE%B9%E5%99%A8%EF%BC%8C%E6%94%AF%E6%8C%81Unicode%EF%BC%8C%E7%81%B5%E6%84%9F%E6%9D%A5%E8%87%AA%E5%A4%9A%E4%B8%AA%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%EF%BC%88%E5%A6%82grahamc/docker-jekyll%E3%80%81tobegit3hub/gitbook-server%E7%AD%89%EF%BC%89%E3%80%82Docker Hub地址：https://hub.docker.com/r/billryan/gitbook/
镜像概述
本镜像提供GitBook完整运行环境，用户无需本地安装GitBook及依赖，即可通过Docker快速完成GitBook文档的创建、预览和构建，支持多语言字体（如中文），适用于各类文档编写场景。
核心功能
- 初始化GitBook项目：快速生成标准目录结构
- 实时预览服务：启动Web服务查看文档效果
- 构建静态文件：生成可部署的HTML文档
- 导出电子书：支持PDF、EPUB等格式
- 自定义字体：可添加特定语言字体（如中文、日文等）
使用场景
- 个人/团队编写技术文档、教程或手册
- 统一文档构建环境，避免本地依赖冲突
- 生成标准化电子书用于分享或发布
配置说明
基础命令
参考官方http://toolchain.gitbook.com/%EF%BC%8C%E5%B8%B8%E7%94%A8%E5%91%BD%E4%BB%A4%E7%A4%BA%E4%BE%8B%EF%BC%9A
bash# 初始化项目 docker run --rm -v "$PWD:/gitbook" -p 4000:4000 docker.xuanyuan.run/billryan/gitbook gitbook init # 启动预览服务（访问http://localhost:4000） docker run --rm -v "$PWD:/gitbook" -p 4000:4000 docker.xuanyuan.run/billryan/gitbook gitbook serve # 构建静态HTML docker run --rm -v "$PWD:/gitbook" -p 4000:4000 docker.xuanyuan.run/billryan/gitbook gitbook build
简化命令（别名）
在.bashrc或.zshrc添加别名：
bashalias gitbook='docker run --rm -v "$PWD":/gitbook -p 4000:4000 billryan/gitbook gitbook' # 初始化 gitbook init # 预览 gitbook serve # 生成PDF gitbook pdf .
自定义字体
若需添加特定字体，可修改Dockerfile构建：
- 新建分支（命名遵循ISO 639-2语言代码）
- 修改字体安装部分：
bash# 示例：安装中文微黑字体 RUN apt-get update && apt-get install -y fonts-wqy-microhei
许可证
https://opensource.org/licenses/MIT
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull billryan/gitbook:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"