如何选择与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.