首页
学习
活动
专区
圈层
工具
发布
社区首页 >问答首页 >如何将目录从index.rst链接到README.rst?

如何将目录从index.rst链接到README.rst?
EN

Stack Overflow用户
提问于 2022-02-26 20:33:54
回答 1查看 170关注 0票数 0

我的docs/文件夹中有一些狮身人面像的文档。在这里,我有一些手写和动态生成的代码文档(Python)的典型结构。我想有一个非常简单的README.rst为人们打开回购。在该README.rst中,我希望显示狮身人面像文档的整个TOC。它看起来会是这样的:

代码语言:javascript
复制
About section etc.
==================

blah blah blah

For more check out the documentation

.. here the automatically imported TOC tree

我怎么能这么做?

EN

回答 1

Stack Overflow用户

发布于 2022-02-26 22:11:51

对于狮身人面像中的目录,您应该使用toctree

代码语言:javascript
复制
.. toctree::
   :maxdepth: 2

   doc1
   doc2
   etc..

如果生成所有文档,那么使用"globbing“自动包含所有内容是很好的:

代码语言:javascript
复制
.. toctree::
   :maxdepth: 2
   :glob:

   *

有关更多详细信息,请参阅博士关于toc

下面是cython文档中的一个例子

这是一个index.rst文件

票数 0
EN
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://stackoverflow.com/questions/71280105

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档