从零开始的Hexo博客搭建教程(七):遇到的坑

从零开始的Hexo博客搭建教程(七):遇到的坑

✨《从零开始的 Hexo 博客搭建教程(how-to-build-hexo-blog)》终于到了第七辑啦!

本文用于 收集本人在使用 Hexo 的过程中出现的 各种坑及解决方法

如果你有更好的解决方法或遇过的坑,欢迎在评论区分享喔 ο(=•ω <=)ρ⌒☆

Template render error

问题描述

在使用 hexo g 生成文章的时候,控制台报错如下:

1
2
3
FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html
Template render error: (unknown path) [Line 12, Column 17]
expected variable end

出现原因

当文章中有 }} 或 EJS 模板语法,且未被代码块包含时,解析会出现问题。

包含EJS模板语法的markdown文件

解决方法

1
2
{% raw %}
放到代码块中就OK啦

注意: 用单反引号包围还是会引发BUG,请使用三反引号包围。

Sitemap.xml 出现错误

问题描述

解决方法

请勿使文章名或 md 文件名包含 & 符号 导致 hexo 文章链接中也包含该符号。

去除后再重新生成即可恢复正常。

ERROR Deployer not found: git

解决方法

执行 npm install hexo-deployer-git --save 即可

之后请一步一步配置



📘《从零开始的Hexo博客搭建教程》系列文章:

  1. 从零开始的Hexo博客搭建教程(一):开始
  2. 从零开始的Hexo博客搭建教程(二):主题
  3. 从零开始的Hexo博客搭建教程(三):SEO优化
  4. 从零开始的Hexo博客搭建教程(四):图床
  5. 从零开始的Hexo博客搭建教程(五):文章发布
  6. 从零开始的Hexo博客搭建教程(六):插件
  7. 从零开始的Hexo博客搭建教程(七):遇到的坑

评论

Blog tasks

1 / 4 tasks

  • About 页面大修

    • Mark done
    • Edit
    • Delete
  • TOC 滚动更新位置
  • 设计 Logo SVG

    • Mark done
    • Edit
    • Delete
  • todo 小组件大小单位用 rem

    • Mark done
    • Edit
    • Delete
Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×