启用基于sphinx引导主题的Python-Sphinx文档的侧栏

Question

我正在使用尼斯斯芬克斯-引导-主题0.3.4，并试图将它应用在Sphinx文档生成器1.2版之上。

当我通过make html构建文档时，我不会得到任何侧边栏，尽管在这个example中它是可能的。两种情况下，我都无法找到在构建配置文件(conf.py)中启用侧栏的任何选项。做以下工作：

html_sidebars = {'sidebar': ['localtoc.html', 'sourcelink.html', 'searchbox.html']}

帮不上忙。

感谢您对如何从斯芬克斯主题中启用侧边栏的任何提示。

Answer 1

只是想明白了。这应该能起作用。

html_sidebars = {'**': ['localtoc.html', 'sourcelink.html', 'searchbox.html']}

将此用作引用

sidebars

我正在尝试创建一个自定义的侧边栏，因为我不喜欢包含的选项。使用引导演示index.html，我为一个自定义侧边栏创建了以下内容。只需将其命名为类似于my_custom_sidebar.html的名称，并将其放入/source/_templates中即可。

<ul class="globaltoc"
>{{ toctree(maxdepth=theme_globaltoc_depth|toint, collapse=False,includehidden=theme_globaltoc_includehidden|tobool) }}</ul>

然后编辑html_sidebars

html_sidebars = {'**': ['my_custom_sidebar.html', 'searchbox.html']}