sphinx/autodoc toc未列出子弹

Question

我有以下结构的小存储库：

|- doc/
    |- conf.py
    |- index.rst
    |- ...
|- src/dashtutorial/
    |- __init__.py
    |- data/
    |   |- __init__.py
    |   |- types.py
    |- gui/
        |- __init__.py
        |- components/
        |   |- __init__.py
        |   |- ...
        |- ...
    |- ...

我正在使用sphinx的sphinx-apidoc和napoleon，并且可以成功地构建文档并查看HTML输出。

但是，由于某种原因，我在侧栏中看到 no toc/package路径（我正在使用rtd主题）。 所有内容都在那里，我可以使用索引或搜索页面对文档的每个内容进行操纵。 一旦我移动到一个内容，唯一的 当前软件包将显示在侧栏中。

结果模块。RST文件仅列出root/main软件包dashtutorial。

src
===

.. toctree::
   :maxdepth: 4

   dashtutorial

这是index.rst文件：

.. Dash Tutorial documentation master file, created by
   sphinx-quickstart on Fri Jul  8 10:54:39 2022.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to Dash Tutorial's documentation!
=========================================

.. toctree::
   :maxdepth: 4
   :caption: Contents:



Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

我在conf.py中插入了所有路径：

import os
import sys
sys.path.insert(0, os.path.abspath('..'))
sys.path.insert(0, os.path.abspath('../src/'))
sys.path.insert(0, os.path.abspath('../src/dashtutorial/'))
sys.path.insert(0, os.path.abspath('../src/dashtutorial/data/'))
sys.path.insert(0, os.path.abspath('../src/dashtutorial/gui/'))
sys.path.insert(0, os.path.abspath('../src/dashtutorial/gui/components/'))

编辑：运行后进行清洁和html，我接收... \ modules.rst：警告：任何toctree edit2：document int of toctree

edit2：是否有任何必不可少的东西可以构建基本TOC结构，我我失踪了吗？