背景
一直在用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
}
);