sphinx импортировать родительский первый файл?

Question

Мне нужно создать один проект sphinx для каждого модуля,

и каждый модуль имеет несколько общих имен, таких как информация о компании, лицензия и т. Д.

Дерево моего проекта выглядит так:

./conf.py
./index.rst
./intro.rst
./about.rst

./device1/conf.py
./device1/index.rst 

Я пишу это в ./device1/index.rst, и это не работает, как я могу импортировать родительские rst файлы?

.. toctree::
   :maxdepth: 1

   ../intro
   ../about

Answer 1

Я нашел способ сделать это:

.. include:: ../intro.rst

но оно будет включать все тексты ... может это единственный выход?

Answer 2

Лично я не мог понять, как изменить исходный путь поиска, поэтому в итоге я изменил файл make для создания символических ссылок для всех файлов *.rst в каталоге сборки sphinx.

foreach f ( `\ls OTHER_DIR | egrep '.rst$$'` ) \
    ln -s -f $$f BUILD_DIR \
end

(Предполагается, что вы используете Linux / Unix.)