# docker-gitbook-pdf-generator

**Repository Path**: the-thinker/docker-gitbook-pdf-generator

## Basic Information

- **Project Name**: docker-gitbook-pdf-generator
- **Description**: gitbook转换成pdf
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-08
- **Last Updated**: 2024-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Docker Gitbook PDF Generator

> 如果你想使用 GitBook 生成 PDF ，又不想折腾，使用这个项目就对啦！

众所周知 GitBook 新版本调用 `calibre` 生成的 PDF 尺寸比较大，而且不支持 PDF 压缩，非常不利于传播。

经过简单的寻找，我看到 **fuergaosi233** 同学用 Python 基于 `weastprint` 编写了一个简单的 GitBook PDF [生成工具](https://github.com/fuergaosi233/gitbook2pdf)，使用下来发觉还不错，于是就封装了这个镜像，希望能够帮助到有同样需求的你。

## 使用方法

如果你生成的电子书包含中文，那么在使用之前，你需要准备至少一个字体文件，比如 `苹方`、`思源`等，将文件保存在你当前目录的 **fonts** 文件夹内。

然后直接使用 DockerHub 官方自动构建的容器镜像，配合文件挂载参数使用即可。

比如我们要将 `http://self-publishing.ebookchain.org` 的内容生成为电子书，只需要执行下面的命令：

```bash
docker run --rm -v `pwd`/fonts:/usr/share/fonts \
                -v `pwd`/output:/app/output \
                soulteary/docker-gitbook-pdf-generator:1.0.0 "http://self-publishing.ebookchain.org"
```

如果你是 Windows 用户，使用 Powershell，可以使用下面的命令：

```powershell
docker run --rm -v $PWD/fonts:/usr/share/fonts \
                -v $PWD/output:/app/output \
                soulteary/docker-gitbook-pdf-generator:1.0.0 "http://self-publishing.ebookchain.org"
```

稍等片刻，你将会看到下面的内容：

```text
crawl : all done!
Generating pdf,please wait patiently
Generated
```

这时，你当前目录会自动多出一个名为 `output` 的新目录，而电子书就会安静的躺在里面啦。

如果你觉得上面这条命令太过复杂，也可以使用仓库中的 `docker-compose.yml` 模版来进行电子书生成操作，如果你不太会使用，可以围观我博客中 `docker` 相关的使用教程，通常阅读时间都在十分钟左右， Good Luck。

## 其他

如果你对样式有更高的要求，可以使用文件挂载的方式修改 `/app/gitbook.css` 的样式。

如果你想了解更多细节，可以阅读 [这篇博客](https://soulteary.com/2019/05/07/generate-small-gitbook-pdf-using-the-docker-with-python.html)。

## 常见问题

- 运行报错
    - 报错提示 “/usr/local/lib/python3.7/site-packages/weasyprint/fonts.py:230: UserWarning: FontConfig: No fonts configured. Expect ugly output. 'FontConfig: No fonts configured. ”
    - 报错原因 字体挂载位置不正确，请参考最新文档中的命令。感谢 ISSUE 里诸位网友反馈。
- Windows 环境命令报错
    - 报错提示 “Error response from daemon: create pwd/fonts: "pwd/fonts" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed. If you intended to pass a host directory, use absolute path.”
    - 报错原因 windows 不支持 bash 标准语法，使用
- 生成 PDF 中文显示不正确，显示为“口口”
    - 解决方法：下载或者拷贝系统字体到你要挂载的目录，再次执行程序

## 协议

MIT, For Everyone.