GitBook Editor 安装和编辑GitBook电子书

一：Gitbook介绍

GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书，GitBook 并非关于 Git 的教程。从名字来看可能产生误解，以为是有关Git的一本书，其实2者之间是没有直接关系的。

官网地址：https://www.gitbook.com/
官方文档：https://docs.gitbook.com/

GitBook Editor 则是基于Windows操作系统针对GitBook的一个图形化编辑工具。

官网地址：https://legacy.gitbook.com/editor

二：GitBook的安装

1、安装Node.js的环境

因为GitBook是基于Node.js的，所以需要先安装Node.js的环境。
软件下载地址：https://nodejs.org/en/download/ ，国外的地址下载可能有点慢，可以使用迅雷下载。

下载完成以后安装就直接下一步、下一步即可。

安装完成以后可以通过命令来检查结果， 此时可以在cmd控制台进行验证（win+r）,输入cmd进入控制台输入：node -v ，如果安装成功了会显示对应的版本号。

2、安装GitBook环境

打开控制台，输入： npm install gitbook-cli -g 。
安装完成以后输入：gitbook -v ，来检查安装结果，见下图。

三：安装GitBook Editor

1、软件安装和使用

软件下载地址：https://legacy.gitbook.com/editor

下载完成以后双击直接安装，过一会就自动安装完成了，此时桌面就有“GitBook Editor”的图标了，点击以后就弹出登录的界面。如果是本地编辑的话可以选择不登录。

选择不登录以后就可以使用了，在创建电子书前先设置下文件的存储的目录，见下图。

设置好目录以后就可以开始创建电子书了，点击蓝色的大按钮“+ New Book”。
然后输入电子书的名称，输入好以后点击下面的“Confirm”的按钮。

创建好电子书以后就能开始编辑电子书了，同时在开始设置的目录下面也能看到相关文件（下图）。

到这里就可以正常的编辑电子书了，下面是我做的一个简单的测试效果。

具体的如何使用编辑器我这里就不赘述了，大家自己去研究琢磨吧。

2、如何查看编辑好的电子书

先定位到点电子书的目录，命令：cd /d C:\Users\admin\Desktop\GitBook\Import\test 其中的目录地址替换成自己的。

然后输入命令： gitbook serve ，等处理成功了会提示url地址和端口，在浏览器中访问这个地址就可以看到自己的电子书了。
http://127.0.0.1:4000/  ，下图。

到上面为止本地预览是可以了，如果生成HTML然后可以发布到线上去了？

• 先定位到电子书的目录，命令：cd /d C:\Users\admin\Desktop\GitBook\Import\test 其中的目录替换成自己的。
• 先创建一个存储HTML的目录，命令： mkdir outbook 。
• 然后构建HTML，命令： gitbook build ./ ./outbook 。

通过上面的三步操作，HTML文件就生成成功了，见下图。

然后将outbook整个文件发布到IIS或其他的web容器中就可以了。

四：总结

通过GitBook做的电子书案例：
http://www.chengweiyang.cn/gitbook/installation/README.html
https://blankj.com/gitbook/

本文只是简单的安装和使用，GitBook和GitBook Editor的功能还很强大，大家自己去琢磨吧。以上只是自己的一点愚见，有正之处还请见谅和指正，谢谢！