1

In reStructuredText, its common to use references to link arbitrary locations in a document.

When there is no title, a caption needs to be given with the reference. eg:

Some text in a paragraph.

.. _my-reference:

Some more text.

Link to :ref:`My Reference <my-reference>` more text.
another link to :ref:`My Reference <my-reference>`.

Is there a way to have the caption text be stored once at the reference location to avoid a lot of repetition on every link?

non-functional example:

Some text in a paragraph.

.. _my-reference: My Reference

Some more text.

Link to :ref:`my-reference` more text.
another link to :ref:`my-reference`.

I'm linking to definitions in long definition lists, so adding titles in the middle isn't an option.

ideasman42
  • 42,413
  • 44
  • 197
  • 320

0 Answers0