跳到主要内容

ARC 2.0.0-beta.25

SEO、链接与可访问性

把生成的 SEO/链接检查当作底线,再以人工可访问性检查收尾。

Web Device 可以根据 site/page/content 配置组装 canonical、多 locale hreflang、Open Graph/Twitter metadata 与 JSON-LD。自动化让正确结构可用,但不会自动让页面可发现或可访问。

让每一层拥有自己的 metadata

范围放在哪里
全站 title template、description、site identity、sharing 默认值.web/site.yamlseo:
页面 title/description 及 locale variantpages/<name>/seo/,例如 title.zhdescription.zh
内容对象的 title、summary、date、relationship对象自己的 content/front matter

页面也可以用 seo/og-type 选择类型。不要用全站配置塞满每个标题来弥补缺失的页面或对象 metadata。

被拒绝的访问壳(preview-shellpromo-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 可到达。这些仍是作者和审阅者的责任。

一次实用的验收

  1. build 站点,打开默认 locale 和每个已声明 locale。
  2. 在代表性页面检查 title、description、canonical、hreflang 与 sharing preview。
  3. 跟随主导航和一条内容 detail/list 路径;区分已知内部页面与静态检查无法验证的外部 URL。
  4. 在宽窄视口用键盘导航,检查 focus、图片替代文本、横向溢出和裁切文字。
  5. 审阅页面实际内容层次;有一个字面上的 H1 并不等于面向读者的标题结构合理。

这些检查足够小,可以反复执行。路由形成见 路由、导航与语言;runtime/build 失败分类见 诊断站点