安装 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 的基本使用
gitbook init
初始化书籍目录
- README.md 和 SUMMARY.md 是两个必须文件
- README.md 是对书籍的简单介绍,SUMMARY.md 是书籍的目录结构
gitbook serve
编译和预览书籍
- 此命令会自动生成一个 _book 文件夹
- 此命令会首先调用
gitbook build
编译书籍,完成以后会打开一个 web 服务器,监听本地的 4000 端口