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