由于 HTML-CSS 渲染器，使用 Sphinx 渲染 MathJax 时出现问题

Question

我刚刚升级到以下：

Sphinx==1.8.5
nbconvert==5.4.1
pandoc==1.0.2

我一直能够使用 Sphinx 通过 jupyter notebook 在文档中呈现数学（seaborn 的方式）。但是，升级后，数学不再呈现！如果我右键单击方程所在的位置，我可以将数学渲染器更改为 "svg" 或 "CommonHTML"，一切都很好 - 它只是不使用默认的 "HTML-CSS" 数学渲染器渲染无论出于何种原因。我的问题是：如何更改配置文件中的默认渲染器？

我尝试了什么：

conf.py

...
extensions = [
    ...
    'sphinx.ext.mathjax'
    ...
]
...

mathjax_config = {
    'jax': ['input/TeX', 'output/CommonHTML']
}

但是，这并没有像我认为的那样更改默认渲染器。有谁知道如何在 Sphinx 中更改 MathJax 的默认渲染器？

这是一张动图：

此外，MathJax 似乎是从 CDN 加载的首选配置：

Answer 1

我不确定 MathJax 之前是如何为您工作的，但是基于 Sphinx-documentation MathJax is not included in Sphinx by default. You have to specify the mathjax_path in your conf.py either using a local version or a server hosted one from cdnjs 例如。

Answer 2

虽然我无法使 mathjax_config 方法起作用，但我能够将 mathjax_path 设置为特定的输出处理器，仍然是通过使用 CommonHTML 的 CDN。

因此，一个有效的答案是编辑 conf.py 文件以包含一行：

...
mathjax_path = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML"
...

由于 HTML-CSS 渲染器，使用 Sphinx 渲染 MathJax 时出现问题

Issues rendering MathJax using Sphinx due to HTML-CSS renderer

python

mathjax

python-sphinx

autodoc