用途:为 Polar 前端的 i18n 包(clients/packages/i18n)及对应公开文档新增一个翻译语言。每一步单独产生一次提交,便于评审 PR。
使用前需向用户确认两项信息:${isoAlpha2}(地区代码,用作文件名与配置键,例如 ko、ja、pt-PT,会原样追加到 SUPPORTED_LOCALES);${localeName}(LOCALE_NAMES 中的人类可读名称,例如 Korean (South Korea),样式参照 clients/packages/i18n/src/config.ts 现有条目)。
主要步骤:
- 同步 main:git checkout main 后 git pull --ff-only;若工作区不干净需先询问用户,勿擅自 stash 或丢弃。
- 创建分支:git checkout -b add-locale-${isoAlpha2}。
- 注册语言:编辑 clients/packages/i18n/src/config.ts,将 '${isoAlpha2}' 追加到 SUPPORTED_LOCALES 元组(保留 as const),并在 LOCALE_NAMES 添加条目;含连字符的键需加引号。提交信息 "Register ${isoAlpha2}"。
- 生成翻译文件:在 clients/packages/i18n 下运行 pnpm translate,生成 clients/packages/i18n/src/locales/${isoAlpha2}.ts,确认存在且有内容再提交,提交信息 "Generate ${isoAlpha2}"。
- 接入入口:编辑 clients/packages/i18n/src/index.ts,添加 import;纯字母代码直接用代码作标识符,含连字符的代码去连字符并驼峰化(如 import ptPT from './locales/pt-PT')。再把语言加入 translations 的 LocalesRecord;合法标识符用裸键,含连字符用带引号键。提交信息 "Enable ${isoAlpha2}"。
- 更新公开文档:编辑 docs/features/checkout/localization.mdx,在“Supported languages”列表添加 - ${localeName}(${isoAlpha2}),若原在“coming soon”列表则移除。提交信息 "Update localization docs"。
- 交回用户:总结该分支上的四次提交,留给用户推送并开 PR;除非被要求,否则不要推送或创建 PR。
限制:资料未提供该技能对仓库环境、权限或翻译服务调用方式的具体要求,也未说明失败回滚细节,暂未提供。