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”的图标了,点击以后就弹出登录的界面。如果是本地编辑的话可以选择不登录。

GitBook Editor 安装和编辑GitBook电子书

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

GitBook Editor 安装和编辑GitBook电子书

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

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

GitBook Editor 安装和编辑GitBook电子书

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

GitBook Editor 安装和编辑GitBook电子书

 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可视化工具

 
 
posted @ 2023-10-07 16:36  驴得水  阅读(482)  评论(0编辑  收藏  举报