У меня есть несколько модулей Python, содержащих в основном функции и несколько классов. Каждый из них задокументирован с помощью sphinx-autodoc в отдельном файле rst. Что я хочу сделать, так это создать таблицу или список содержимого модуля в верхней части каждой страницы, например, для mymodule.py
def first():
'First function'
def second():
'Second function'
и mymodule.rst
Page Contents
-------------
:create_page_contents_list:
Members
-------
.. automodule:: mymodule
:members:
. Тогда вывод должен выглядеть примерно так это:
Page Contents
-------------
first
second
Members
-------
first()
First function
second()
Second function
Вопрос как сделать :create_page_contents_list:
. Я рассмотрел использование TOC, но кажется, что мне нужно вручную создать запись для каждого элемента. Я также просмотрел автосводку, но мне все еще нужно перечислить участников. Любые предложения по автоматизации этого? Я бы предпочел избегать сторонних расширений.