最近打算做个WEB系统的在线帮助,又不想开发,于是上网搜罗下有什么好用的工具。
于是发现了 gitbook,我在win10下使用,所以其它操作系统的就不记录了。
从网友分享的文章中总结出,要成功使用 gitbook 需要安装以下内容:
1、Node.js
2、gitbook
3、gitbook editor (windows下的编辑器)
看起来也不复杂,于是我就上手了。。。。
1、找到了 Node.js 官网,下载安装了最新的 Node.js
2、使用了命令:
node -v 很好,版本号没错
npm -v 很好,有版本号
npm install gitbook-cli -g 很好,它有在安装,似乎看起来有点问题,但没有关系
gitbook -V 很好,有版本号
3、找到了网友给的网盘 下载链接:百度网盘 请输入提取码 提取码:3b7w ,下载了 gitbook editor
4、用 gitbook editor 创建一个文件,很好它有保存
……
一切都按部就班的进行着,让我觉得 so easy
没想到啊没想到,gitbook editor 保存的路径我居然没有地方找到,费了一番心思,终于C:\Users\admin\GitBook\Library\Import\ 这下面找到了创建的文件夹,和那些 *.md 文件
OK,不要慌,继续操作
5、在目标文件夹执行下 gitbook serve ,它让我能够通过浏览器访问我的文档。。。
呵呵?并没有!
怎么回事?我怀疑我装了假软件。
经过长年使用D版的经验,我觉得我可能下错版本了,于是翻了网友们的文章,发现2020年以前的才有成功案例,这对我思考问题、解决问题带来了一定的思路。
我找了2020年2月发布的 Node.js V12.15.0 版本
重新来吧。。。
1、安装 Node.js 12.15.0 很好,它成功了
node -v,v12.5.0
npm -v, 8.3.0
2、运行 npm install -g gitbook-cli
不管怎么样,我觉得你能行
gitbook -V,CLI version: 2.3.2,Installing GitBook 3.2.3
3、安装并打开了 gitbook editor
可以在首页设置下默认路径
login ? No! Do This Later
创建一个新文档
4、找到文件夹 做个 gitbook init
看到 finished 就很心安
5、继续做个 gitbool serve
终于看到了心心念念的 Serving book on http://localhost:4000
6、打开浏览器预览下
还是那熟悉的 hello world。
7、终于入坑了,可以开始愉快的操作了。