typora + nodejs + gitbook安装

1. typora安装

typora 下载地址：https://typora.io/

2. node安装gitbook

2.1 安装步骤

1. gitbook是基于 nodejs，所以我们首先需要安装 nodejs, 下载地址：https://nodejs.org/en/download/
   默认安装即可，安装成功后需配置环境变量。
2. gitbook命令行安装如下：
   gitbook init成功执行后会生成README.md 和 SUMMARY.md
   README.md —— 书籍的介绍
   SUMMARY.md —— 书籍的目录结构

npm install gitbook-cli -g  #-g 全局安装可以配置路径
mkdir mybook
cd mybook
gitbook init #初始化gitbook可能会遇到问题

3. 查看版本：

node -v
npm -v
gitbook -V     #注意：V要大写

2.2 遇到的问题

2.2.1 运行gitbook init命令报错:cb.apply is not a function

问题：运行gitbook init命令报错:cb.apply is not a function

方案一：注释上图对应文件使用到statFix函数的地方，如下图：再运行gitbook init即可

方案二：版本不兼容需要将nodejs版本降级，一般降级至v12就可以了。

2.2.2 配置 -g 全局安装和缓存路径

问题：nodejs默认的全局安装路径和缓存安装在c盘，可以将这两个文件与安装目录配置在一起。

步骤一：在安装目录新建node_global,node_cache文件夹
步骤二：命令行配置,记得替换本地安装路径

npm config ls
npm config set prefix "D:\\nodejs\\node_global"
npm config set cache "D:\\nodejs\\node_cache"
npm config ls

2.2.3 配置npm 镜像

问题：执行 gitbook -V 时长时间卡顿如下图

方案一： 翻墙科学上网
方案二： 切换为使用国内速度较快的淘宝镜像

npm config get registry
npm config set registry https://registry.npm.taobao.org -g
npm config get registry
npm config ls

2.2.4 运行gitbook serv命令报错: no such file or directory

问题：Error: ENOENT: no such file or directory, stat ‘C:\Users\Lenovo\www\mdspg\md\mybook_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js’

解决方案：用户目录下找到以下文件: .gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js
搜索到两个confirm: true，都改为 confirm: false即可。

3. 其他

nvm是nodejs的版本管理工具，可以通过安装nvm安装不同版本的nodejs。

4. 参考链接

问题:TypeError [ERR_INVALID_ARG_TYPE]: The “data” argument must be of type string or an instance of Buffer