Mac gitbook安装使用以及遇到问题解决记录

一.搭建环境以及安装gitbook

1.检查当前电脑有没有安装node.js环境

npm -v

如果没有安装则进到node官网进行下载安装

• 英文下载地址:https://nodejs.org/en
  image.png
• 中文下载地址:https://nodejs.org/zh-cn/download
  image.png

检测node.js环境是否安装成功

npm -v

安装成功参考:

image.png

2.检查是否安装gitbook,如果没有则安装

gitbook -V  
gitbook -version

如果没有安装执行安装命令安装:

npm install -g gitbook-cli
//如果上述命令权限问题则以管理员方式执行
sudo npm install -g gitbook-cli

安装完成后执行 gitbook -V gitbook -version检查是否安装成功,安装成功后就可以执行gitbook相关命令使用了

3.整理gitbook常用命令

//初始化工作目录
gitbook init
//编译gitbook项目
gitbook build
//启动本地服务调试
gitbook serve

二.遇到的问题记录

1.安装好node.js环境后通过npm安装gitbook时候,出现"Your cache folder contains root-owned files, due to a bug in previous versions of npm which has since been addressed."

image.png

解决办法:执行报错提示中的建议执行命令:

//注意:每个人电脑环境目录不一样,根据自己实际情况目录调整
sudo chown -R 501:20 "/Users/xiaomai/.npm"

2.执行gitbook build 等相关gitbook命令时候出现"TypeError: cb.apply is not a function at /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287:18"

image.png

解决办法:找到提示报错的polyfills.js目录,使用开发工具打开编辑polyfills.js文件,找到62-64行带啊注释掉

image.png

3.执行gitbook serve 半天一直没反应

image.png

解决办法：执行命令卸载安装的gitbook然后重新安装