Gitbook 生成 pdf 中文字体错乱问题解决办法

用过 Gitbook 的都知道, Gitbook 会自动生成 pdf 以提供下载, 但十分遗憾的是自动生成的 pdf 对中文的支持并不好, 经常出现字体不一致的现象, 影响阅读, 强迫症更是难以忍受.

示例：

下面针对这一问题提供简单的解决办法: 本地命令行生成 pdf 文件. 当然这种方法有一定局限性, 你需要找到托管在 github 对应的源码仓库且转换过程中不出错. (由于水平有限未能解决在线生成的pdf中文字体错乱问题, 见谅. 也就是说网站自动生成的 pdf 依旧字体错乱, 但是本地生成的pdf文件是没有这个问题的 orz... 如果是 gitbook 上的写作者的话可以本地生成 pdf 上传至网盘提供下载)

Gitbook 项目介绍

GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书，GitBook 并非关于 Git 的教程。

Gitbook 安装(以下环境是在 OS X 中进行的, 其他环境记得替换命令)

安装 Node.js

官网下载地址 || 安装参考: 在 Windows、Mac OS X 與 Linux 中安裝 Node.js 網頁應用程式開發環境

通过 NPM 安装 Gitbook

$ npm install gitbook-cli -g

查看 Gitbook 版本

$ gitbook versions

安装 Calibre

官网下载地址
OS X 需要链接到转换工具

$ sudo ln -s ~/Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin

Gitbook 本地生成文档

下载仓库(以"Mac 开发配置手册"为例)

$ git clone https://github.com/Aaaaaashu/Mac-dev-setup

注意是电子书托管的仓库地址而不是电子书的地址, 有的作者会直接给出, 没有给出的话通过作者 id 在 github 上查找, 注意替换地址. 还有一些没能找到仓库的, 可以去其他网站找一下 pdf.

进入文件夹

$ cd Mac-dev-setup

生成 HTML 文件(非必要)

$ gitbook serve

默认在当前目录下生成包含 html 网页名为 _book 的文件夹, 并启动端口为4000的预览服务器, 可通过 http://localhost:4000 预览.

生成 pdf 文件

$ gitbook pdf

默认在当前目录下生成名为 book.pdf 的文件, 类似的可生成 epub 和 mobi 文件.
这样字体正确的 pdf 文件就生成了, 对比直接从 gitbook 下载的 pdf, 体积变大了.

常见错误

本地命令经常会卡在最后一步, 经常见的如 permission denied, 即没有权限, 记得在前面添加 sudo 或直接启用 admin.
你还可能碰到许多诸如下载失败的错误, 多数情况下是墙引起的, 还请自备翻墙技巧哈.
其他的错误有插件加载失败, 错误信息里有命令提示gitbook install.
还有就是 svg 转换 png 的错误, 不影响阅读情况下可以找到对应的文件删除对应语句. 如果 svg 图片很多的话, 靠删除不能解决问题. 看了些讨论也没能解决, 如果你有解决办法, 请联系我.

写在最后

网上的一些教程由于时间太早, 有些命令已经舍弃了, 如 gitbook 的安装命令, 添加 pdf 依赖等, 还请以官方文档为准.

本文旨在解决从 gitbook 下载的 pdf 中文字体错乱问题, 更多的 gitbook 使用技巧及如何构建电子书可以参考GitBook 简明教程, 和参阅官方文档或自行 Google. 希望能对你有所帮助.

Gitbook地址 || Gitbook项目地址 || 中文文档
参考: Gitbook 使用入门