Sphinx: список функций в модуле

У меня есть несколько модулей 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, но кажется, что мне нужно вручную создать запись для каждого элемента. Я также просмотрел автосводку, но мне все еще нужно перечислить участников. Любые предложения по автоматизации этого? Я бы предпочел избегать сторонних расширений.

11
задан Wooble 19 March 2012 в 14:03
поделиться