GitBook安装

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

环境要求

  • NodeJS(v4.0.0及以上)

通过NPM安装

运行下面的命令进行安装

npm install gitbook-cli -g

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

创建一本书

GitBook通过以下命令在当前目录创建一本书:

gitbook init

如果你想用现有的目录来创建一本书,你可以通过运行 gitbook init ./directory来实现

编辑书籍

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

预览书籍

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

gitbook serve

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

gitbook build

打开原有书籍

例如你从github或者其他网站下载了书籍信息,需要自己手动编译书籍才可以。有的书籍有插件,所以需要在执行gitbook build命令之前需要执行gitbook install将gitbook需要的插件自动安装到书籍目录,成功后再次执行gitbook build就可以了

Copyright © wiliam.me 2017 all right reserved,powered by Gitbook该文件修订时间: 2017-09-01 14:30:02

results matching ""

    No results matching ""