使用 gitbook 制作自己的 html 文档
步骤如下
npm install gitbook-cli -g // 全局安装 gitbook-cli
cd MyDoc //切换目录
gitbook init //初始化
gitbook init //初始化
npm uninstall gitbook-cli -g // 移除全局 gitbook-cli
再次
// 切换 node 环境为 10.x 版本
nvm list // 显示 node 版本列表
nvm use 10.16.2 // 使用版本 10.16.2 的 nodejs
nvm list // 显示 node 版本列表
nvm use 10.16.2 // 使用版本 10.16.2 的 nodejs
是
是否有报错信息
(TypeError: cb.apply is not a function)?
(TypeError: cb.apply is not a function)?
初始化成功
gitbook serve // 启动
编写文档修改 SUMMARY.md
gitbook build // 生成 html
否
结束
开始
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
参考链接
gitbook - 无法运行,报错:TypeError: cb.apply is not a function gitbook