gibook工具常见的问题记录

最新推荐文章于 2022-03-01 17:20:25 发布

原创最新推荐文章于 2022-03-01 17:20:25 发布 · 1.1k 阅读

0 ·

CC 4.0 BY-SA版权

做技术的小笔记同时被 3 个专栏收录

62 篇文章

订阅专栏

Node-js

3 篇文章

订阅专栏

Window

3 篇文章

订阅专栏

本文分享了在使用GitBook过程中遇到的常见问题及其解决办法，包括安装操作、环境配置及插件使用中出现的错误，如找不到模块、随机错误等，并提供了具体的修改配置文件的解决方案。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

背景

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

安装操作

npm install -g gitbook-cli

当前环境

cli version : 2.3.2
gitbook version: 3.2.3
node : 10.6.0
npm: 6.1.0
System Version: Win 10 企业版 (1803）(17134.376)

常见问题

Error: Cannot find module ‘gitbook-html’

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

gitbook fetch

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
        }
    );