Gitbook 生成 pdf 中文字体错乱问题解决办法
Posted Tsingke
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Gitbook 生成 pdf 中文字体错乱问题解决办法相关的知识,希望对你有一定的参考价值。
Gitbook 生成 pdf 中文字体错乱问题解决办法
示例:
下面针对这一问题提供简单的解决办法: 本地命令行生成 pdf 文件. 当然这种方法有一定局限性, 你需要找到托管在 github 对应的源码仓库且转换过程中不出错. (由于水平有限未能解决在线生成的pdf中文字体错乱问题, 见谅. 也就是说网站自动生成的 pdf 依旧字体错乱, 但是本地生成的pdf文件是没有这个问题的 orz... 如果是 gitbook 上的写作者的话可以本地生成 pdf 上传至网盘提供下载)
Gitbook 项目介绍
GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书,GitBook 并非关于 Git 的教程。
Gitbook 安装(以下环境是在 OS X 中进行的, 其他环境记得替换命令)
- 通过 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.
你还可能碰到许多诸如下载失败的错误, 多数情况下是墙引起的, 还请自备FQ技巧哈.
其他的错误有插件加载失败, 错误信息里有命令提示gitbook install
.
还有就是 svg 转换 png 的错误, 不影响阅读情况下可以找到对应的文件删除对应语句. 如果 svg 图片很多的话, 靠删除不能解决问题. 看了些讨论也没能解决, 如果你有解决办法, 请联系我.
写在最后
网上的一些教程由于时间太早, 有些命令已经舍弃了, 如 gitbook 的安装命令, 添加 pdf 依赖等, 还请以官方文档为准.
本文旨在解决从 gitbook 下载的 pdf 中文字体错乱问题, 更多的 gitbook 使用技巧及如何构建电子书可以参考GitBook 简明教程, 和参阅官方文档或自行 Google. 希望能对你有所帮助.
Gitbook地址 || Gitbook项目地址 || 中文文档
参考: Gitbook 使用入门
以上是关于Gitbook 生成 pdf 中文字体错乱问题解决办法的主要内容,如果未能解决你的问题,请参考以下文章