mac 安装 Gitbook以及初始化书籍目录

安装 Gitbook

• 安装 node 、npm

在 https://nodejs.org/en/  下载安装 node 即可
// 检查 npm 是否安装成功,Gitbook 是在 npm 环境下面安装的，所以要先安装好 npm
npm -v
// 检查 node 是否存在
npm -v

• 安装 Gitbook

// 全局安装 Gitbook
sudo npm install -g gitbook-cli
// 检查是否安装成功
gitbook -v
// 使用 gitbook -v 命令检查时可能不会出现版本号，但是已经安装好了

• 注意：使用 npm install gitbook -g 或者npm install gitbook-cli -g命令在 mac 安装的时候不成功，都会出现下面的问题，找不到 npm 的 /user/local/lib/node_modules 路径，所以安装命令前需要加入 sudo

  

Gitbook 的基本使用

1. gitbook init 初始化书籍目录

• README.md 和 SUMMARY.md 是两个必须文件
• README.md 是对书籍的简单介绍，SUMMARY.md 是书籍的目录结构

2. gitbook serve 编译和预览书籍

• 此命令会自动生成一个 _book 文件夹
• 此命令会首先调用 gitbook build 编译书籍，完成以后会打开一个 web 服务器，监听本地的 4000 端口