Структура каталогов Sphinx для rst и html генерируется

Question

Я работал над настройкой автоматической документации для моих файлов Python, которые находятся в большой иерархии структуры каталогов. Я могу сгенерировать файлы rst и html для всех из них с помощью моих скриптов и с помощью модуля autodoc. Мне было интересно, возможно ли создавать файлы rst и html в той же структуре каталогов / иерархии каталогов, что и мои файлы Python.

Например, относительный путь к моему файлу python: python / common / element.py; первый сгенерированный файл: python.common.element.rst; и то же самое для HTML. Я хочу, чтобы он сформировал ту же структуру каталогов, что и для файлов py, например: sphinx / _build / rst / python / common / element.rst & sphinx / _build / html / python / common / element.html

PS: я работаю над Ubuntu-14.04 и Sphinx-1.6.3

Answer 1

Нет. Исходные и сборочные каталоги должны быть отдельными. Смотрите вариантыsphinx-build,

Вы можете написать скрипт для пост-обработки вывода, перемещая файлы из каталога сборки в другой.