GitBook PDF/EPUB 导出工具（GitBook PDF/EPUB Export Tool）

作者为：safreya

GitBook 通用 PDF/EPUB 导出工具。支持代码高亮。

本项目基于 Python3、mistune、EbookLib 及 weasyprint。CSS 样式模仿 GitBook PDF

文件说明

文件/目录	说明
build	用于生成 PDF 的路径，默认不存在，会自动生成
mdconv.py	主程序，不可删除
start.html	主 CSS 配置文件，不可删除

其他未说明文件均可删除。

FreeBSD 14.2 RELEASE 使用说明

在 lang/python311、py311-pip、py311-mistune、py311-pygments 下测试通过。

目录结构：

我在 / 目录下创建了 gitbook-pdf-export-main 目录，并将 gitbook 项目目录整体放入了目录 h 中。

/gitbook-pdf-export-main/ ①
├── Handbook/ 
├── mdconv.py
└── start.html

安装及使用方法

# pkg install python3.11 py311-pip py311-mistune py311-pygments py311-beautifulsoup
$ pip install EbookLib weasyprint
$ cd /gitbook-pdf-export-main ①
$ python mdconv.py Handbook

① 请换成你的自己的路径

Windows 11 24H2 使用说明

如果所需文中所需文件在网络上找不到，请点击页面的“releases”，进行下载。

目录结构

C:\Users\ykla\Desktop\gitbook-pdf-export-main\
├── Handbook/ 
├── mdconv.py
└── start.html

安装方法

• 安装 Python3 和 pip3 进入 https://www.python.org/downloads/，点击“Download Python 3.xx.x”即可下载。请务必在安装时勾选 Add Python 3.x to PATH。在默认情况下，会自动安装 pip。
• 安装 gtk3-runtime 进入 https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases 下载安装“gtk3-runtime-3.24.31-2022-01-04-ts-win64.exe“即可。

gtk3-runtime 是 weasyprint 在 Windows 上的运行依赖，必须安装。

• 安装 mistune 和 weasyprint

C:\Windows\system32>pip install mistune weasyprint pygments EbookLib beautifulsoup4

使用方法

C:\Windows\system32>cd C:\Users\ykla\Desktop\gitbook-pdf-export-main ①
C:\Users\ykla\Desktop\gitbook-pdf-export-main>python mdconv.py Handbook

① 我将其放在了用户 “ykla” 桌面的“gitbook-pdf-export-main”文件夹中，并将 gitbook 项目放入了文件夹 gitbook-pdf-export-main 中。

注意

如果不知道用户名是什么，可以打开同时按快捷键 ctrl + alt + del 来打开任务管理器，点击“用户”，就能看到了，如果账户名是中文，后果将不可知，因为未经测试。

Linux/GitHub Action

参见 https://github.com/ykla/FreeBSD-Ask/actions

MacOS

待有缘人对该部分内容进行补充。欢迎 PR。