博客配置 LaTeX 过程中遇到的问题

本文最后更新于:2022年7月30日

记录一下博客配置 过程中遇到的问题。

Fluid 主题的 配置很简单,手册里有详细的教程。考虑到 KaTeX 有小部分 语法不支持,所以我配置的是 MathJax 。

但是当我写完一篇文章发布后,我发现\overline命令生成的上划线无端消失了,就像 变成了 。经过一番搜索,我在 github 上看到了相关的 issue:在浏览器的某些缩放下,上划线会消失,不知道这个 bug 什么时候会被修复。不过 issue 里提到了一个解决办法:将公式渲染为 SVG 就可以正常显示了。

有两种方案可以更改公式的显示方式:

  • 读者手动更改,右键数学公式打开扩展功能->Math settings->Math Renderer->SVG。但是这样很不方便,并且我觉得不能依赖读者自己调节相关显示。
  • 使网页默认以 SVG 格式显示。但是我完全不懂前端,利用 Hexo 和 Fluid 搭建的博客对我来说就像一个黑箱,我能做的只是修改配置文件中的一些参数,但是他们并没有把我想要的功能写进配置文件。因此这个方法也行不通。

秉持着“我遇到的问题一定有人也遇到过”的原则,我进行了进一步的搜索。

最后我在一篇博客中发现了解决办法。借助hexo-filter-mathjax插件,我们就可以实现后端渲染。

首先卸载其他的公式相关插件,如hexo-math,然后安装hexo-filter-mathjax插件,建议配合hexo-renderer-pandoc一起使用(本地可能也要装pandoc)。

1
2
npm i hexo-filter-mathjax
npm i hexo-renderer-pandoc

其原理大概是渲染器 pandoc 会先将Markdown文件中的 代码渲染成 Mathjax 代码,而后使用 Mathjax 官方提供的Node.js的库将 Mathjax 代码渲染成 SVG 嵌入 html 。并且采用后端渲染方案后,由于不用加载 js 文件,网页渲染速度变快了不少。

添加physics宏包支持

MathJax 从v3.0 开始支持braket 和 physics 宏包。对于笔者来说,physics 宏包是非常有用的,它定义了相当多的宏,让物理公式的输入更加方便快捷。也正因为它定义了相当多的宏, MathJax 默认状态下不支持该宏包

hexo-filter-mathjax插件提供了配置扩展的接口,但是我并不清楚应该填入什么样的内容。

1
2
3
extension_options: {}
# you can put your extension options here
# see http://docs.mathjax.org/en/latest/options/input/tex.html#tex-extension-options for more detail

最后经过摸索,找出了一个可行的办法:修改mathjax-full\js\input\tex\AllPackages.js中的exports.AllPackages,加入physics,使其默认加载physics宏包。

修改后的结果
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
exports.AllPackages = [
'base',
'action',
'ams',
'amscd',
'bbox',
'boldsymbol',
'braket',
'bussproofs',
'cancel',
'cases',
'centernot',
'color',
'colortbl',
'empheq',
'enclose',
'extpfeil',
'gensymb',
'html',
'mathtools',
'mhchem',
'newcommand',
'noerrors',
'noundefined',
'upgreek',
'unicode',
'verb',
'configmacros',
'tagformat',
'textcomp',
'textmacros',
'physics'
];

但是这样无法避免设置在更新之后被覆盖!
笔者尚未找出更优雅的方式。

2022.07.30更新

作者在我提的 issue 中给出了配置说明,顺便我的 issue 帮他修了一个 bug(**)。

按照作者给出的方法修改后就可以愉快地使用physics宏包和其他宏包了。

1
2
3
4
5
6
7
8
9
10
11
12
\dd{(x^2)}=2x \dd{x}

\bra{\psi} \quad \ket{\psi}

\laplacian{\Psi} \quad \curl{\vb{a}} \quad \div{\vb{a}} \quad \grad{\Psi}

\begin{vmatrix}
1 & 2\\
3 & 4\\
\end{vmatrix}

\verb|\sqrt|

一些感想

上文提到过,利用 Hexo 和 Fluid 搭建的博客对我来说就像一个黑箱,这样对于用户虽然简单,但也是一种束缚。

用户只能在作者的配置文件中做一些修改,很多涉及底层的修改都显得比较困难。

我们应该如何去看待这种黑箱呢?

其实这和现代社会很类似,我们并不理解它的底层逻辑,甚至我们也不了解每天随处可见的物品,比如手机的原理,公交车的调度等等。

那我们又应该以什么样的态度去看待我们的日常生活呢?