SuperAPI AI 工具集

game-localization

编程与开发

查看项目

更新于 11-15 04:09

技能介绍

该技能面向使用 TypeScript 编写、运行在浏览器中的游戏,讲解如何从一开始就做好国际化与本地化,使后续翻译成本更低。核心思想是:第一条玩家可见文本出现时就外部化,并通过 Intl 完成格式化,同时尽早开启伪本地化。

字符串管理 要求把每条玩家可见字符串放入按语言划分的资源文件,客户端与服务端渲染读取同一目录。消息以稳定语义 ID 键控(如 quest.ruins.offer、hud.gold.label),而非英文原文;含义变化时更换新 ID,修正拼写则保留原 ID;同一字符串不得在多个位置复用。每条消息需附译者注释,说明展示位置、占位符内容、不可翻译部分和定长 UI 的长度预算。禁止用片段拼接句子,应使用带命名占位符的完整消息;无法与固定文本保持性数一致时采用话题—评论式布局,如“Picked up: {item}”。复数或选择消息的每个分支都应写完整句子。

语言回退链 按从最具体到默认语言的顺序解析,如 zh-Hans-CN、zh-CN、zh-Hans、zh、en;仅有地区的标签需补上可能文字,使 zh-TW 能命中 zh-Hant 目录;当裸语言的可能文字与请求不符时应跳过,避免 zh-TW 落入简体目录。地区变体应视为独立语言(pt 与 pt-BR、es 与 es-419、zh-Hans 与 zh-Hant)。游戏内部使用 BCP 47 标签,在平台边界转换 Steam 代码。按消息 ID 解析一次并记录未命中与加载失败。处理 Accept-Language 时只传入实际发布语言,避免原始标签撑大格式化器缓存。

Intl 格式化 不要硬编码单复数。不同语言复数类别不同:英语为 one/other,俄语和波兰语有 one/few/many/other,阿拉伯语六类,日语仅 other;巴西葡萄牙语和法语将 0 归入 one,欧洲葡萄牙语则不然。每条复数或选择消息都需要默认分支。技能给出 Intl.PluralRules、NumberFormat、DateTimeFormat、RelativeTimeFormat、ListFormat、Segmenter、Collator、DisplayNames 的用途对照:序数、紧凑数字、货币(需 ISO 4217 代码)、玩家时区的事件时间与时间窗口、相对时间、奖励列表连接、字素截断与中日泰断词、排行榜排序、语言选择器名称。游戏内软货币不是 ISO 4217,应格式化数字并把货币词放入消息。建议用 0、1、2、3、5、11、21、100、1000000 在各发布语言测试复数,并提供在目标 Bun 版本上检查 Intl 成员与语言支持的脚本。

消息格式选型 列出样板占位符加复数映射、经典 ICU MessageFormat、Fluent、MessageFormat 2 四种选项及适用条件,并说明当前 JavaScript 无原生消息格式化器,需自行选择并锁定库版本;技能因未核验具体库而不指名。

文本、布局、文字与字体 短字符串膨胀最严重:不超过 10 字符的英文串可能增长 200% 至 300%,超过 70 字符约增长 130%,按钮和 HUD 标签最先出问题,应允许重排、避免小的定宽框。canvas fillText 不会自动换行,其 maxWidth 会压缩文字,需用样板中的 wrapLines 或改用 DOM 覆盖层;覆盖层中应使用 textContent 而非 innerHTML 插入译文和玩家名。布局多语言 HUD、菜单、对话框或字幕时,可参考 text-layout.md,涉及膨胀预算、canvas 换行、从右到左与双向文本、中日韩与泰语断行、法语标点、字体字形覆盖、图片和视频中的文字、玩家名。

伪本地化 从首个构建即启用伪语言环境,可暴露缺失字符串、截断溢出、拼接、字体缺字和从右到左布局缺陷。建议加约 40% 填充并加括号标记截断,伪语言标签不得使用真实语言代码,ICU 保留 en-XA(加音标)与 en-XB(双向),仅用于开发构建。boilerplate/pseudo-localize.ts 支持加音标、填充、括号、可选镜像,并保留占位符、标签、实体和 printf 标记;但只识别该样板自己的 {name} 语法,ICU 或 Fluent 消息应使用对应库的伪语言功能。

流程与限制 规划翻译或内容补丁时可参考 process.md,涉及术语表与风格指南、给译者的上下文、字符串冻结、在线内容补丁周期、LQA 与文化化;商店页面与游戏内文本是两件不同的事,Steam 依据游戏内语言设置判定语言支持。文末列出常见陷阱,如原地修改含义导致旧译文仍匹配、模板字面量拼接、按英文长度设计 UI、假设只有单复数、按空格分词、按代码单元截取、依赖 canvas 自动换行、在 CSS 设置方向、单一中日韩字体、默认字体缺字形、文字烧进贴图或视频、用真实语言代码作伪语言、源文本仍在变动时翻译、在未验证运行时用 Intl。提供三个样板文件与三个参考文档,并列出相关技能。