ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

使用 gitbook 制作自己的 html 文档

2022-05-22 00:02:24  阅读:234  来源: 互联网

标签:node 10 cli 初始化 gitbook html 文档 全局


使用 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

标签:node,10,cli,初始化,gitbook,html,文档,全局
来源: https://www.cnblogs.com/djsz3y/p/gitbook-to-html.html

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有