gibook工具常见的问题记录

背景

一直在用markdown 在写一些文档,有个东西需要用gitbook来看效果,就装了gitbook,在使用gitbook的时候并不是一帆风顺的。虽然之前也用过很多次,也许之前运气好,并没有出什么问题,gitbook本身可能也不是很完美,在操作时有问题,这里做一个简单的记录。

安装操作

npm install -g gitbook-cli

当前环境

  1. cli version : 2.3.2
  2. gitbook version: 3.2.3
  3. node : 10.6.0
  4. npm: 6.1.0
  5. System Version: Win 10 企业版 (1803)(17134.376)

常见问题

  1. Error: Cannot find module ‘gitbook-html’

原因及解决办法: 原因是没有下载依赖,需要运营下面的命令解决

gitbook fetch
  1. random errors when using gitbook plugin on running “gitbook serve”.

Error: ENOENT: no such file or directory, stat ‘/nfs/home/alf/gitbook/foobar/_book/gitbook/gitbook-plugin-lunr/lunr.min.js’

Error: ENOENT: no such file or directory, stat ‘/home/aparra/Documentos/zoi-api/book/_book/gitbook/gitbook-plugin-livereload/plugin.js’

Error: ENOENT: no such file or directory, stat ‘…_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js’

原因及解决办法:

暂时没有好的办法,但是可以通过修改配置来解决这个问题
修改下面的问题件~指的是用户目录
~\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js 中的112行内容
原始内容 ,主要是confirm的true 需要修改为false

return fs.copyDir(
        assetsFolder,
        assetOutputFolder,
        {
            deleteFirst: false,
            overwrite: true,
            confirm: true
        }
    );

修改后

return fs.copyDir(
        assetsFolder,
        assetOutputFolder,
        {
            deleteFirst: false,
            overwrite: true,
            confirm: false
        }
    );

猜你喜欢

转载自blog.csdn.net/yinlongfei_love/article/details/84636035