title: GitBook本地启动的一些问题
tags:

  • GitBook
    categories:
  • 工具
    date: 2019-11-05 15:24:00

GitBook编写简单文档方便快速，安装使用也简单，
安装：npm install gitbook-cli -g

初始化：gitbook init

启动本地服务器：gitbook serve

文档生成：gitbook build

但是有一些bug需要注意一下：

运行报错 - no such file or directory

出现如下错误或者类似错误，解决方法相同：

  1. Error: ENOENT: no such file or directory, stat 'X:\XXX\_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js'

解决办法：

用户目录下找到以下文件。
<user>\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js

查找文件中所有的confirm: true，替换为confirm: false。

本地启动的服务器修改内容后热加载出错

  1. Restart after change in file README.md
  3. Stopping server
  4. events.js:183
  5.       throw er; // Unhandled 'error' event
  6.       ^
  8. Error: EPERM: operation not permitted, lstat 'X:\XXX\_book\gitbook'

这里有一篇尝试解决的文章，文章比较长，记录了整个排查的过程，最终得出的解决方法是启动服务器之后，立刻删除_book目录