Gitbook安装及过程中出现的问题

Gitbook安装教程

（视个人node.js和gitbook版本而定，本人node.js是从官网下载最新版）
Node.js安装版本：12.18.4
Gitbook安装版本：3.2.3
安装步骤：

1. 打开终端，输入npm install gitbook -g
2. 建立一个新的文件夹，为了方便可命名为“Gitbook”
3. 在终端中切换到2步骤中新建文件夹的目录
4. 初始化Gitbook：输入gitbook init
5. 启动Gitbook：输入gitbook serve
6. 在浏览器中预览：地址栏输入localhost：/4000，检查gitbook的安装成果

安装过程中，出现了几个小问题，稍作了总结。

1. 输入npm install gitbook -g
   出现gitbook err code 128 报错，经查阅了解到，这是一个较为普遍的npm install问题的，根源是部分依赖于ssh的下载方式已经不能使用，具体由于知识浅薄未能深究。
   解决办法
   在终端上输入
   git config --global url.“https://”.insteadOf git://或git config --global http.sslverify "false"从而将ssh的下载方式替换为https方式。

2. 在终端上切换目录时出现输入cd D:\xxxxxx无法切换到目标目录，只能切换C盘下的任意目录
   解决办法输入cd \d D:\xxxxx 切换到相应目录

3. 输入gitbook init之后出现
   1.You need to install “gitbook-cli” to have access to the gitbook command anywhere on your system.
   If you’ve installed this package globally, you need to uninstall it.

Run “npm uninstall -g gitbook” then “npm install -g gitbook-cli”`
需要卸载安装包重新安装客户端，终端执行上述代码

2.出现if(cb) cb.apply(this,arguments)，从网上搜索到的原因是因为当前版本不兼容此处有两种解决办法。

• 将原版本的node.js卸载，下载node.js v10.21.0，该版本与gitbook3.2.3相兼容
• 就我当下node.js目录，找到D:\Program bubuFiles\Nodejs\node_global\node_modules\gitbook-cli\node_modules\npm\node_modules
  \graceful-fs\polyfills.js文件，该处出错是一个针对修复旧版node.js出现的bug的函数statFix，需要将该函数与其被调用的地方注释掉，之后进行gitbook init`