Можно ли настроить Sphinx для автоматического создания закладок на основе номера заголовка (не текста)?

Question

У меня есть большое справочное руководство по ошибкам, которое конвертируется для размещения на readthedocs с использованием Sphinx. Я хотел бы иметь возможность ссылаться на пользователей, используя постоянную закладку на основе номера раздела (не заголовка текста), поскольку это то, что возвращается в коде ошибки из программного обеспечения. У меня есть что-то вроде:

This has a chapter heading automatically numbered to give 1.
============================================================

This has a section heading automatically numbered to give 1.1
-------------------------------------------------------------

- This has no section heading as it's in a list, but is ideally 
where I want to send people using the number 1.1.1.  If that's 
too tricky, then a link to the number of the section (1.1) is fine.

Я хотел бы иметь возможность автоматически создавать закладки, основанные на номере раздела , а не на его заголовке:

You got error code 1.1.1 so you need to go to:
www.mysite.readthedocs.io/blah/blah.html#bookmark1.1

Кто-нибудь знает, если / как это можно сделать без ручного создания пользовательских закладок для каждого раздела? Заранее спасибо:)

PS - предложения, означающие, что мне нужно знать, каким будет автоматически нумерованный номер раздела, работать не будут (например: Заменить якорь на '# id1', ' # id2 ',' # id3 '... Sphinx )

Answer 1

Не уверен, что я полностью понял требования, но мне кажется, что :numref: роль может быть полезна в этом случае.

.. toctree::
    :numbered:

.. _ping:

Ping
====

See :numref:`section "{name}" ({num}) <ping>`.


.. _pong:

Pong
====

See :numref:`section "{name}" ({num}) <pong>`.