Windows安装Nodejs、Gitbook、GitBook Editor-2023年版

提示：

1、不少安装文档存在各种各样的问题，请务必按照下文所述，一步安装成功

2、换电脑备忘：Gitbook是电子书工具，Gitbook Editor是离线客户端、nodejs是Gitbook的底层语言依赖

3、通过本步骤，可一步步完成离线Gitbook环境的搭建

1、安装nodejs

1、点击进入node.js下载链接，下载node-v6.14.4-x64.msi(64位系统），注意一定要选这个版本

 

2、运行msi安装程序，点击next。

 3、勾选协议，next。

 4、更换安装路径，非C盘原则。

 5、不需要选择或更换，默认安装，直接next，它会自动添加系统变量。

 6、直接next，无需勾选

 7、点击install

 8、Finish。

 9、cmd进入命令行界面，输入node -v 显示node版本，输入npm -v显示npm版本，如果都能显示则安装成功。

 2、安装Gitbook

1、在cmd输入下面的命令来安装 GitBook

npm install gitbook-cli -g

 2、查看版本检验是否安装成功

gitbook -V

首次，查看版本号会进行GitBook的安装操作； 安装完成后，再查看版本号即可；

 3、第二次查看版本号

 Gitbook安装完成，此时可以通过Gitbook命令发布并查看电子书，我们先继续安装Gitbook Editor，后面再发布

3、安装gitbook editor windows版

官网地址：gitbook editor windows版

 备用下载链接：https://pan.baidu.com/s/1nX6FRtyzvdNXj8ijaVIfng  提取码：3b7w  

1、直接运行.exe文件，如图：

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

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

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

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

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

 4、发布并查看编辑好的电子书

1、先在cmd里进入到点电子书的目录，命令：cd /d C:\Users\admin\Desktop\GitBook\Import\test 其中的目录地址替换成自己的。

 2、初始化一本书；

gitbook init

在使用 gitbook init 之后本地会生成两个文件 README.md 和 SUMMARY.md ，这两个文件都是必须的，一个为介绍，一个为目录结构。

3、发布电子书

gitbook build
gitbook build ./{book_name} --output=./{outputFolde}
gitbook build ./ --log=debug --debug

当电子书内容制作好之后，可以使用如下命令来生成 HTML 静态网页版电子书。该命令会在当前文件夹中生成 _book 文件夹，这个文件夹中的内容就是静态网页版电子书。

使用 --log=debug --debug 可以用来调试，会打印出 stack trace。

4、本地预览发布好的电子书

gitbook serve
gitbook serve ./{book_name}

当电子书内容制作好之后，可以使用如下命令来生成 HTML 静态网页版电子书。该命令会在当前文件夹中生成 _book 文件夹，这个文件夹中的内容就是静态网页版电子书。

使用 --log=debug --debug 可以用来调试，会打印出 stack trace。

5、查看运行结果

然后在浏览器中输入“http://localhost:4000”即可预览电子书内容，预览完毕后按 Ctrl + C 结束。

 6、后续若书籍内容有更新，

通过cmd进入书籍目录命令：cd /d C:\Users\admin\Desktop\GitBook\Import\test 其中的目录地址替换成自己的。

然后依次执行2-6即可发布并预览效果

 

参考：

1、全网最详细的nodejs卸载和安装教程

2、GitBook安装、配置、制作电子书（一）

3、记一次gitbook的安装

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