将自定义边栏模板映射到任何名为“索引.rst"

Question

假设我有以下项目结构：

/
    index.rst
    1/
        index.rst
        a.rst
    2/
        index.rst
        b.rst
        3/
            index.rst
            c.rst

如何在Sphinx的conf.py中创建一个html_sidebars规则，该规则适用于所有名为index.rst的文件？如果可能，请提供Sphinx支持文档，解释可与html_sidebars一起使用的各种通配符。你知道吗

或者我必须明确指定每个文件。。。你知道吗

html_sidebars = {'**': ['non-index-template.html'],
                 'index.rst': ['index-template.html'],
                 '1/index.rst': ['index-template.html'],
                 '2/index.rst': ['index-template.html'],
                 '3/index.rst': ['index-template.html']
}

切题是，有没有一种方法可以引用字典中字典键的值？E、 g

html_sidebars = {'**': ['non-index-template.html'],
                 'index.rst': ['index-template.html'],
                 '1/index.rst': [this['index.rst']],
                 '2/index.rst': [this['index.rst']],
                 '3/index.rst': [this['index.rst']]
}

Answer 1

在The build configuration file的脚注中：

A note on available globbing syntax: you can use the standard shell constructs *, ?, [...] and [!...] with the feature that these all don’t match slashes. A double star ** can be used to match any sequence of characters including slashes.

因此，以下内容将完成我的目标（如果可用语法有更简洁的方法，请告诉我）：

html_sidebars = {'**[!i][!n][!d][!e][!x]': ['non-index-sidebar.html'],
                 '**index': ['index-sidebar.html'],
}