狮身人面像导入父目录rst文件？答案

【问题标题】：sphinx import parent dir rst file?狮身人面像导入父目录rst文件？
【发布时间】：2011-07-19 02:32:48
【问题描述】：

我需要为每个模块创建一个狮身人面像项目，

每个模块都有一些共同的rsts，比如公司信息、许可证等。

我的项目树是这样的：

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

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

我在./device1/index.rst中写了这个，还是不行，如何导入父rst文件？

.. toctree::
   :maxdepth: 1

   ../intro
   ../about

【问题讨论】：

【解决方案1】：

我找到了一种方法：

.. include:: ../intro.rst

但它将包括所有文本... 也许这是唯一的方法？

【讨论】：

【解决方案2】：

我个人不知道如何修改源搜索路径，所以我最终修改了 make 文件，为 sphinx 构建目录中的所有 *.rst 文件创建符号链接。

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

（假设您使用的是 Linux/Unix。）

【讨论】：