技能 编程开发 国际化本地化翻译工作流

国际化本地化翻译工作流

v20261116
i18n-localization
本技能提供三个 Python 脚本,用于确保应用开发期间的国际化质量。它检查翻译文件中的缺失键、占位符和 CLDR 复数形式。扫描代码中绕过翻译函数的硬编码字符串。生成伪本地化用于布局测试。防止发布前出现 i18n 错误,无需外部 API。
获取技能
328 次下载
概览

i18n Localization

Portability: 3 stdlib Python scripts. No network, no translation service.
They check and generate files; they never translate text or call an API.

A release with a new language usually breaks in the same places: keys added in
English and never synced, a placeholder renamed by a translator, Russian or
Arabic files that copied English's two plural forms, UI text that never went
through t(), and dates formatted in the server's locale. This skill makes each
of those a check that fails before the release, not a bug report after it.

Workflow

# 1 - Translation files: keys, placeholders, ICU syntax, CLDR plural forms
python scripts/locale_sync.py locales/ --source-locale en
# 2 - Code: user-facing text that bypasses t(), concatenation, locale-less formatting
python scripts/hardcoded_strings.py src/
# 3 - Layout: generate a pseudo-locale and click through the app in it
python scripts/pseudo_localize.py locales/en/common.json -o locales/en-XA/common.json
python scripts/pseudo_localize.py locales/en/common.json --bidi -o locales/ar-XB/common.json

Step 1 reads JSON/ARB (i18next or ICU), .properties, Apple .strings,
Android strings.xml and gettext .po, pairs each target with the source file of
the same namespace, and blocks on missing or empty keys, changed placeholders,
ICU syntax errors, plural/select without other, a zero branch that can never
match, and plural categories the target locale needs (ru few/many, ar six
forms), using the embedded CLDR 49 table. Untranslated values, orphan keys,
fuzzy entries and markup drift are warnings.

Step 2 blocks on literal text between tags and literal user-facing
attributes (placeholder, alt, aria-label, title...), and warns on
literals rendered from {cond ? 'Saving...' : ...}, t('a') + x concatenation,
toLocaleString() with no locale, '$' + amount and hardcoded date patterns.
It is a text heuristic: read each finding. Use --warn-only to adopt it on a
legacy codebase, i18n-ignore on a line, and .i18n-allow for brand names.

Step 3 accents, pads (by translation-growth rates) and brackets every string
while keeping placeholders and ICU syntax intact. Plain English on screen is a
hardcoded string; a cut-off [[... is truncation; [[a]] [[b]] is concatenation.

Hard rules

  • Never concatenate translated fragments. One message per sentence, with named placeholders and a plural branch.
  • Plural forms follow CLDR for the target locale, not English. Never copy _one/_other into ru, pl, uk, cs, ar, he files and call them done.
  • =0, not zero, for an empty-count message in ICU.
  • Pass the locale to every formatter. Currency comes from the data, not the UI locale.
  • Placeholders are code. A translator may move them, never rename or drop them; use positional %1$s where order can change.
  • Do not machine-translate to make the checker pass. A missing translation falls back to the source language; a wrong one ships silently. Mark gaps for a translator instead.

Scripts

ScriptRoleExit codes
scripts/locale_sync.pyTranslation files vs source locale: keys, placeholders, ICU, CLDR plurals, gettext0 · 2 warnings · 3 bad input · 4 blocked
scripts/hardcoded_strings.pyReact/Vue/Svelte/HTML: untranslated text, concatenation, locale-less formatting0 · 2 · 3 · 4
scripts/pseudo_localize.pyen-XA (or --bidi ar-XB) pseudo-locale from JSON/ARB/.properties0 · 3

All support --help, --sample and --output json.

References and assets

信息
分类 编程开发
名称 i18n-localization
版本 v20261116
大小 32.95KB
更新时间 2026-11-17
语言