https://github.com/soulteary/docker-gitbook-pdf-generator

如果你想使用 GitBook 生成 PDF ，又不想折腾，使用这个项目就对啦！
https://github.com/soulteary/docker-gitbook-pdf-generator

gitbook gitbook-docker pdf-generation

Last synced: 16 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/soulteary/docker-gitbook-pdf-generator
• Owner: soulteary
• License: mit
• Created: 2019-05-07T13:16:15.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2020-08-18T03:30:10.000Z (over 4 years ago)
• Last Synced: 2025-01-23T03:30:16.992Z (30 days ago)
• Topics: gitbook, gitbook-docker, pdf-generation
• Language: Dockerfile
• Homepage: https://soulteary.com/2019/05/07/generate-small-gitbook-pdf-using-the-docker-with-python.html
• Size: 6.84 KB
• Stars: 197
• Watchers: 3
• Forks: 35
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

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.