python-sphinx - MathJax 不在 Sphinx 中渲染

Question

我在 Sphinx reST 中有一个文档集。我在 conf.py 中包含了 sphinx.ext.mathjax，并包含了“mathjax_path = ' http://cdn.mathjax.org/mathjax/latest/MathJax.js '”这一行。我相信在向 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>

Answer 1

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

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

Answer 2

您仍然需要在 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 3

这里有一些选项：

1. 您必须安装 libjs-mathjax：

    apt-get install libjs-mathjax

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

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

    """

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

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

   """

4. 您可以混合所有以前的解决方案

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

    """