主题配置
classic-docs 主题
了解 classic-docs 主题的布局特点与配置范围。
`classic-docs` 是当前内置的侧边栏优先 reader 主题。它适合围绕一棵连续导航树来阅读，而不是先按页头分组切换内容域。
布局与适用场景
这个主题采用经典的左侧导航 + 右侧正文布局，适合指南、知识库、操作手册和层级较稳定的 API / 参考文档。
当前可配置项
它支持 reader 品牌字段 `siteTitle`、`logoSrc`、`logoAlt`，支持 `site.theme.chrome.showSearch`、`site.theme.codeTheme`，也支持 6 个颜色字段：`primary`、`primaryForeground`、`accent`、`accentForeground`、`sidebarActive`、`sidebarActiveForeground`。
不会生效的能力
`classic-docs` 不使用 `site.navigation.topNav`。即使你在项目配置里声明了顶部导航项目，它也不会成为这个主题主阅读界面的一部分。
运行时行为
`classic-docs` 支持搜索和语言切换，不支持暗色模式。`homeLabel` 字段仍然会保存在项目配置里，但当前内置阅读布局并不把它当作主要可见品牌位。
什么时候选 classic-docs: 如果你的站点主要依赖一棵持续展开的文档树来导航，而不是先按几个大分组切换内容域，`classic-docs` 通常更直接。
颜色覆盖要先验证可读性: 颜色值必须使用 `#RRGGBB`。改动 `primary` 或侧边栏激活色后，应同时检查正文链接、导航激活态和代码区块是否仍然清晰可读。