1. 程式人生 > >MAC:gitbook build常見問題

MAC:gitbook build常見問題

常見問題一:

  • 問題描述:gitbook新版本"gitbook build"命令匯出的html左側導航無法跳轉

  • 可能原因
    新版本的gitbook不支援了這個功能

  • 具體原因:
    由於點選事件被js程式碼禁用,所以點選沒有反應,但是如果右鍵,在新視窗/新標籤頁開啟的話是可以跳轉的

  • 解決辦法:
    找到專案目錄gitbook
    找到目錄下的theme.js檔案
    找到下面的程式碼
    將if(m)改成if(false)

常見問題二:

  • 問題描述:執行gitbook pdf ./ ~/Desktop/test/test/時,報錯:InstallRequiredError: “ebook-convert” is not installed.
    Install it from Calibre:

    https://calibre-ebook.com

  • 解決辦法:

    • 缺少ebook-convert,需要安裝作業系統對應的calibre
      下載地址:https://calibre-ebook.com/download_osx
    • 安裝該應用完成後,建立命令列連結
      sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
    • 再次執行gitbook pdf ./ ~/Desktop/test/test/xx.pdf即可

常見問題三:

  • 問題描述:執行命令gitbook pdf ./ ~/Desktop/test/test/時,報錯:Error: EISDIR: illegal operation on a directory, open ‘/Users/python/Desktop/test/test/’

  • 解決辦法:

    • 在執行命令gitbook pdf ./ ~/Desktop/test/test/時,加上要生成的pdf檔案的名字即可解決