Sphinx: помещайте заголовок между записями automethod

Question

Я использую Sphinx для документирования класса с большим количеством методов. Я хотел бы, чтобы сгруппировать методы в секциях, разделенных заголовками, как это:

.. autoclass:: MyClass 

    .. automethod:: __init__ 

    FooBar Methods 
    -------------- 

    .. automethod:: foo 
    .. automethod:: bar 

    BazQux Methods 
    -------------- 

    .. automethod:: baz 
    .. automethod:: qux 

Но это не похоже на работу. Можно ли как-то разбить список методов на именованные разделы?

Answer 1

Разделы с заголовками являются конструкциями верхнего уровня, и они не могут использоваться внутри директив. Но rubric работ. Пример:

.. autoclass:: MyClass 

    .. automethod:: __init__ 

    .. rubric:: FooBar Methods 

    .. automethod:: foo 
    .. automethod:: bar