Anydocs Documents
主题配置

品牌定制

理解 reader 品牌字段的作用范围和实际可见性。

Reader 品牌配置位于 `site.theme.branding`。它影响的是站点壳层的品牌展示,而不是页面正文内容模型。

主要字段

当前最值得关注的是 `siteTitle`、`logoSrc` 和 `logoAlt`。它们决定 reader 壳层是否显示品牌标题、品牌图形,以及图形的替代文本。

可选兼容字段

`homeLabel` 仍然是受支持的配置字段,也会在 Studio 中持久化,但当前内置主题不会把它作为主要的可见品牌位来强调。把它视为兼容字段比把它当成核心展示位更准确。

推荐组合方式

只想快速定制站点标题时,通常只设置 `siteTitle` 即可;只想展示图形品牌时,可以只设置 `logoSrc` 和 `logoAlt`;如果两者都设置,reader 会同时显示图形和标题。

和页面内容的边界

品牌字段属于项目级 reader shell 配置,会进入已发布站点壳层与相关机器可读元数据,但不会成为页面正文中的内容块,也不应该被写进每个页面的正文里。

branding 不能为空壳: 一旦声明 `site.theme.branding`,至少要提供 `siteTitle` 或 `logoSrc` 其中之一;否则项目校验会报错。
始终填写 logoAlt: 如果使用了 `logoSrc`,建议始终补上 `logoAlt`,这样 reader 的无障碍信息才完整。