python-sphinx - 编号为 :math: equations in reStructuredText

Question

如何在重组文本中制作方程式，后跟方程式编号:

p = f(x)                (1)

.. math::
   p = f(x)

只会导致:

p = f(x)

Answer 1

几年后看这个，似乎这个数字仍然没有自动放在方程的右边。因此，我想补充一下已接受的答案。

首先，在 rst 文件中为方程添加标签:

.. math::
   :label: pfx

   p = f(x)

这将生成 <span>类(class) eqno包含数字和方程的链接。要使其显示为您期望的方程式编号，您需要添加一个样式来覆盖该类的默认行为。

我通常通过添加 custom.css 来做到这一点到 _static/css我的文档根目录下的文件夹:

.math {
    text-align: left;
}
.eqno {
    float: right;
}

math类标签 <div>包含整个方程。没有 text-align: left;风格，你所有的方程都会居中，所以把它们放在左边是完全合理的。

现在您需要在 conf.py 中注册 CSS 文件.我添加了以下基本钩子(Hook):

def setup(app):
    app.add_stylesheet('css/custom.css')

相对路径从 _static 中解析。文件夹。您可以添加 globbing 以一次获取文件夹中的所有文件，但这应该足够了。

原因 @EngineeredBrain's comment报告上一行的一个数字是他们的方程式太长并且不适契约(Contract)一行。我确信有一种方法可以让它们无论如何都适合，但我什至不会尝试在这里讨论。

据我所知，这仅适用于 sphinx(而非 rST)，并且仅适用于 HTML 输出。有一天我会尝试使用 latexpdf 并更新。