关于Hexo博客的一些解决方案
- 若
generate
或deploy
建站时遇到bug,尝试运行hexo clean
清空缓存。
- 使用主题时,若主题是子模块,需要在博客根目录下新建
.gitmodules
并添加相关信息指向子模块。
- 若
hexo server
后访问http://localhost:4000/,网页崩溃且只输出 Cannot GET/
,应当尝试运行npm install
确保包都是正常状态。
- 公式包使用hexo-renderer-markdown-it-plus,同时必须将
MathJax Support
中true
改成false
,否则会冲突。若出现渲染出一个正确公式和一个错误公式,说明缺少hexo-math
,应当运行npm install hexo-math --save
。
- 有时候会遇见在netlify上建站的时候,
hexo-img-locator
模块找不到图片的问题,这时候应该注意做以下两个检查:
- 检查图片所在的文件是不是被放到
.gitignore
里面了,如果是的话,这些图片根本不会被推送到远程仓库里面去,自然就要不存在路径
- 检查图片的相对路径使用的分隔符是正斜杠
/
还是反斜杠 \
,在本地 Windows 系统可能差别不大, hexo-img-locator
可以正常替换,但是在 Netlify 的类 Unix 系统中只能识别正斜杠 /
为文件路径的分隔符。