1. IT柚子首页
  2. 工具手册

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/ ,国外的地址下载可能有点慢,可以使用迅雷下载。

GitBook Editor 安装和编辑GitBook电子书

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

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

2、安装GitBook环境

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

GitBook Editor 安装和编辑GitBook电子书

三:安装GitBook Editor

1、软件安装和使用

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

GitBook Editor 安装和编辑GitBook电子书

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

GitBook Editor 安装和编辑GitBook电子书

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

GitBook Editor 安装和编辑GitBook电子书

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

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

GitBook Editor 安装和编辑GitBook电子书

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

GitBook Editor 安装和编辑GitBook电子书

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

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

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

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

GitBook Editor 安装和编辑GitBook电子书

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

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

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

 

GitBook Editor 安装和编辑GitBook电子书

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

四:总结

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

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

发布者:柚子,转转请注明出处:https://ityouzi.com/archives/gitbook-editor-gitbook-use.html

发表评论

电子邮件地址不会被公开。 必填项已用*标注