1. 环境准备 nide.js , nvm的安装使用
GitBook 是基于 Node.js 的应用,因此首先需要安装 Node.js 和 npm(Node.js 的包管理器)。
1.前往node.js官网安装node,但是我强烈不建议,
最好是安装nvm这个node 的版本管理工具,它方便用于切换node 版本,(安装之前记得先把你电脑上本来有的node版本删除掉!!!),下载的话可以在官方下载地址Releases · coreybutler/nvm-windows (github.com) ,滑倒下面到图片的红色框框的部分,点击就可以下载安装包或者是压缩的安装
nvm安装过程,一直next就行了,但是请记住你的安装地址,不然你后面也是得搜索出来,然后安装完成需要找到你当时的安装文件打开settings.txt ,在里面需要再手动粘贴进去两行代码才行,不然后续都无法进展
打开之后,然后把这两行代码粘贴进去保存 (这是原始的镜像,也可以使用淘宝或者腾讯的镜像,但是这些安装东西有时候会出错,虽然速度会更快):
node_mirror: npmmirror.com/mirrors/nod...
npm_mirror: npmmirror.com/mirrors/npm...
后面打开任务管理器,输入 nvm -v查看nvm 版本就知道是否安装成功,以下是一些nvm的常用指令 nvm list available 显示可以在线安装的版本
nvm ls 显示现在下载的所有的版本
nvm install 安装指定版本
nvm uninstall 卸载指定版本node
nvm use 使用指定版本
重点
我给你们试过了,用最新版本的node 版本下载根本没用,我试过这么多版本,只有这个12.20.1的版本的node能在接下来gitbook安装过程不报错,其他全部会报错,所以建议直接使用12.20.1版本,如果不信的话可以去试试其他版本(可能是我的操作有问题,反正我就是只有12.20.1能下载出来,大佬勿喷我),用nvm的代码下载12.20.1 直接在小黑窗 nvm install 12.20.1 就行
后面就是进入下载gitbook的过程了
2.下载Gitbook 并且初始化
1.使用 npm 安装 GitBook CLI:
npm install -g gitbook-cli
2.验证安装:
css
gitbook --version
出现这个说明安装成功了,选择一个目录作为你的项目存储位置,进入该目录。就可以初始化Gitbook项目了
csharp
gitbook init
出现这两个文件 README.md 和SUMMARY.md ,就说明初始化成功了。如果初始化报错或者只有一个README.md,可以检查一下node版本,最好是12.20.1,是会出来两个并且不报错的,报错的话那就卸载gitbook
npm uninstall -g gitbook-cli
把版本切换到12.20.1再试试看重新安装重新初始化
我的步骤就到这,后续还没开始,此文只是记录一下我的使用踩坑过程,后续操作有的话就会补充