Gitbook小技巧 - 弦外之音

/ 0评 / 0

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。

发表回复

您的电子邮箱地址不会被公开。