主题配置
颜色与样式
理解主题颜色覆盖的语义边界与主题差异。
颜色配置是对 reader 主题语义色牌的覆盖,不是任意组件级样式系统。先理解字段作用,再做少量改动。
所有主题共享的颜色字段
当前三个内置主题都会接受 `primary`、`primaryForeground`、`accent`、`accentForeground` 这组共享字段,但实际消费范围不完全相同。`classic-docs` 和 `atlas-docs` 会更完整地使用这组色槽;`blueprint-review` 当前最主要使用的是 `primary`,其余字段不应被视为同等强度的视觉入口。
classic-docs 专用的侧边栏字段
只有 `classic-docs` 会使用 `sidebarActive` 和 `sidebarActiveForeground` 来控制侧边栏激活项的背景与文字。`atlas-docs` 和 `blueprint-review` 当前都不会把这两个字段当成主要样式入口。
格式与验证方式
颜色值必须使用 `#RRGGBB`。改完后至少检查三处:正文里的链接与强调、导航激活态、以及代码与提示框附近的整体对比度。
这些字段不会做什么
颜色覆盖不会启用暗色模式,也不会让你获得任意排版系统或组件级样式开关。它们只是在当前主题公开的语义色槽上做覆盖。
先改共享字段: 如果你还没确定最终视觉方向,先从 `primary` 和 `accent` 开始,通常比一次性改完所有颜色更容易校验可读性。
不要假设两个主题颜色行为完全相同: 同名字段在不同主题中的视觉落点可能不完全一样。切换主题后应重新预览,而不是默认颜色效果会原样继承。