目录树嵌套下拉

Question

我的 index.rst 中有一个目录树，看起来像这样：

.. toctree::
   :maxdepth: 2

   cat
   dog
   moose

我希望嵌套我的 toctree 的内容，类似于 here 使用 'api 文档'：

所以最终做出这样的事情：

.. toctree::
   :maxdepth: 2
   :dropdown Animals
     cat
     dog
     moose

但我似乎在文档中找不到任何这样做的东西。

Answer 1

侧边栏中目录树的这种行为是阅读文档主题 (https://github.com/snide/sphinx_rtd_theme) 的一项功能

用pip install sphinx-rtd-theme安装它

主题具有选项collapse_navigation，用于控制在导航到文档的另一部分时是否自动折叠树。

# -- Options for HTML output ----------------------------------------------

# The theme to use for HTML and HTML Help pages.  See the documentation for
# a list of builtin themes.
html_theme = 'sphinx_rtd_theme'

# Theme options are theme-specific and customize the look and feel of a theme
# further.  For a list of options available for each theme, see the
# documentation.
html_theme_options = {
    "collapse_navigation" : False
}

indexr.rst：

#################
  Title
#################

Animals
=======

.. toctree::
   :maxdepth: 2

    animals/index

Flowers
=======

.. toctree::
   :maxdepth: 2

   flowers/index

动物/index.rst：

####################
  Animals
####################

.. toctree::
   :maxdepth: 2

   cat
   dog
   moose