Gitbook小技巧 - 弦外之音

Gitbook 是一个非常好用的写书软件，可以把 markdown 的文件生成章节。不过由于这个软件是 nodejs 写的，用比较新的版本总是会有一些bug，通常会遇到以下错误：

1，cb.apply is not a function

2，Error: ENOENT: no such file or directory, stat 'D:\gitbook_test\_book\gitbook\gitbook-plugin-highlight\ebook.css'

首先安装 的 nodejs 版本要 匹配 Gitbook 的版本，我选择 nodejs 10.2.6 这个不太新的版本，然后 gitbook 我选择 3.0 版本。

有问题可以删除生成目录 _book，再执行一次命令。

gitbook 添加插件流程，在当前文件夹 新建一个 book.json 文件，如下：、

{
    "plugins": [
       "tbfed-pagefooter"
    ],
    "pluginsConfig": {
        "tbfed-pagefooter": {
            "copyright":"Copyright xianwaizhiyin.net 2022",
            "modify_label": "该文件修订时间：",
            "modify_format": "YYYY-MM-DD HH:mm:ss"
        }
    }
}

由于 gitbook 生成的是静态html，所以需要通过 nginx 的 sub_filter 来修改 html ，插入广告或者统计代码。

gitbook 数学公式要用 katex 插件，npm i gitbook-plugin-katex

由于笔者的水平有限，文中难免会出现一些错误或者不准确的地方，恳请读者批评指正。如果读者有任何宝贵意见，可以加我微信 Loken1。