Sphinx 不会为标题生成侧边栏目录

Question

我正在努力处理 Sphinx 生成的文档中的侧边栏目录。我只想在我的文档左侧有一种自动生成的索引树。相反，我只看到空白标题：（我希望你不介意目标文档是波兰语）我的 index.rst 文件：.. SIMail documentation master file, created by   sphinx-quickstart on Mon Nov 26 12:38:31 2018.   You can adapt this file completely to your liking, but it should at least   contain the root `toctree` directive.Welcome to SIMail docs!=======================.. toctree::   :numbered:Providers==============.. automodule:: Providers   :members:Connection managers===================.. automodule:: ConnectionManagers   :members:Indices and tables******************* :ref:`genindex`* :ref:`modindex`* :ref:`search`我一直在寻找诸如“Sphinx 不会在侧边栏上生成索引”之类的问题，但我什么也没找到。看起来我省略了一些小细节。reST 中是否有特殊命令可以强制 Sphinx 在侧边栏上生成索引列表？我找到了我的问题的部分答案，即使用sphinx-autodoc为所有模块生成单独的文件。但看起来问题在于，Sphinx 在从 index.rst 构建目录时会忽略所有标题简单来说，我希望导航列表包含指向 index.rst 中所有标题的链接，与本教程示例中的方式相同。作者似乎只放了带有源文件的部分。并且他可以自动生成导航到 index.rst 中的所有标题。为了说明我的问题，我附上了另一张图片：请查看示例的 index.rst。文件中存在的每个标题都在导航中生成了链接。

Answer 1

就我而言，这只是添加的问题

.. toctree::

   :hidden:

   index

在我的 index.rst 文件中。

Answer 2

您需要html_sidebars根据其文档为 Alabaster 主题添加显式设置：

无论哪种方式，添加显式html_sidebars设置以便加载 Alabaster 的自定义侧边栏模板：

    html_sidebars = {

        '**': [

            'about.html',

            'navigation.html',

            'relations.html',

            'searchbox.html',

            'donate.html',

        ]

    }