Windows下Gitbook快速入门使用
- 1 工具安装
- 1.1 Node.js下载安装
- 1.1 环境变量
- 1.2 npm配置
- 1.3 安装gitbook
- 2 gitbook使用
- 2.1 gitbook 无法执行
- 2.2 gitbook常用命令
Gitbook是一个软件，使用Git和Markdown来编排书本；
GitBook helps you pushlish beautiful docs for your users and centralize your team’s knowledge for advanced collaboration;
1 工具安装
1.1 Node.js下载安装
https://nodejs.cn/download/
其中里面的npm是下载安装管理工具；
1.1 环境变量
1.在Windows下找到环境变量中的Path添加下载解压好的node.exe的位置；
验证是否安装成功：
2.新建两个文件夹：node-global;node-cache;
在cmd命令行下：
npm config set prefix "xxxxx\node_global"
npm config set cache "xxxx\node_cache"
3.由于 node 全局模块大多数都是可以通过命令行访问的
在这里把node_global也加入到系统环境变量中，方便使用命令行运行；
1.2 npm配置
# 配置镜像站
npm config set registry=http://registry.npm.taobao.org
# 检查一下镜像站是否正常
npm config get registry
1.3 安装gitbook
npm “-g” 表示安装到 global 目录下;
在这里安装的包不对：
在这里注意：npm install -g gitbook-cli
这里有个坑，node.js的版本过新了；
降低node.js版本成node v12.18.4即可；
2 gitbook使用
2.1 gitbook 无法执行
在VScode上的终端上发现无法使用gitbook，且提示：无法加载文件 C:\Program Files\node-v12.18.4-win-x64\node_global\gitbook.ps1，因为在此系统上禁止运行脚本。
解决方法：按照下图的5步即可解决问题:
在终端输入get-ExecutionPolicy查看执行策略/权限；
输出Restricted(受限制的)；
终端输入Set-ExecutionPolicy -Scope CurrentUser命令给用户赋予权限；
输入RemoteSigned；
终端输入get-ExecutionPolicy查看一下权限，显示RemoteSigned就可以了。
2.2 gitbook常用命令
gitbook init
