Pelican的render_math插件无法渲染Markdown数学公式求助

1. 修复插件注册报错 #

你遇到的module 'render-math' has no attribute 'register'错误，是因为Python模块名不允许使用横杠，独立仓库的render-math插件实际模块名为render_math（下划线）。修改pelicanconf.py配置：

PLUGIN_PATHS = ['plugins']  # 指向你存放插件的根目录
PLUGINS = ['render_math']   # 使用下划线而非横杠

同时确认插件目录结构：将克隆的独立仓库放在plugins/render_math下（如果克隆时目录名是render-math，建议重命名为render_math，避免模块导入问题），确保该目录下存在__init__.py文件，且文件内包含register函数。

2. 配置MathJax加载参数 #

在pelicanconf.py中添加MathJax相关配置，确保插件能正确注入渲染脚本：

MATH_JAX = {
    'enable': True,
    'url': 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js',
    'config': {
        'tex': {
            'inlineMath': [['$', '$'], ['\\(', '\\)']],
            'displayMath': [['$$', '$$'], ['\\[', '\\]']]
        }
    }
}

这个配置指定了MathJax的CDN地址，以及行内/块级公式的识别规则，和你使用的公式写法匹配。

3. 确保主题支持插件脚本注入 #

Pelican插件通常通过模板中的extra_head或scripts块插入额外资源。检查twitchy主题的templates/base.html文件：

• 在<head>标签内确认存在{% block extra_head %}{% endblock %}
• 或在页面底部（</body>前）确认存在{% block scripts %}{% endblock %}
  如果没有这些块，需要手动添加，这样render-math插件才能把MathJax脚本插入到页面中。

4. 重新生成站点测试 #

1. 删除之前生成的output目录，避免缓存影响
2. 运行pelican content重新生成站点
3. 启动服务后测试你的数学公式（如$x^2$、$$s(t) = \int_{-\infty}^{+\infty} {F(f) e^{j 2 \pi f t} } dt $$），确认是否正常渲染。

内容的提问来源于stack exchange，提问作者JohnA