@iGyry
Backend developer

Как в sphinx сгенерировать документацию используя файлы из другой директории?

Идея такая: у меня есть 1 большой проект, который состоит из нескольких приложений, состоящий из нескольких view, models и соответственно со своей документацией. Все приложения с доками располагаются на 2 директори выше моего Makefile. И в этом возникает проблема, как зацепить себе в доку файлы (*.rst) располагающиеся на директорий выше?
Makefile у меня стандартный, только импорт Django добавил и пример моего index.rst файла
index.rst
Apps
====

.. toctree::
   :hidden:
   :maxdepth: 4

   ../../apps/project_1/index
   ../../apps/project_2/index

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

Ошибка:
WARNING: toctree contains reference to nonexisting document u'apps/project_1/index'
WARNING: toctree contains reference to nonexisting document u'apps/project_2/index'
  • Вопрос задан
  • 113 просмотров
Пригласить эксперта
Ответы на вопрос 1
@NaName
если указать абсолютный путь к документации, то работает?
Ответ написан
Комментировать
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Похожие вопросы