解決 Gitbook 匯出 PDF 檔案時沒有產出的問題

先前嘗試使用 Gitbook 匯出 PDF 檔案時，發生沒有結果，也沒有回報任何錯誤的問題，經查發現是 Calibre 版本問題所致，在此記錄。

環境

  • macOS Mojave 10.14.6
  • calibre 4.6.0
  • gitbook-cli 2.3.2
  • GitBook version: 3.2.3

問題描述

按 文件 說明，在編寫 gitbook 的目錄下，以下指令應該產生一個 PDF 檔案：

1
$ gitbook pdf ./ ./mybook.pdf

在 Terminal 上顯示類似以下的輸出，持續很長時間無結果，也沒有任何的錯誤回報：

1
2
3
4
5
6
7
8
9
10
info: 7 plugins are installed
info: 6 explicitly listed
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 3 pages
info: found 2 asset files

因此，再次執行以下指令後查看更詳細的 log 訊息：

1
$ gitbook pdf ./ ./mybook.pdf --log=debug —debug

然後在 Terminal 上顯示類似以下的輸出：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
debug: Auto generated TOC with 3 entries.
debug: Flattening CSS and remapping font sizes...
debug: Source base font size is 12.00000pt
debug: Removing fake margins...
debug: Cleaning up manifest...
Trimming unused files from manifest...
debug: Creating PDF Output...
debug: 67% Running PDF Output plugin
debug: 68% Parsed all content for markup transformation
debug: 70% Completed markup transformation
debug: [1106/220730.806158:ERROR:icu_util.cc(177)] Invalid file descriptor to ICU data received.
[1106/220730.806170:ERROR:icu_util.cc(177)] Invalid file descriptor to ICU data received.
debug: [1106/220730.806054:ERROR:icu_util.cc(177)] Invalid file descriptor to ICU data received.
debug: [1106/220730.812668:ERROR:icu_util.cc(177)] Invalid file descriptor to ICU data received.

解決方法

在 stackoverflow 上找到一則同樣問題的解決方法，總之就是將 calibre-ebook 版本從 4.X 降至 3.x 即可。可以在這個 頁面 上找到 calibre-ebook 3.x 的版本。

安裝完成後，重新執行以下指令後順利產生 PDF 檔案。

1
$ gitbook pdf ./ ./mybook.pdf

參考資料