工具

GitBook本地启动的一些问题

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
2
3
4
5
6
7
8
Restart after change in file README.md

Stopping server
events.js:183
      throw er; // Unhandled 'error' event
      ^

Error: EPERM: operation not permitted, lstat 'X:\XXX\_book\gitbook'

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