如何引用 Sphinx 中的方程式

Question

我在第一个文件中写了一个等式：

.. math::
   F=\begin{bmatrix} \lambda_1 & 0 & 0\0 & \lambda_2 & 0\0 & 0 & \lambda_3\end{bmatrix}
  :label: eq:6

完美显示为：

现在我想在同一个第一个文件中引用这个等式。我试过类似的东西：

I need to refer to this :ref:`Link title < eq:6>`

但是没有用。我如何link（例如参考）这个等式？

Answer 1

您的 math 角色的缩进不匹配，label 而不是 name 的角色选项不正确，角色及其内容的顺序不正确，以及额外的 space 在您的 link 参考中的 < 之后。

以下适合我。

.. math::
    :name: eq:6

    F=\begin{bmatrix} \lambda_1 & 0 & 0\0 & \lambda_2 & 0\0 & 0 & \lambda_3\end{bmatrix}

I need to refer to this :ref:`Link title <eq:6>`

还有对 :math:numref:, but I do not think that is what you want. There is also the use of ref 的另一种引用，其中可以使用标签作为 ref 的目标。

如何引用 Sphinx 中的方程式

How to refer to an equation in Sphinx

python-sphinx

cross-reference