外观模式 (明暗)
控制站点的默认色彩模式。主题支持随系统自动切换,也支持锁定为浅色或深色。
配置位置
在站点根目录的 hugo.toml(或 config.toml)中设置:
toml
[params.theme]
# 说明:设置首次访问时的默认模式。
# 可选值:
# - 'auto' (推荐):跟随用户系统/浏览器的明暗设置。
# - 'light':强制默认使用浅色模式。
# - 'dark' :强制默认使用深色模式。
defaultMode = 'auto'优先级规则
- 用户手动选择:如果用户点击了设置面板里的模式切换按钮,该选择会保存在浏览器的本地存储中,优先级最高。
- 站点配置:如果用户是第一次访问且从未手动切换过,则使用你在
hugo.toml中设置的defaultMode。 - 系统默认:如果你没有进行任何配置,主题默认使用
auto。