Как сделать внутреннюю ссылку на заголовок в рестрикционном тексте sphinx без создания произвольных меток?

У меня есть документ со многими заголовками и подзаголовками. Далее в текст я хочу вернуться к одному из заголовков. Как я могу сделать это без избыточности ярлыков :ref:? Содержимое, похоже, отлично подходит для заголовков. Я надеялся на что-то вроде этого: `#polled-data-retrieval`_.

Ответ 1

reStructuredText поддерживает неявные цели гиперссылки. В краткая ссылка reStructuredText:

Заголовки разделов, сноски и цитаты автоматически генерируют цели гиперссылки (в качестве имени гиперссылки используется текст заголовка или сноска/обозначение цитирования).

Итак, следующий текст (снятый с быстрой ссылки reStructuredText, орфографические ошибки и все):

Titles are targets, too
=======================
Implict references, like `Titles are targets, too`_.

создает HTML, похожий на следующий:

<strong><a name="title">Titles are targets, too</a></strong>

<p>Implict references, like <a href="#title">Titles are targets, too</a>.</p>

Ответ 2

Новый, лучший ответ на 2016 год!

Расширение автообновления позволяет вам делать это легко, с реальными перекрестными ссылками.

=============
Some Document
=============


Internal Headline
=================

затем, позже...

===============
Some Other Doc
===============


A link-  :ref:`Internal Headline`

Это расширение встроено, поэтому вам нужно только отредактировать conf.py

extensions = [
    .
    . other
    . extensions
    . already
    . listed
    .
    'sphinx.ext.autosectionlabel',
]

Единственное, что вам нужно быть осторожным, это то, что теперь вы не можете дублировать внутренние заголовки в коллекции документов. (Стоит это.)