在Pelican里显示数学公式

under blog pelican mathjax

in tech

Published: 2016-09-19

render_math插件在Pelican站点里用MathJax显示数学公式,我现在看到的源码是这么处理reStructuredText文档的:

pure主题的index.html模板中,有一段用于为文章列表添加MathJax脚本的jinja代码:

{% if MATH is defined and not MATH['auto_insert'] %}
     {% if page and page.mathjax or article and article.mathjax %}
         {% set mathjax = True %}
     {% endif %}
{% endif %}
{% if loop.last and mathjax is defined %}
     {{ MATHJAXSCRIPT }}
{% endif %}

虽然里面用到了MATH['auto_insert']设置,但细看至少和现在的render_math代码没什么关系,因为render_math用的是MATH_JAX全局设置,并且没有使用或设置文章的mathjax属性,至少reStructuredText用户可以不用理会,因为render_math里的auto_insert只对Markdown格式的文档有影响,并且本文开头分析了render_math如何处理reStructuredText文档,它已经把这部分工作做了。

如果浏览器支持MathML,则可以不用加载MathJax,因为这个动作对网络环境有一定的要求,但使用MathJax至少有三点好处:

(完)