解决Aurora数学公式渲染问题
众所周知,Aurora主题的原作者已经不再修理该主题了,那么就需要我们用户自力更生了。最近看群里小伙伴都苦于Aurora主题不对数学公式进行渲染的问题,当然我也是其中一位,这里给出我的解决方案。
在这里感谢溴麝香草酚蓝水溶液大佬的指导
参考文章《easyhexo》
一、解决方案
我的解决方案是安装hexo-renderer-pandoc
和hexo-filter-mathjax
。这里hexo-renderer-pandoc
是可选的,hexo-filter-mathjax
是一个用于Hexo渲染MathJax
的插件
安装mathjax插件不需要前端脚本与其他数学公式插件,因此一定要保证主题的干净,将其他数学插件删除干净
二、教程
2.1 安装Mathjax
Aurora主题很干净,我们直接安装hexo-filter-mathjax
即可。在博客根目录下命令行运行
1 | npm install hexo-filter-mathjax |
2.2 配置
配置站点文件,把以下内容添加加<Hexo>/_config.yml
文件:
1 | mathjax: |
2.3 使用
在需要启用mathjax的文章front-matter
内添加mathjax: true
1 | --- |
这样就可以在文章中使用LaTex
语法了。
三、渲染器
需要注意,使用hexo-filter-mathjax
,内联公式(… $ …)在开头$之后和结尾$之前不能有空格,例如:
1 | -$ \epsilon_0 $ |
3.1 安装pandoc
官方给出说明可以使用更好的数学公式渲染器hexo-renderer-pandoc
。下面我们安装pandoc
渲染器。
首先我要确保我们本地已安装pandoc(版本$\geq$2.0)。然后,在博客根目录命令行下运行命令安装hexo-renderer-pandoc
,
1 | $ npm install hexo-renderer-pandoc --save |
默认情况下,此插件发出命令来调用 pandoc
。如果您的 pandoc
可执行文件不在搜索路径环境变量中(即你自己把pandoc默认安装路径换了),您可以通过 覆盖此命令。在博客站源文件_config.yml
添加如下内容,这里将路径改为你pandoc
的路径即可。
1 | pandoc: |
若你同样安装了Anaconda
其中的版本很低,你需要将其替换为下载的pandoc.exe
四、效果
1 | $$ |