页面级配置#
在某些区域,支持页面级配置以控制每个页面的行为。尽量使此配置遵循我们配置的 html_theme_options
结构。以 html_theme
开头,并用句点 (.
) 分隔“嵌套”配置部分。这类似于 TOML 语言定义嵌套配置的方式。
例如,要移除辅助侧边栏,使用如下页面元数据键:
:html_theme.sidebar_secondary.remove: true
---
html_theme.sidebar_secondary.remove: true
---
请注意句点如何自然地分隔嵌套部分,并且看起来非常类似于如果我们将此放入 conf.py
中的 Python 字典时的样子:
html_theme_options = {
"sidebar_secondary": {"remove": "true"}
}