Sphinx включает в себя описания библиотек кода, где он не должен

Я работаю над документацией оболочки Python вокруг приложения PyObjC со Sphinx.

Sphinx добавляет запутанное и нежелательное описание библиотеки кода библиотеки к описанию свойства этого класса, которое оказывается кодом (см. Скриншот, вторая последняя строка).

Как от этого избавиться? Я посмотрел в conf.py, но ничего не смог найти. Кроме того, я узнал, что autodoc добавляет больше документации, но я никогда не просил об этом и не могу найти, происходит ли это вообще и как это отключить.

Соответствующий код сфинкса просто такой:

Properties

.. autosummary::

    name
    code
    automatic

Снимок экрана вывода HTML

0 ответов

Другие вопросы по тегам