当前位置：首页 > news >正文

【Windows下Gitbook快速入门使用】

news 2025/9/18 12:36:18

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就可以了。
在这里插入图片描述