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 使用入門