GitBook安装和使用

GitBook安装和使用

环境要求

NodeJS(v4.0.0及以上)   
注意,推荐安装 node-v-4.6.0,最新的node-v-8 在测试本地化html时有问题

下载地址： https://nodejs.org/en/blog/release/v4.6.0/    

通过NPM安装
运行下面的命令进行安装

npm install gitbook-cli -g

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

编辑书籍
具体编辑方法,可以在以下链接中最后查看,或自行百度

http://www.jianshu.com/p/430f4569d776

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

gitbook serve

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

gitbook build --gitbook==2.6.7

注意
以下为win10系统下各环境版本
node :v4.6.0
CLI version: 2.3.2
GitBook version: 2.6.7
特别注意一点,GitBook version的版本如果为最新的 3.2.2 时,在使用 gitbook build命令生成的html不能直接打开使用,里面的a链接出现问题,此时你可以使用 gitbook build --gitbook=2.6.7来解决,如果出现错误时,请查看你的node版本,

解决方案:
1,先卸载gitbook

gitbook uninstall 3.2.2

2,卸载node

使用win10 程序管理卸载

3,重新安装 node-v-4.6.0

下载地址： https://nodejs.org/en/blog/release/v4.6.0/

4.在你的书籍文档中 再次使用一下命令,此时会自动安装2.6.7版本

gitbook build --gitbook=2.6.7