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