搭建GitBook环境

一、介绍

GitBook是一个集编写、发布、托管功能于一身的易于使用电子书解决方案，它是发布内容和在内容上进行协作的最简单的解决方案。它与GitBook Editor有极为良好的集成配置。

二、环境搭建

1、安装要求

GitBook的安装既简单又方便，您的系统只需要满足下面这2个要求：

• NodeJS (建议使用版本大于4.0.0)
• Windows, Linux, Unix, or Mac OS X

2、安装NPM

安装GitBook的最好的方式是通过NPM，在命令行终端下，只需要执行以下命令即可安装成功：

$ npm install gitbook-cli -g

GitBook CLI是一个可以在同一系统上安装和使用不同版本的GitBook的实用工具和程序，它将自动安装所需版本的GitBook并生成书籍。

3、创建书籍

GitBook能够生成一个电子书的模板:

$ gitbook init

如果您希望将书籍创建到新目录中，你可以通过以下命令来完成：

`gitbook init ./directory`

你可以通过使用以下方式去预览您的书籍：

$ gitbook serve

或者使用以下方式构建静态网站：

$ gitbook build

4、安装发布版本

gitbook cli可以方便地下载和安装其他版本的gitbook，以便使用您的图书进行测试。

$ gitbook fetch beta

使用gitbook ls-remote去远程查看可能需要安装的版本列表。

5、调试

你可以使用选项 --log=debug 和 --debug去获取更好的错误信息（具有堆栈跟踪功能）。举例：

$ gitbook build ./ --log=debug --debug