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
)
