mac安装部署gitbook教程

前言

一些自己实际操作的记录。

一、安装准备

1. Node.js
   gitbook基于Node.js，所以需要提前安装。
   下载地址：https://nodejs.org/en/，可以下载比较新的版本。(但我的建议是不要安装太高的版本，容易走很多弯路，笔者使用的是10.16.3，后文中提供网盘下载)
   
   建议下载LTS版本（Long Term Support)。
   同时也可以网盘下载（这里的版本为10.16.3 LTS）：
   链接: https://pan.baidu.com/s/1JZLRn5EhICmsn-pLm-6Z_g 提取码: 4grf
   双击打开后，一直点「继续」即可。
   安装完成后：使用node -v可以查看版本号。

二、GitBook安装

运行命令：

sudo npm install -g gitbook-cli

建议科学上网，速度比较快，不懂怎么科学上网的朋友们可以私聊我，我可以教学。
运行命令查看是否安装成功：
sudo gitbook -V
但出现报错：（主要是因为Node.js版本较高，可以尝试降低版本，推荐10.x.x）
但无需担心，只需要修改对应的内容就好：
首先进入到报错的文件中：

sudo vi /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js

找到下面这三行，注释掉。具体可以参考：https://flaviocopes.com/cb-apply-not-a-function/

重新运行sudo gitbook -V，低版本应该会比较顺利，控制台输出以下内容：

CLI version: 2.3.2
Installing GitBook 3.2.3
[email protected] ../../../../../../../../../var/folders/kj/qbpckysx1_924y0nhd59nd5r0000gn/T/tmp-16645XKlrWUKvHqkG/node_modules/gitbook
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected] ([email protected])
├── [email protected]
├── [email protected]
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected]
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected]
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
└── [email protected] ([email protected], [email protected], [email protected])
GitBook version: 3.2.3

再运行：sudo gitbook -V，应该就显示正常的版本号了：

LI version: 2.3.2
GitBook version: 3.2.3

现在开始可以使用GitBook了。

三、项目初始化

可以自己新建一个目录，进入到该目录下，执行命令：

 ~  mkdir myGitBook && cd myGitBook                                                                                              ✔ │ base Py │ at 22:54:27
 ~/myGitBook  gitbook init                                                                                                       ✔ │ base Py │ at 22:54:46
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished

会生成两个md文档，README.md 是对书籍的简单介绍， SUMMARY.md 是书籍的目录结构。
然后可以通过gitbook serve编译成html格式，完成以后会打开一个 web 服务器，监听在本地的 4000 端口。

这样gitbook就初步搭建完成了。