Sphinx Заголовки модулей, сгенерированные sphinx-apidoc, слишком длинные (полный путь к пакету). Как мне их сократить? ⇐ Python

Программы на Python
Anonymous
Sphinx Заголовки модулей, сгенерированные sphinx-apidoc, слишком длинные (полный путь к пакету). Как мне их сократить?

Сообщение Anonymous »

Я создаю документацию по API Python с помощью Sphinx и sphinx-apidoc со sphinx-rtd-theme.
Проблема в следующем:

Заголовки страниц и записи ToC для модулей/пакетов всегда показывают полный путь импорта,
например,

Код: Выделить всё

myproject.subpackage.longname.module
Это делает боковую панель и заголовки очень длинными.
Что я уже решил
Используя следующее в conf.py:

Код: Выделить всё

add_module_names = False
Это успешно удаляет префикс модуля из имен классов.
Что я уже пробовал
  • toc_object_entries_show_parents

Код: Выделить всё

toc_object_entries_show_parents = False
Вопрос
Есть ли способ настроить Sphinx так, чтобы заголовки модулей/пакетов представляли собой короткие имена, а не полные пути импорта?

Подробнее здесь: https://stackoverflow.com/questions/798 ... age-path-h

Вернуться в «Python»