python-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

score 8 · Accepted Answer

我找到了一种方法来做到这一点：

.. include:: ../intro.rst

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

score 0 · Accepted Answer

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

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

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

2 回答 2