如何选择与sphinx交叉引用中的文本使用？

Question

使用sphinx，我使用以下语法包含了一个数字。

.. _struct_NiO:

.. figure:: img/NiO.png
   :align: center
   :width: 400px

   long long very long caption ...

在我使用的文本的另一部分

See figure :ref:`struct_NiO` bla bla bla

为了对图进行交叉引用。这项工作，但输出看起来像：

见图“长很长的标题......”bla bla bla。

这是狮身人面像的正常行为，但是如果你有一个有点复杂的数字，有3或4行标题，它就没有真正适应。

是否可以选择交叉引用中使用的文本？

Answer 1

您可以为:ref:目标提供自定义链接文字，如下所示：

See figure :ref:`Link text <struct_NiO>` bla bla bla

见http://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#ref-role。