Question

我在Sphinx reST中设置了文档。我在conf.py中包含了sphinx.ext.mathjax，并包含了“mathjax_path ='http://cdn.mathjax.org/mathjax/latest/MathJax.js'”行。我相信在将标记添加到第一个文件之前，我需要做的就是这些。但我的方程式没有被渲染。例如，

:math:`a^2 + b^2 = c^2`

以浏览器的形式出现

\(a^2 + b^2 = c^2\)

没有花哨的字体或任何东西。 HTML是

<span class="math">\(a^2 + b^2 = c^2\)</span>

Answer 1

您仍需要在conf.py文件中声明对sphinx-doc的扩展。

在conf.py文件的顶部，在“常规配置”下import sys, os之后不久，您将看到有关包含扩展的注释说明。对于mathjax，您需要将其添加到列出的扩展名中：

 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = ['sphinx.ext.todo', 'sphinx.ext.mathjax', 'sphinx.ext.ifconfig']

（我只是复制粘贴我自己，你可能还有其他或没有列出的扩展名。）

与你已经设置的mathjax_path结合使用应该有效。

Answer 2

我遇到了同样的问题。我通过将mathjax_path变量（在conf.py文件上）设置为：

来解决它

mathjax_path="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"

MathJax无法在Sphinx中渲染

2 个答案: