Python reST:带有任意标题的内联链接?

Python reST:带有任意标题的内联链接?,python,documentation,restructuredtext,Python,Documentation,Restructuredtext,如果定义了内部超链接目标,如何使用任意文本作为链接标题链接到它 例如: _`This is a very long internal link target`. ... A `short reference`_ to the very long link target. Widgets ======= ... Use a `widget`_. _`这是一个很长的内部链接目标“”。 ... 指向超长链接目标的“短引用”。 我怎样才能把“短参考”目标变成“很长的内部目标” 编辑:另一个示例:

如果定义了内部超链接目标,如何使用任意文本作为链接标题链接到它

例如:

_`This is a very long internal link target`. ... A `short reference`_ to the very long link target. Widgets ======= ... Use a `widget`_. _`这是一个很长的内部链接目标“”。 ... 指向超长链接目标的“短引用”。 我怎样才能把“短参考”目标变成“很长的内部目标”

编辑:另一个示例:

_`This is a very long internal link target`. ... A `short reference`_ to the very long link target. Widgets ======= ... Use a `widget`_. 小部件 ======= ... 使用“小部件”。 如何将“widget”(单数)链接到“Widgets”(复数)标题


(当然,我意识到这可以通过使用
`widget`\us
…来实现,但这并不能解决一般问题)

我还没有找到一种使用“标准”reST来实现的方法。但是,有了它,以下工作就完成了:

.. _`This is a very long internal link target`:

:ref:`Short reference <This is a very long internal link target>` to the very long link target.
_`这是一个很长的内部链接目标`:
:ref:'Short reference`指向超长链接目标。
很好,也适用于类:

:class:`MyClasses <mymodule.MyClass>` in plural is awesome.
:class:'MyClasses'的复数形式非常棒。

万岁

纯重构文本方法是为同一目标定义多个目标名称:

.. _my widget:
.. _above:
My long title about widgets
===========================
…
See how to use  `my widget`_ in the section above_.
(这种方法的一个限制是,您可能希望在两个不同的位置使用相同的文本(例如“上文”),而在这种情况下,上述方法失败。)