Sphinx 从 html_sidebars 中排除一页

Question

我正在使用 Sphinx 为应用程序构建用户文档。根据构建配置文件的文档，有一个 html_sidebars 设置示例 documentaion.

html_sidebars = {
'**': ['globaltoc.html', 'sourcelink.html', 'searchbox.html'],
'using/windows': ['windowssidebar.html', 'searchbox.html'],
}

我希望所有页面都显示侧边栏，只有一个页面除外，我只能实现相反的效果，侧边栏只出现在一个页面上，而不出现在其余页面上。

html_sidebars = {'index': ['localtoc.html']}

我知道可以使用 glob 语法，而且我已经尝试了几乎所有我能想到的 [!index] 变体，但都没有成功。

Answer 1

您需要让您的表达式匹配除字符串 'index' 之外的所有内容。不幸的是，通配并不是那么灵活。有几种解决方法。

1. 明确列出索引以外的每个文件
2. 重命名您希望侧边栏带有前缀或后缀的文件，并使用相应的通配模式仅匹配这些文件
3. 将文件移动到子目录中，并使用相应的 globbing 模式
4. 尝试 [!x]，假设没有其他文件的名称中包含 "x"（i、n、d 和 e 太常见了）
5. 可能还有别的东西？

Answer 2

我遇到了同样的问题，并且能够使用以下方法获得预期的结果：

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