Hexo 使用指南

因为每次写博客的时间都隔了好久,导致我总是忘记使用 Hexo 写博客的流程

因此,这篇简易的博客诞生了,里面也会更新我写博客时碰到的一些问题

常规流程

使用下面的命令创建一篇新的博客:

hexo n "要创建的文件名"

一般直接使用下面的命令一件生成本地预览:

hexo clean && hexo g && hexo s

建议写个 Makefile 脚本,可以简化流程

碰到的一些问题

Nunjucks Error

这个问题一般是因为在正文里出现了花括号导致的,建议把代码相关的东西全用 md 的代码行或块包围,实在不行可以使用下面的方法:

1
2
3
4
5
6
7
8
假如这里是一段正文,
突然我写了一个{花括号包围的什么东东},
假如只有花括号是会报错的,
那么我们可以这样子改:

这里是被花括号{% raw %}包围{的东东}{% endraw %},
只要把敏感的语句用{% raw %}和{% endraw %}包围起来,
渲染的时候就不会报错了

数学公式

先按照 Fluid 文档开启数学公式的功能

在文章 front-matter 里指定 math: true

如果数学公式不显示,检查一下美元符号是不是和公式之间有空格,得把空格删了才行

1
2
3
4
5
错误示范是这样子的 $ a = a + 1 $ 美元符号和公式间有空格,
渲染的时候是不会成功渲染公式的
但是只要把他们之间的空格去掉就行了,
这是正确的写法 $a = a + 1$ 美元符号和公式间没有空格,
渲染才会正确的运行,只能说他们还可以改进

使用 vs code 的正则表达式搜索,快速校对

\$\s*[^$]+\s*\$:使用它快速寻找文档中所有的数学公式

上面的方法需要人眼观察,对于公式较少的情况比较方便;如果公式数量大,建议编写脚本进行检查

相关文档链接

Hexo 官方文档

Fluid 用户手册

hexo 使用指南 - Clo91eaf’s blog