Blog
编辑

常见问题

  • 热加载失败

gitbook serve 命令报错,修复文件位置: ~/.gitbook/versions/[version]/lib/cli/serve.js

/* 代码首行 */
const fs=require("fs");

/* 任意空白位置 */
function deleteFolder(path) {
    let files = [];
    if( fs.existsSync(path) ) {
        files = fs.readdirSync(path);
        files.forEach(function(file,index){
            let curPath = path + "/" + file;
            if(fs.statSync(curPath).isDirectory()) {
                deleteFolder(curPath);
            } else {
                fs.unlinkSync(curPath);
            }
        });
        fs.rmdirSync(path);
    }
}

找到函数体 generateBook ,在 var outputFolder = getOutputFolder(args); 下面另起一行写入:

gitbook install 安装插件失败,建议尝试直接使用 npm install gitbook-plugin-* 安装插件.

npm install gitbook-plugin-mygitalk 安装出错插件后,再次运行 gitbook install 安装所需插件,重复该过程直至全部安装成功.

  • ENOENT: no such file or directory

gitbook serve 启动服务命令报错,修复文件位置: ~/.gitbook/versions/3.2.3/lib/output/website/copyPluginAssets.js

搜索并全部替换: 将 confirm: true 全部替换为 confirm: false (无需询问,直接操作)

  • internal/streams/legacy.js:57

gitbook pdf 导出pdf命令报错,更改为 gitbook pdf --log=debug 定位离出错位置最近的 markdown 源文件,二分法定位不支持的语法.

经过二分法不断定位出错位置,最终发现部分html标签语法不支持,仅供参考:

<img alt="GitHub stars" src="https://img.shields.io/github/stars/adsryen/gitbook.prlrr.com?style=social"> 去掉 ?style=social 即可,修成后的html如下:

  • gitbook pdf 导出pdf命令出错,重新安装 svgexport

先使用 npm uninstall svgexport -g 卸载旧版本,再使用 npm install --unsafe-perm -g svgexport 安装新版本.

  • Error: Client network socket disconnected before secure TLS connection was established

确认上网环境正常后多尝试几次

  • Error: read ECONNRESET

多次尝试恢复正常

  • Error: EPERM: operation not permitted 无权操作

暂未寻找到更好的解决办法,有时候重试几次就正常了.

  • 网站置灰

特殊纪念日全站置灰

上一页优化搜索下一页热加载失败治标之法

最后更新于

这有帮助吗？