Epidoc, разработка которого давно прекратилась, раньше предлагала чрезвычайно мощный обзор класса или модуля. Например, это:
Обратите внимание, что он показывает классы внутри модуля с первой строкой строки документа. Для функций он также показывает прототип функции с указанием начала строки документа и необязательных аргументов.
Это невероятно полезно при просмотре документации, потому что можно просмотреть рационально названные классы/модули и легко найти подходящую функцию или метод.
Я хотел бы иметь аналогичную функцию в Sphinx, но я не могу найти ни одного примера, демонстрирующего это. Честно говоря, я немного удивлен, потому что во всем море похвал Sphinx, кажется, никого не волнует отсутствие этой функции, или, по крайней мере, отсутствие, насколько я могу судить.
Кто-нибудь знает, есть ли способ воспроизвести что-то вроде показанного изображения в Sphinx?