GitBook Install

• 本地安装
  • 环境要求, 安装 GitBook 是很简单的。您的系统只需要满足这两个要求：
    • NodeJS（推荐使用v4.0.0及以上版本）
    • Windows，Linux，Unix 或 Mac OS X

通过NPM安装

安装 GitBook 的最好办法是通过 NPM。在终端提示符下，只需运行以下命令即可安装 GitBook：

$ npm install gitbook-cli -g
//gitbook-cli 是 GitBook 的一个命令行工具。它将自动安装所需版本的 GitBook 来构建一本书。

执行下面的命令，查看 GitBook 版本，以验证安装成功。

$ gitbook -V

安装历史版本gitbook-cli 可以轻松下载并安装其他版本的GitBook来测试您的书籍：

$ gitbook fetch beta
//使用 gitbook ls-remote 会列举可以下载的版本。

创建一本书,

初始化, GitBook可以设置一个样板书：

$ gitbook init
//如果您希望将书籍创建到一个新目录中，可以通过运行 gitbook init ./directory 这样做。

构建, 使用下面的命令，会在项目的目录下生成一个 _book 目录，里面的内容为静态站点的资源文件：

$ gitbook build

Debugging, 您可以使用选项 --log=debug 和 --debug 来获取更好的错误消息（使用堆栈跟踪）。例如：

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

启动服务, 使用下列命令会运行一个 web 服务, 通过 http://localhost:4000/ 可以预览书籍

$ gitbook serve

生成电子书

    # Generate a PDF file
    $ gitbook pdf ./ ./mybook.pdf

    # Generate an ePub file
    $ gitbook epub ./ ./mybook.epub

    # Generate a Mobi file
    $ gitbook mobi ./ ./mybook.mobi

参考资料

• 使用 Gitbook 打造你的电子书