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文件的名字即可解决