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
Ответить

Быстрый ответ

Изменение регистра текста: 
Смайлики
:) :( :oops: :roll: :wink: :muza: :clever: :sorry: :angel: :read: *x)
Ещё смайлики…
   
К этому ответу прикреплено по крайней мере одно вложение.

Если вы не хотите добавлять вложения, оставьте поля пустыми.

Максимально разрешённый размер вложения: 15 МБ.

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