我的docs/文件夹中有一些狮身人面像的文档。在这里,我有一些手写和动态生成的代码文档(Python)的典型结构。我想有一个非常简单的README.rst为人们打开回购。在该README.rst中,我希望显示狮身人面像文档的整个TOC。它看起来会是这样的:
About section etc.
==================
blah blah blah
For more check out the documentation
.. here the automatically imported TOC tree我怎么能这么做?
发布于 2022-02-26 22:11:51
对于狮身人面像中的目录,您应该使用toctree
.. toctree::
:maxdepth: 2
doc1
doc2
etc..如果生成所有文档,那么使用"globbing“自动包含所有内容是很好的:
.. toctree::
:maxdepth: 2
:glob:
*有关更多详细信息,请参阅博士关于toc
下面是cython文档中的一个例子

这是一个index.rst文件

https://stackoverflow.com/questions/71280105
复制相似问题