我正在尝试在我的Sphinx文档中显示数学。在conf.py
我添加了sphinx.ext.mathjax
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.viewcode',
'sphinx.ext.graphviz',
'sphinx.ext.mathjax',
'rst2pdf.pdfbuilder',
]
在我的.rst
文件中(因此不在python代码中的文档字符串中),我添加(直接来自文档):
Since Pythagoras, we know that :math:`a^2 + b^2 = c^2`.
.. math::
(a + b)^2 = a^2 + 2ab + b^2
(a - b)^2 = a^2 - 2ab + b^2
输出未设置样式。看一下源html,我看到了:
<div class="section" id="view-angle-and-orientation">
<p>Since Pythagoras, we know that a^2 + b^2 = c^2.</p>
(a + b)^2 = a^2 + 2ab + b^2
(a - b)^2 = a^2 - 2ab + b^2</div>
因此math
指令不会为mathjax插入必要的$$
和\( \)
(也不会有<span class="math">
标记。当我将自己插入第一个时,它就可以了。
如何让数学扩展工作?