在使用gitbook
写东西的时候,当文档内容有更新的时候,会自动更新内容到页面上,方便预览。但是,存在一个bug,就是会神奇的崩溃掉,出现如下的错误提示:
Restart after change in file README.md
Stopping server
events.js:183
throw er; // Unhandled 'error' event
^
Error: EPERM: operation not permitted, lstat 'F:workspaceprivate-cloud-backupgitbook-test\_book'
解决方案也很简单,重新运行一下gitbook serve
命令即可。有时候每保存一下,就会崩溃一下,这就有点烦了。
网上搜一下,有没有现在的解决方案
遇到问题,首先问问百度谷歌,毕竟是面向搜索引擎的开发人员嘛。
网上有大佬对这个事故,做了深入的分析,分析过程很详细,我就不说了,重点引用一下结论:
windows 系统上启动 gitbook 服务后,如果本地文件发生更改,热加会失败.
如果启动服务器后立即删除 _book 目录,那么之后再怎么修改本地文件都能顺利重启.
目前还没有找到问题的根源,下一次将深入源码继续探讨到底是哪里出问题导致 Windows 系统无法重启.
虽然及时删除 _book 目录并不算是很好的解决方案,但至少 markdown 灰姑娘又能化妆成 html 小姐姐了呢!
有兴趣的朋友可以阅读一下原文 https://juejin.cn/post/6844903840332939277
虽然大佬分析的很详细,但是也没能从中找到一个简单的可执行方案。
换种思路,解决问题
回过头来,换一种思路再来考虑这个问题,我们使用gitbook
是为了写作,而gitbook serve
只是为了让我们可以随时预览自己的写作结果。当出现问题时,我们的手工解决方案是重启一即可,那我们能不能让他崩溃时自动重启呢?
关于自动重启的方案,首先想到的是守护进程。关于守护进程,要么自己写一个,要么网上找一个,感觉这都太重了,不是我想要的。于是又了解了一下bat
批处理脚本能不能解决,你别说,还真可以:
::该脚本为启动gitbook本地服务器,当服务崩溃时会自动重启
@echo off
:rungitbook
call gitbook serve
@goto rungitbook
将以上代码,在文档目录保存为gitbook.serve.bat
,然后双击运行。当gitbook serve
崩溃时,会自动重新启动。
至此,问题就算是解决了。
其它
常用命令
命令 | 说明 |
---|---|
gitbook init | 在当前目录初始化gitbook 目录结构 |
gitbook build | 将文档编译为html文件 |
gitbook serve | 启动gitbook 服务 |
发布到Github
发布到Github只需要git push
即可。这种方式只能将文档同步到Github
上,我们还需要将编译结果直接作为网页发布,这里推荐使用gh-pages
。
使用
gh-pages
只是将指定目录发布到gh-pages
分支,你首先需要在Github
上建立相应仓库。
安装
gh-pages
是一个nodejs包,首先你需要安装nodejs环境。
然后,运行以下命令安装gh-pages
。
npm install -g gh-pages
发布到gh-pages
安装好gh-pages
后,就可以使用gh-pages
将编译结果发布到Github上了。
gh-pages -d _book