如何在制作htmlHelp时使用Sphinx RTD主题隐藏侧边栏

2022-04-20 00:00:00 python python-sphinx read-the-docs

问题描述

SphinxReadTheDocs主题一起使用时是否可以隐藏侧边栏?

将问题再扩展一下,我可以在发出命令时将其包括在侧边栏中吗:

$make html

并且不包括它发出命令:

$make htmlHelp

而不更改代码?也许可以在layout.html中添加一些内容。


解决方案

首先,在一个帖子中问两个问题是不好的形式。下次,创建单独的问题。

对于您的第一个问题,我不确定选项collapse_navigation的实际用途,但它的名称意味着它实现了您想要的功能。缺省值为False,因此将其切换为True并查看会发生什么。请参阅其他Read the Docs theme configuration options。

对于您的第二个问题,至少有两种方法。

您可以使用sphinx-build-D选项并覆盖conf.py中的设置。

您可以有多个conf.py文件(按您认为合适的方式命名),并使用-c选项为您需要的输出选择适当的文件。

相关文章