2020-08-18 17:27:51gitbook安装及踩坑记录

您现在的位置是: 首页 >  php >  gitbook安装及踩坑记录

gitbook 是一款文档编写利器,可以方便地 markdown 输出成美观优雅的 html ,gitbook serve 启动服务器后,原来相貌平平的 markdown 丑小鸭摇身一变就成了倾国倾城的 html 绝色佳人  ，总结文档的一个很好的选择。

gitbook环境搭建-windows篇：

gitbook是基于node.js的一个应用 https://github.com/GitbookIO/gitbook

但官网于2018年年底就放弃维护了.若下载最新版本的node js进行构建则会安装失败,用旧版本的node js即可解决

nodejs旧版总汇:https://nodejs.org/zh-cn/download/releases/

建议使用https://nodejs.org/download/release/v8.11.3/

window包下载地址:https://nodejs.org/download/release/v8.11.3/node-v8.11.3-x64.msi

下载后点击安装即可 然后进入该项目根目录：

npm install -g gitbook-cli
gitbook --version
gitbook install
gitbook build
gitbook serve

踩坑记录：

1. PluginError: Error with plugin "include-html": Cannot find module 'q'

解决办法：npm install incluede-html 

2.Failed to load plugin html: Cannot find module 'eslint-plugin-html'
解决办法：npm install –save-dev eslint-plugin-html

3. 其他踩坑总结链接：
https://zhuanlan.zhihu.com/p/123827414 
https://zhuanlan.zhihu.com/p/123870902 
https://zhuanlan.zhihu.com/p/125577482    

4. 在本地修改gitbook，服务会重启失败，热更不了？

 找了些文章，没有好的解决办法，如果启动服务器后立即删除 _book 目录,那么之后再怎么修改本地文件都能顺利重启。有意思的爬坑文章：https://juejin.im/post/6844903840332939277