SuperAPI AI 工具集

astro-i18n

前端与建站

查看项目

更新于 10-15 21:48

技能介绍

用途:在 Astro(3.5+ 内置 i18n)项目中实现多语言站点,重点处理语言路由与 URL 生成,而非通用 SEO meta 标签或 Content Layer API 本身。主要能力:基于文件的路由(src/pages/[locale]/)、routing 配置(defaultLocale 与 prefix-always、prefix-other-locales 等策略)、astro:i18n 提供的 URL 辅助函数(getRelativeLocaleUrl、getAbsoluteLocaleUrl)、在组件与页面中读取 Astro.currentLocale、基于中间件的路由逻辑、fallback 语言配置以防缺失翻译导致 404、按语言组织 Content Collections 翻译内容,以及借助 @astrojs/sitemap 的 i18n 选项添加 hreflang alternate 链接。适用场景:构建使用语言前缀 URL 的多语言 Astro 站点、配置默认语言与路由策略、生成随语言变化的链接、按语言翻译内容集合、为 SEO 添加 hreflang。最佳实践:用 getRelativeLocaleUrl() 而非硬编码语言前缀;用 Astro.currentLocale 而非手动解析 URL 检测语言;翻译内容放在 src/content/[type]/[locale]/;始终为 SEO 敏感站点配置 @astrojs/sitemap 的 i18n 选项;配置 fallback 语言。禁止事项:在 URL 路径中硬编码语言字符串;手动解析 URL 检测语言;跳过 hreflang 配置;未在 Astro 配置中设置 site 就使用 getRelativeLocaleUrl。该技能还规定代理工作流:实现前并行启动 explore-codebase、research-expert 与 context7 查询文档,实现后运行 sniper 验证。具体命令与完整文档细节暂未提供。