国际化网站

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用该技能

向现有网站添加新语言版本 为新网站设置 i18n(国际化) 为多种语言配置 SEO 用户提及:“添加语言”、“翻译”、“本地化”、“hreflang”、“多语言”

支持的语言

共同目标市场: 🇺🇸 英语 (en) - 全球市场 🇯🇵 日语 (ja) - 亚洲市场 🇨🇳 中文 (zh) - 中国市场 扩展支持可用于:

国际化工作流程

复制此清单并跟踪您的进度:

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第1步:准备基础语言文件

确保英语 (`en.json`) 文件作为模板存在: 所需目录: `i18n/messages/en.json` - 主要翻译 `i18n/pages/landing/en.json` - 着陆页翻译 验证结构:

02
第 2 步:添加新的语言文件

运行语言添加脚本: 该脚本的作用: 将 `en.json` 复制到所有目标语言文件 使用新语言环境更新 `i18n/locale.ts` 使用语言映射更新 `i18n/request.ts`

03
步骤 3:验证配置更新

检查`i18n/locale.ts`:检查`i18n/request.ts`:已配置语言代码映射`zh-CN`→`zh`、`zh-HK`→`zh-hk`映射检查`public/sitemap.xml`:

04
第 4 步:添加翻译

选项 A:使用 AI 翻译(更快,但需要审核):在脚本的 `translations` 对象中配置翻译。选项 B:手动翻译(建议质量):使用正确的翻译编辑每个语言文件:翻译最佳实践:

05
第 5 步:配置 SEO 元素

hreflang 标签 - 通过站点地图自动进行,但需要验证:请参阅 reference/hreflang-guide.md 以获取完整指南。本地化元标记 - 在每种语言文件中进行翻译:URL 结构 - 验证格式是否正确:英语:`https://example.com/` 或 `https://example.com/en/`

06
第 6 步:验证和测试

构建项目: 关键:在继续之前修复所有错误。手动测试:语言切换器:访问各个语言版本

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。