gitbook简单使用

1.安装

首先全局安装gitbook-cli:

npm install -g gitbook

2.初始化

打开命令窗口：

gitbook init

会生成两个文件 README.md  &  SUMMARY.md

3.打包

在命令窗口输入：

gitbook build

然后会将当前路径下的文档打包到_book中

如果运行 gitbook build 后报错，初步判断是 node 版本升级导致

if (cb) cb.apply(this, arguments)
                 ^
TypeError: cb.apply is not a function

• 通过 nvm use 12 降低 node 环境后解决，类似报错也大多数由于 node 版本导致。(nvm安装可参考我另外一篇文章)

4.在服务端运行

(1)创建一个文件夹 book,将打包好的_book整个文件放入其中

(2)配置package.json，打开命令窗口：

npm init -y

生成一个package.json，安装express依赖包

npm install express

修改package.json的scripts，添加

"start": "node app.js"

(3)创建一个app.js

var express = require('express');
var path = require('path');
var app = express();

app.use(express.static(path.join(__dirname, '_book')));

app.listen(9000, function() {
 console.log('App listening at port 9000;');
});

(4)即可在localhost:9000开始访问文档了