由于HTML-CSS渲染器而使用Sphinx渲染MathJax的问题

Question

我刚刚升级到以下内容：

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

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

我尝试了什么：

conf.py

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

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

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

这是一个gif：

此外，似乎MathJax正在从CDN加载首选配置：

Answer 1

我不确定MathJax之前是如何为你工作的，但基于Sphinx-documentation MathJax默认不包含在Sphinx中。您必须使用本地版本或来自mathjax_path的托管服务器在conf.py中指定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"
...