gpt4 book ai didi

python-sphinx - 在索引目录树中包含子目录中的目录树

转载 作者:行者123 更新时间:2023-12-03 20:33:38 25 4
gpt4 key购买 nike

我要记录的项目结构如下:

/top
Index.rst
/a
toctree_a.rst (contains doc and doc2)
doc.rst
doc2.rst
/b
toctree_b.rst (contains doc4 and doc3)
doc3.rst
doc4.rst

我想引用 toctree s 在子目录(a 和 b)中,以便项目 toctree可以看到项目树中的4个文档。

当文档位于一个目录中时,我知道如何执行此操作,但如果将它们放在子目录中,我不知道如何执行此操作。我试图保持我的项目结构完整,而不必将所有文件移动到一个目录中。我做了一些研究,发现 .. include:: directive可能是要走的路线,但我不知道如何正确使用它。

最佳答案

您可以告诉 index.rst 中的 toctree 从子目录中获取文件,如下所示:

内容:

.. toctree::
:maxdepth: 2

a/doc
a/doc2
b/doc3
b/doc4

该方法就像它们在同一目录中一样工作

关于python-sphinx - 在索引目录树中包含子目录中的目录树,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/38904668/

25 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com