python - reST：带有任意标题的内联链接？

Question

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

例如：

_`这是一个很长的内部链接目标`。

...

对超长链接目标的“短引用”。

我怎样才能使“短参考”目标成为“非常长的内部目标”？

编辑：另一个例子：

小部件
=======

...

使用“小部件”_。

如何将“小部件”（单数）链接到“小部件”（复数）标题？

（当然，我意识到这可以使用`widget`_\s......但这并不能解决一般问题）

Answer 1

我还没有找到使用“标准”reST 的方法。但是使用Sphinx，以下工作：

.. _`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.

Answer 2

很好，mzjn 的回答也适用于类：

:class:`MyClasses <mymodule.MyClass>` in plural is awesome.

欢呼！

Answer 3

pure-reStructuredText 方法是为同一个目标定义多个目标名称：

.. _my widget:
.. _above:
My long title about widgets
===========================
…
See how to use  `my widget`_ in the section above_.

（这种方法的一个限制是您可能希望对两个不同的位置使用相同的文本（例如“上方”），而在这种情况下，上述方法会失败。）