页面级配置#

在某些区域,支持页面级配置以控制每个页面的行为。尽量使此配置遵循我们配置的 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"}
}