1.2.1. 安装

1.2.1.1. 环境要求

  • NodeJS(v4.0.0及以上) 通过NPM安装

运行下面的命令进行安装

$ npm install gitbook-cli -g

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

1.2.1.2. 编辑书籍

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

1.2.1.3. 导入和打开书籍

客户端一切都是以git仓库作为依据,所以手动导入一本书籍的话,需要把这些都提交到本地git仓库。才能被打开

1.2.1.4. 预览书籍

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

$ gitbook serve

运行该命令后会在书籍的文件夹中生成一个 _book 文件夹, 里面的内容即为生成的 html 文件.

我们可以使用下面命令来生成网页而不开启服务器

gitbook build
mrcode            updated 2020-04-13 05:46:38

results matching ""

    No results matching ""