reST: встроенные ссылки с произвольными заголовками?

Question

Если я определил внутреннюю цель гиперссылки, как я могу ссылаться на нее, используя произвольный текст в качестве заголовка ссылки?

Например:

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

...

A `short reference`_ to the very long link target.

Как сделать так, чтобы «короткая ссылка» была нацелена на «очень длинную внутреннюю цель»?

Редактировать : Другой пример:

Widgets
=======

...

Use a `widget`_.

Как сделать ссылку «виджет» (в единственном числе) на заголовок «виджеты» (множественное число)?

(конечно, я понимаю, что это можно сделать с помощью `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_.

(Ограничение этого подхода заключается в том, что вы можете использовать один и тот же текст (например, "выше") для двух разных местоположений , и в этом случае приведенный выше подход не работает .)