• GitBook安装
    • 环境要求
    • 通过NPM安装
    • 编辑书籍
    • 预览书籍

    GitBook安装

    下面介绍在本地如何安装 GitBook，如果不需要本地调试 & 不需要获得生成的 html 文件，可以直接使用 官网 提供的服务。

    环境要求

    • NodeJS(v4.0.0及以上)

    通过NPM安装

    运行下面的命令进行安装

    1. npm install gitbook-cli -g

    其中gitbook-cli是gitbook的一个命令行工具, 通过它可以在电脑上安装和管理gitbook的多个版本.

    编辑书籍

    gitbook 官方已经提供了一个本地的编辑器, 使用它可以方便的编写书籍(不需要手动的写SUMMARY.md), 并且支持windows、mac、linux 三种平台, 所以强烈建议使用编辑器编写书籍.

    预览书籍

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

    1. gitbook serve

    运行该命令后会在书籍的文件夹中生成一个 _book 文件夹, 里面的内容即为生成的 html 文件.
    我们可以使用下面命令来生成网页而不开启服务器

    1. gitbook build