Я пытаюсь использовать расширение sphinx autodoc и, в частности, директиву автомодуля для автоматической генерации документации для приложения django, над которой я работаю. Проблема в том, что я хочу создавать внутренние ссылки на разные классы внутри модуля, без необходимости использования автокласса и автофункции для каждого отдельного класса/функции внутри проекта. Для исходного файла следующим образом:
# source_code.py
class A:
"""docs for A
"""
pass
class B:
"""docs for B with
:ref:`internal reference to A <XXXX-some-reference-to-A-XXXX>`
"""
pass
Я хотел бы иметь файл документации для sphinx следующим образом:
.. automodule: source_code
Какую ссылку я могу использовать для XXXX-some-reference-to-A-XXXX? Есть ли простой способ сделать это? Заранее благодарим за помощь.