SuperAPI AI 工具集

enable-i18n

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:在 shop 模板中引入 next-intl,使店面提供带 locale 前缀的 URL(如 /en-US/products/foo),按语言加载消息目录,并暴露文案语言切换器。默认单部署、干净 URL、组件文案内联于 lib/content/index.ts,并配置 shopConfig.localization。它只翻译店面文案并添加路由,不会依据文案语言推断商务国家,也不会在切换语言时修改购物车买家国家;货币始终来自 Shopify 响应。区域商务应改用 enable-shopify-markets。

主要能力:新增 lib/i18n/routing/index.ts 与 lib/i18n/navigation/client.ts;将路由移入 app/[locale]/;proxy.ts 中运行 next-intl/middleware;lib/params/server.ts 用 next/root-params 解析 getLocale();新增 next-intl 插件、消息目录与 lib/i18n/request/server.ts;SEO 中生成带语言前缀的 canonical 与 hreflang;按语言生成 sitemap;proxy.ts 中处理语言感知的 Markdown;根布局中 generateStaticParams。

用法:全新安装时在店面根目录运行 pnpm add next-intl,创建 lib/i18n/index.ts 定义已批准的 locale 列表,将 app/layout.tsx 移入 app/[locale]/layout.tsx 并删除原文件,导出 ensureStatic = "prefetch" 与 generateStaticParams。在 proxy.ts 末尾组合 createMiddleware(routing)。已有本地化或定制安装应保留其 next-intl 版本、目录、翻译与路由,只补齐缺失部分。

限制:需与 cacheComponents: true、Partial Prefetching 兼容,app/[locale] 必须是根布局;请求读取须置于 Suspense 内;不要使用 setRequestLocale;保留模板 Link;服务端重定向用 next/navigation 并显式加 locale 前缀。译文目录需与键名对齐,英文回退不能当作完成翻译。用户请求的路由若与现有公开 URL 冲突,应先取得迁移决策。非交互运行时未决选项应报告并停止。