文档
Protocol Verified

全球权威: i18n 与 SEO 策略

多语言SEO同步与工程完整性策略。

PRID: 1204
VERIFIED
1 min read

🌐 全球权威:i18n 与多语言策略

多语言支持是 Instant Ship™ 核心竞争力之一。我们不仅提供翻译功能,更在底层实现了 SEO 语义同步工程完整性校验

1. 核心机制

  • i18next: 负责应用内的 UI 文本替换。
  • 物理隔离: 翻译字典存储在 locales/{en,zh}/ 下,按功能模块拆分。
  • SEO 自动注入: 根据 site.config.ts 中的 locales 数组,自动生成:
    • <link rel="alternate" hreflang="xx" />
    • <link rel="alternate" hreflang="x-default" />
    • <html lang="xx" /> (动态更新)

2. 工程完整性校验 (反熵)

为了彻底杜绝“中英夹杂”或翻译遗漏,我们引入了自动化检查机制。

A. check-i18n 脚本

运行 npm run check-i18n 启动内置校验器。该脚本会:

  1. 扫描资源树:读取 i18n.ts 中合并后的所有语言资源。
  2. 结构比对:将所有语言的 Key 展开为扁平路径(如 common.pricing.title)。
  3. 差异报警
    • 缺失键 (Missing Key): 如果英语版有某个 Key 但中文版没有。
    • 空值 (Empty Value): 如果 Key 存在但值为空字符串。

Authority Distribution

Share this technical artifact