上次更新在 829 天之前,本文的内容可能过时。
机器人
文章摘要
TianliGPT
这篇文章介绍了解决Hexo中Nunjucks错误的方法。文章首先描述了出现的错误现象,即Unhandled rejection Nunjucks Error: _posts/xxx.md [Line 84, Column 13] unknown block tag: 标签。然后介绍了解决这个问题的办法,可以使用raw标签包裹或使用单引号或三引号来避免Nunjucks解析错误。另外,还提到可以通过渲染器的选项、API或前置内容来禁用Nunjucks标签。

Hexo 出错排查

一. Nunjucks Error

现象描述

Unhandled rejection Nunjucks Error: _posts/xxx.md [Line 84, Column 13] unknown block tag: 标签

解决办法

参考 https://hexo.io/docs/troubleshooting.html#Escape-Contents
https://blog.csdn.net/Calvin_zhou/article/details/109303640

泄露(Escape)内容

Hexo 使用 Nunjucks 来解析文章(旧版本使用 Swig,两者语法类似),内容若包含 {{ }}{% %} 可能导致解析错误,您可以用 raw 标签包裹,single backtick {{ }} 或 triple backtick 来避免潜在问题发生。
Alternatively, Nunjucks tags can be disabled through the renderer’s option (if supported), API or front-matter.

plaintext
1
2
3
{% raw %}
Hello {{ world }}
{% endraw %}
plaintext
1
2
3
```
Hello {{ world }}
```