key: 5 title: 在Jekyll中使用LaTeX math: true
我准备用 Jekyll + Github page 搭建自己的技术博客. 但是有个问题, 技术文章中不可避免地需要使用到数学公式, Jekyll 原生的 Markdown 解释器总是不能很好地使用 Latex. 通过查阅资料, 我最终解决了这个问题. 下面是我的做法:
禁用 Kramdown 自带的公式解释器:
在 _config.yml 中加入:
kramdown:
math_engine: null
_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)
$$
转换成
$$ Hn=1+\frac{1}{2}+\frac{1}{3}+...+\frac{1}{n}=\sum{i=1}^{n}\frac{1}{i}=O(\log n) $$