环境准备

我的gitbook是在wsl2上安装Ubuntu18后install的,开始时换完源一穷二白,直接命令行:

1
2
sudo apt install npm
npm install -g gitbook-cli

由于wsl的root和user一开始我的配置问题,出现了permission 问题(Error: EACCES: permission denied),于是着手修改权限:

1
2
sudo chown -R $USER /usr/local/lib/node_modules
sudo chown -R $USER /usr/local/bin

再运行npm install -g gitbook-cli就可以顺利安装了,gitbook [-V/--version]查看版本,gitbook help查看手册。


我目前版本是

1
2
3
4
node v8.10.0
npm  v3.5.2
CLI version: 2.3.2
GitBook version: 3.2.3

关于npm国内换源

1
npm config set registry https://registry.npm.taobao.org

检测是否修改成功

1
2
npm config get registry
#- npm info express

恢复原来的镜像

1
npm config  set registry https://registry.npmjs.org/

插件使用

如安装支持中文搜索的插件:npm install gitbook-plugin-search-pro,使用 gitbook install 会安装全部插件。

部分插件安装了老版本 github@2.0.0

卸载方法

1
2
npm uninstall -g gitbook-cli
npm cache clean [-f/--force]

附录 appendix

插件

常用插件1

常用插件2

demo

课程笔记

NJUCS FAQs