常見錯誤

這裏有一些常見的錯誤,以及如何修正的建議。


  1. Error loading plugins: plugin1, ...

出現這錯誤的原因是 GitBook 找不到指定的外掛(或是外掛出錯)。第三方外掛需要使用 gitbook install 指令安裝後才能使用。

還有一種可能是因為「版本不合」。某些版本的外掛可能只支援特定版本的 GitBook,你可以調整 GitBook 的版本(注意差異),或是尋找支援你正在使用版本的外掛。有時候除了指定外掛,還要指定特定的版本號,這些都在 book.json 中設定:

  1. {
  2. "plugins": ["myPlugin@1.2.3"]
  3. }

  1. Need to install ebook-convert from Calibre

如果你希望在桌面(本地電腦)上完成書籍轉製,你需要安裝 Calibre 與它提供的終端機工具。

已經安裝好 Mac 版本的 Calibre 之後,循著上面的選單依序點擊: calibre - Preferences - Miscellaneous - Install command line tools,就可以安裝好終端機指令工具。

上面程序完成之後,本地的轉製工作應該就會正常。

ps. 使用桌面編輯器,或是用 Git 提交更新,轉製程序是在 GitBook 主機上運作,並不需要安裝 Calibre,這應該是大多數人的使用情境。