使用 gitbook 制作自己的 html 文档

2022年5月22日 17次阅读

使用 gitbook 制作自己的 html 文档

步骤如下

npm install gitbook-cli -g // 全局安装 gitbook-cli <span style=”text-align: left”>npm install gitbook-cli -g // 全局安装 gitbook-cli</span>
cd MyDoc //切换目录

gitbook init //初始化 [Not supported by viewer]
npm uninstall gitbook-cli -g // 移除全局 gitbook-cli <span style=”text-align: left”>npm uninstall gitbook-cli -g // 移除全局 gitbook-cli</span> 再次 再次
// 切换 node 环境为 10.x 版本

nvm list // 显示 node 版本列表

nvm use 10.16.2 // 使用版本 10.16.2 的 nodejs [Not supported by viewer] 是 是 是否有报错信息

(
TypeError: cb.apply is not a function)? [Not supported by viewer] 初始化成功 初始化成功
gitbook serve // 启动 [Not supported by viewer]
编写文档修改 SUMMARY.md <span style=”text-align: left”>编写文档修改 SUMMARY.md</span>
gitbook build // 生成 html [Not supported by viewer] 否 否 结束 结束 开始 开始

1.全局安装 gitbook-cli

npm install gitbook-cli -g // 全局安装gitbook-cli

2.切换文档路径且使用 gitbook 初始化

cd MyDoc //切换目录
gitbook init //初始化

3.报错 TypeError: cb.apply is not a function

TypeError: cb.apply is not a function

解决办法： 使用 node 10 即可。
具体的原因在：https://stackoverflow.com/questions/63214997/typeerror-cb-apply-is-not-a-function
是 gitbook 使用了一个过时的 dependency 所致。

4.移除全局 gitbook-cli

npm uninstall gitbook-cli -g // 移除全局 gitbook-cli

5.切换 node 环境为 10.x 版本

之前看的某篇文章是 10.21.0，由于本地有 10.x 版本，所以使用 10.16.2

// 切换 node 环境为 10.x 版本
nvm list // 显示node版本列表
nvm use 10.16.2 // 使用版本10.16.2的nodejs

6.再次全局安装 gitbook-cli

npm install gitbook-cli -g // 再次全局安装gitbook-cli

7.再次使用 gitbook 初始化项目

gitbook init

8.初始化成功

等了不少时间

info: initialization is finished

9.启动 gitbook 项目

在我重装系统的电脑上很流畅

gitbook serve // 启动

10.根据自己需要编写文档

编写自己的 *.md 文件

修改目录文件 SUMMARY.md

11.生成 html 文件

gitbook build // 生成html

参考链接

使用 Zeal 打造属于自己的文档

使用 gitbook 来写作 – gitbook 命令行

gitbook – 无法运行，报错：TypeError: cb.apply is not a function gitbook

点赞