一、安装gitbook
我这里用的node安装的
参考地址:https://github.com/GitbookIO/gitbook/blob/master/docs/setup.md
1.前提是电脑中已经安装了node 并且已经配置了node 的环境变量,在命令行中执行如下命令:

 npm install gitbook-cli -g

在这里插入图片描述
2.查看gitbook 是否安装成功,执行如下命令:

gitbook -V

注意:
这里可能会提示:‘gitbook’ 不是内部或外部命令,也不是可运行的程序或批处理文件
解决:
a.在命令窗口输入以下命令:

npm config set prefix "E:\softwork\nodejs\npm\node_modules\node_global"
npm config set cache "e:\softwork\nodejs\npm\cache"

这个根据你电脑上的nodejs的实际路径来。
查看是否配置成功:

npm config list

在这里插入图片描述
b.配置环境变量
添加系统变量:
变量名:NODE_PATH
变量值:E:\softwork\nodejs\npm\node_modules\node_global
在这里插入图片描述
将%NODE_PATH%添加到Path中
在这里插入图片描述
配置完毕后,另起一个命令行窗口执行gitbook -V命令:
在这里插入图片描述
这样gitbook 算是完全安装成功了
二、使用gitbook本地编译成离线版本
1.将代码克隆到本地,根据自己的实际要克隆的代码来,然后将源码解压,命令行进入此目录
2.执行 gitbook serve
注意:
这里可能出现错误:Error: Couldn’t locate plugins “github, codesnippet, splitter, page-toc-button, image-captions, editlink, back-to-top-button, search-plus, github-buttons, favicon, tbfed-pagefooter, 3-ba, prism, prism-themes, sitemap-general, lightbox, adsense”, Run ‘gitbook install’ to install plugins from registry.
在这里插入图片描述
解决:
a.执行命令:gitbook install
在这里插入图片描述
b.在执行gitbook serve命令,来预览这本书籍
在这里插入图片描述

3.在浏览器中访问 http://localhost:4000
4.生成的文档在 _book 目录下

Logo

瓜分20万奖金 获得内推名额 丰厚实物奖励 易参与易上手

更多推荐