Python sphinx MathJax未在Sphinx中渲染

我在Sphinx reST中有一个文档集。 我在conf.py中包含了sphinx.ext.mathjax，并包含了行“mathjax_path=”。 我相信，在向rst文件添加标记之前，我只需要做这些。但是我的方程没有被渲染。比如说,

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

从浏览器中显示为

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

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

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

\（a^2+b^2=c^2\）

您仍然需要在conf.py文件中声明sphinx文档的扩展名

在conf.py文件的顶部，在“常规配置”下导入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_路径相结合应该可以工作。

这里有一些选项：

1） 您必须安装libjs-mathjax：

apt-get install libjs-mathjax

2） 您应该在文档行前加上“r”前缀：

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

"""

3） 您必须避免方程中的空格（使用“r”前缀您可以避免此解决方案）

4） 你可以混合所有以前的解决方案

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

"""

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

"""

---

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

---

@caduceus和你确定你有一个正常的互联网连接。。。。只是检查一下，否则你需要下载mathjax并提供一个本地路径让它工作。未来的注意事项：cdn.mathjax.org即将结束，请检查迁移提示。未来的注意事项：cdn.mathjax.org即将结束，请检查迁移提示（也许还可以为未来的读者更新你的帖子）。

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