平时都是在 Notion 下做知识管理,最近打算使用 GitBook 来写内部文档。GitBook 依赖 Node.js,今天把 Node.js 环境准备一下。
在官网下载最新 LTS 版 Node.js,Node.js 安装包下载地址:
https://nodejs.org/en/

安装包 node-v18.12.1-x64.msi 下载下来后,一路next安装。

安装时会注册环境变量到Path中,这样就可以在命令行运行npm命令了。

尽量把工具装全:

完装比较快速,很快就装完了。

装完 node.js 会重新弹一个窗口安装其它扩展。

此时 npm 已经可以工作了。

使用 npm 安装 gitbook-cli 试试:
C:\> npm install -g gitbook-cliadded 21 packages, and audited 579 packages in 1mC:\> where gitbookC:\Users\Administrator\AppData\Roaming\npm\gitbookC:\Users\Administrator\AppData\Roaming\npm\gitbook.cmd
克隆一个gitbook测试仓库,里面有基本的 gitbook 页面。
$ git clone https://github.com/GitbookIO/example.gitCloning into 'example'...remote: Enumerating objects: 6, done.remote: Total 6 (delta 0), reused 0 (delta 0), pack-reused 6Receiving objects: 100% (6/6), done.
在 example 目录中执行 gitbook serve
$ cd example/$ gitbook serveInstalling GitBook 3.2.3C:\Users\Administrator\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287if (cb) cb.apply(this, arguments)^TypeError: cb.apply is not a functionat C:\Users\Administrator\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287:18at FSReqCallback.oncomplete (node:fs:212:5)
这一步执行时报错了,修改 polyfills.js 中的第 62-64 行,将其注释掉:

重新执行 gitbook serve 开始安装 GitBook

最后安装完 GitBook 会在本地起一个服务,端口号为 4000

访问 http://localhohst:4000 已经可以看到 gitbook 的测试页面:

这个页面里面只有几个初始化的 markdown 文本,我们来看一个完整的 gitbook 例子,这个例子是用 gitbook 写的 awk 电子书,挂载出来的 gitbook 页面地址在下面,做的非常的漂亮。
https://book.saubcy.com/#bookList

参考
https://www.cnblogs.com/cyxroot/p/13754475.html
https://blog.csdn.net/yq_forever/article/details/112121742
https://blog.csdn.net/Small_Yogurt/article/details/104968169
全文完。
如果转发本文,文末务必注明:“转自微信公众号:生有可恋”。




