windows 安装gitbook并使用gitbook editor可视化工具

 GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书。

 

一、官网下载nodejs直接安装 

传送门，安装完成后如下：

可以看到npm也安装了，此时可以在cmd控制台进行验证（win+r）,输入cmd进入控制台：

C:\pc>node -v
v8.11.1

C:\pc>npm -v
5.6.0

 

二、安装gitbook

在cmd控制台输入如下命令进行安装：

npm install gitbook-cli -g

查看安装的版本：

C:\pc>gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

 

三、安装gitbook editor windows版

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

直接运行.exe文件.会直接打开gitbook editor ，同时会在桌面生成快捷方式。

之后你就可以创建自己的gitbook了。

四、测试

cmd控制台进入所建的电子书目录下：

输入：gitbook build 生成_book静态文件目录，这个目录就可以拿到任意地方离线打开了。

也可以输入：gitbook serve 启动服务，也会在根目录下生成_book静态文件目录。

然后可以浏览器访问：http://localhost:4000

效果图：

 

 

 

五、问题

生成的静态文件无法跳转

原因：gitbook3.0以后不支持本地预览

解决方法：

1、修改js文件

• 找到项目目录gitbook
• 找到目录下的theme.js文件
• 将if(m)改成if(false) 提示：定位代码位置直接搜索： if(m)for(n.handler&&

这样修改又有一个问题：字体大小和隐藏目录按钮失效。

2、生成指定版本的gitbook

gitbook build --gitbook=2.6.7

系统会自动下载2.6.7版本。2.6.7版本依赖nodejs6，要确保nodejs是6版本。

 

六、Tips

GitBook常用命令
gitbook -V 查看版本号
gitbook init 初始化
gitbook serve 预览
gitbook build 生成
gitbook build --gitbook=2.6.7 生成时指定gitbook的版本, 本地没有会先下载
gitbook uninstall 2.6.7 卸载指定版本号的gitbook
gitbook fetch [version] 获取[版本]下载并安装<版本>
gitbook --help 显示帮助文档
gitbook ls-remote 列出NPM上的可用版本：