我准备用 Jekyll + Github page 搭建自己的技术博客. 但是有个问题, 技术文章中不可避免地需要使用到数学公式, Jekyll 原生的 Markdown 解释器总是不能很好地使用 Latex. 通过查阅资料, 我最终解决了这个问题. 下面是我的做法:
-
禁用 Kramdown 自带的公式解释器:
在
_config.yml中加入:kramdown: math_engine: null - 导入 mathjax 的 javascript 代码:
在
_includes下新建文件latex.html, 粘贴上以下内容:<script type="text/x-mathjax-config"> MathJax.Hub.Config({ TeX: { equationNumbers: { autoNumber: "AMS" } }, tex2jax: { inlineMath: [ ['$','$'] ], displayMath: [ ['$$','$$'] ], processEscapes: true, } }); </script> <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"> </script> - 把 mathjax include 到 html 的
<head>标签中： 这一步根据你使用的主题的不同, 修改 _layouts 文件 或是 _includes 文件. 总之就是找到<head>标签定义的地方然后加入 include 代码. 我使用的主题是 minima, minima 的<head>标签定义在_includes/head.html中. 因此我在自己的博客目录下新建文件_includes/head.html来覆盖主题默认的文件, 粘贴上以下内容:<head> <meta charset="utf-8"> ... {% unless page.no_latex %} {% include latex.html %} {% endunless %} </head>
大功告成! 在 \$ \$ 之间的 LaTex 会变成行内公式就像这样: $\mathrm{e}^{\pi\mathrm{i}}+1=0$ 转换成 $\mathrm{e}^{\pi\mathrm{i}}+1=0$ ; 新起一段并且在 \$\$ \$\$ 之间的 LaTeX 会变成段落公式就像这样:
$$
H_n=1+\frac{1}{2}+\frac{1}{3}+...+\frac{1}{n}=\sum_{i=1}^{n}\frac{1}{i}=O(\log n)
$$
转换成
\[H_n=1+\frac{1}{2}+\frac{1}{3}+...+\frac{1}{n}=\sum_{i=1}^{n}\frac{1}{i}=O(\log n)\]