Web Device 可以根据 site/page/content 配置组装 canonical、多 locale hreflang、Open Graph/Twitter metadata 与 JSON-LD。自动化让正确结构可用,但不会自动让页面可发现或可访问。
让每一层拥有自己的 metadata
| 范围 | 放在哪里 |
|---|---|
| 全站 title template、description、site identity、sharing 默认值 | .web/site.yaml 的 seo: 块 |
| 页面 title/description 及 locale variant | pages/<name>/seo/,例如 title.zh、description.zh |
| 内容对象的 title、summary、date、relationship | 对象自己的 content/front matter |
页面也可以用 seo/og-type 选择类型。不要用全站配置塞满每个标题来弥补缺失的页面或对象 metadata。
被拒绝的访问壳(preview-shell 或 promo-shell)总会发送 X-Robots-Tag: noindex 和 robots meta。它的 description 只能用已声明的 SEO description 或 excerpt,不能用从受保护正文派生的摘要。见内容访问参考。
知道自动检查覆盖什么
static publishing doctor 可以因缺 build index、sitemap、robots 文件或可识别的内部页面死链阻断静态 build;缺 title 目前只是 advisory。页面级 SEO check 刻意很轻:它只看 title、description、H1 数量、img 有没有 alt attribute 以及基本 Open Graph 字段。
这不代表图片 alt 有意义、键盘路径可用、focus 可见、颜色对比足够、外链有效,或嵌入 service endpoint 可到达。这些仍是作者和审阅者的责任。
一次实用的验收
- build 站点,打开默认 locale 和每个已声明 locale。
- 在代表性页面检查 title、description、canonical、
hreflang与 sharing preview。 - 跟随主导航和一条内容 detail/list 路径;区分已知内部页面与静态检查无法验证的外部 URL。
- 在宽窄视口用键盘导航,检查 focus、图片替代文本、横向溢出和裁切文字。
- 审阅页面实际内容层次;有一个字面上的
H1并不等于面向读者的标题结构合理。