用途:为 Astro 站点配置语言与页面间的对应关系,处理多语言路由、缺省语言、前缀策略、翻译与 fallback,并核对路由、元数据与语言标记。
主要能力:读取已有语言、默认语言、前缀规则、翻译及 fallback;按内容身份而非仅 slug 关联等价页面;仅为实际存在的路由生成 alternates;核对 lang、canonical 与 hreflang,避免把 fallback 当作已发布翻译;检查默认语言、缺失翻译、动态路由与 404 场景。
使用方式:路径定义在 .astrofy/config/paths.json 中;应用在线文档 API 前,先核对 lockfile 与 node_modules 中的已安装版本。列出 locales、默认语言、前缀、fallback 与已翻译路由;对真正发布的配对生成路由与 hreflang;在内容中保持稳定标识与按语言区分的 slug;区分 path 与语言代码,并先用 astro:i18n 的 helper 解析翻译再拼 URL;按状态、最终 URL 与交付语言核对 redirect 与 rewrite;测试不同 slug 的语言切换、query、fragment,以及项目存在时按请求协商。修改既有实现时,若当前契约默认语言无前缀则保留;新增语言先测试菜单与 fallback 再生成 hreflang。
验证:缺失翻译不得产生 404 链接;每个已翻译页面应声明自身语言且 alternates 一致;导航应到达存在的页面并正确识别内容语言。可用 astrofy check --category routing 检查。
限制:具体 API、命令参数与配置字段以实际安装版本和项目配置为准;资料未提供支持的 Astro 版本、完整 API 列表或托管平台信息。