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

时间:2019-03-25 16:52:17

标签: python python-sphinx mathjax autodoc

我刚刚升级到以下内容:

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:

enter image description here

此外,似乎MathJax正在使用首选配置从CDN加载:

enter image description here

2 个答案:

答案 0 :(得分:0)

我不确定MathJax以前如何为您工作,但是默认情况下MathJax中不包括基于Sphinx-documentation Sphinx的内容。例如,您必须使用本地版本或cdnjs托管的服务器在mathjax_path中指定conf.py

答案 1 :(得分:0)

虽然我无法使用mathjax_config方法,但是仍然可以通过CDN将mathjax_path设置为特定的输出处理器,该CDN使用CommonHTML。

>

因此,可行的答案是编辑conf.py文件,使其包含以下一行:

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