基于 Nodejs 的 gitbook, 感觉和 hexo 大同小意,不过还有额外的制作 pdf 和 ebook 等功能,值得一试
安装
最终各软件版本信息如下
- node: v13.14.0
- CLI version: 2.3.2
- GitBook version: 3.2.3
1 | # 安装 |
安装抛错
1 | No receipt for 'com.apple.pkg.CLTools_Executables' found at '/'. |
重新安装 xcode-select, 去 app store 中搜索 xcode 并安装,挺花时间的,后年还要重新签一下协议。。。
折腾一阵子还是失败了,最后搜了下谁是 gitbook 使用的 polyfills.js 还是旧版的,没有跟新,可以直接去这个文件中,将饮用的语句删掉,或者更新对用的库文件即可,我用了后者
根据提示,打开文件,将该文件中的引用语句注释掉, 再试运行,正常
1 | // fs.stat = statFix(fs.stat) |
gitbook init
又报错了
1 | TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Promise |
说是版本过高。。。。草了, 打算使用 nvm 降一下
1 | # 然而 DNS 被污染了,并不能拿到对应的文件,直接下载过到本地就行了, 然后 bash install.sh 即可 |
切换版本之后,运行正常, 我估计可能 nvm 之后前面的那些改 js 文件的操作都可以省了
gitbook 使用
- 创建书本文件并
gitbook init
生成目录 gitbook serve
生成本地版电子书,访问 4000 端口阅读
常用规则
常用插件
- gitbook-plugin-summary 可以更具文件夹目录帮你自动生成对应的 summary 文件内容,安装完后输入
book sm
自动更新