新版GitBook安装及使用——不完全避坑指南

最近打算把一些笔记进行电子化整理和归档，于是尝试了 GitBook。

GitBook 是目前最流行的开源书籍写作方案，可以把Markdown 文件汇集成电子书，并提供 PDF、HTML 等多种格式输出。一般还需配合 Markdown 文本编辑器、Git 代码管理工具和 GitHub 托管仓库使用。我本人使用的Typora 是一个轻量级的 Markdown 文本编辑器，页面简洁，也容易上手，使用体验比较好。

所以创建开源电子书整体的预备配置包括了GitHub + Git + Typora + GitBook。前三者的准备比较简单：注册 GitHub 账号，下载 GitHub DeskTop, Git 和 Typora（或其他Markdown 文本编辑器，如 GitBook Editor），这里就不再赘述。

GitBook的安装折腾了我将近一整天… 由于 GitBook 近期进行了改版和更新，网络上的一些教程可能不再完全适用。这里结合个人的摸索，介绍一下改版后 GitBook 的安装和使用步骤，以及我在安装过程中踩过的一些坑和解决办法。

---

一、GitBook安装过程

1、安装 Node.js

GitBook 是基于 Node.js的，所以我们首先需要安装对应版本的 Node.js（下载网址：https://nodejs.org/en/download/）

目前Node.js的最新稳定版本的v12.18.3。但这个版本对GitBook可能不兼容（在后续安装和启动 GitBook 命令时会出现错误提示），建议直接安装v10.22.0。

当然，如果开始时选择了最新版本也不用慌，可以先尝试后续步骤，如果出现错误提示，参考避坑指南-Node.js版本问题尝试解决。

2、安装GitBook

现在安装 Node.js 都会默认安装 npm（node 包管理工具），所以我们不用单独安装 npm，打开全局命令行Win+R, 输入cmd，执行以下命令：

npm install -g gitbook-cli

耐心等待，安装完成后会显示 GitBook-cli 的版本。