sphinx导入父目录rst文件？

Question

我需要为每个模块创建一个sphinx项目，

每个模块共享一些常见的rsts，如公司信息、许可证等。

我的项目树是这样的：

./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文件，以便为sphinx build目录中的所有*.rst文件创建符号链接。

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

(这假设您使用的是Linux/Unix。)