跳到正文
cccskills
免费在 GitHub 公开

i18n-context

Use this skill when the same English text needs different translations in different parts of an application. It adds gettext context at the source, updates affected PO entries, and guides validation of translations and formatting checks for the touched locale.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Add gettext context for ambiguous user-facing strings and repair affected PO translations.

cataclysmbn/Cataclysm-BN星标 1,289(GitHub 1,289 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • Separate translations for an ambiguous label
  • Add context to translated JSON strings
  • Update and validate affected PO entries

包含的文件(1)

  • SKILL.md2.3 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

I18n Context

Use this when one English msgid has multiple meanings and a locale needs different translations.

Hard requirements

  • Do not reduce requested word/context coverage for review risk, churn, or convenience.
  • If a requested meaning needs loader support for contextual translation, add loader support.
  • Do not open or update a PR while msgfmt or printf checks fail for the touched locale.
  • Do not dismiss msgfmt/printf failures as pre-existing when this task touches that locale.

Workflow

  • Find every shared msgid before editing:
    • rg -n 'msgid "<word>"|msgctxt .*\nmsgid "<word>"' lang/po/<lang>.po
    • rg -n '"<word>"|translate_marker\( "<word>" \)|_\( "<word>" \)' data src
  • Split meanings at the source, following #8729 and #8741:
    • C++ runtime strings: pgettext( "short specific context", "text" ).
    • C++ marker-only strings: translate_marker_context( "short specific context", "text" ).
    • JSON translated strings: { "ctxt": "short specific context", "str": "text" } or matching plural fields.
    • Snippet arrays: { "text": { "ctxt": "short specific context", "str": "text" } }.
    • If a JSON field is currently std::string, convert it to translation so contextual JSON can load.
  • Keep context names terse and UI-specific, e.g. time format, map extra, music genre, damage type.
  • Update lang/po/<lang>.po for each new msgctxt; do not rely on the old shared msgstr.
  • Preserve old uncontexted entries only when some source still uses the shared msgid.
  • For Korean, check existing glossary first:
    • rg -C2 -i '<term>' lang/po/ko.po | rg -v '^(#:|--)' | head -n 20
  • Validate after editing:
    • python3 lang/extract_json_strings.py -i data/json -o /tmp/catabn-i18n-context.pot --tracked-only
    • msgfmt -f -c -o /tmp/ko.mo lang/po/ko.po
    • ./tools/check_po_printf_format.py
    • If JSON changed, run ./build-scripts/lint-json.sh.

PR references

  • #8729 split ambiguous yes/no labels in C++ with pgettext and translate_marker_context.
  • #8741 split ambiguous animal/action/species/fish names in JSON with ctxt and updated PO entries.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Use this skill to expose Cataclysm-BN game functions and utilities to Lua. It guides you through organizing functions into libraries, registering constants and callbacks, documenting the API, and handling errors so Lua scripts can use the new bindings.

中文简介正在准备中。当前显示英语简介。

  • Expose game or map functions to Lua
  • Add constants or utility functions to a Lua library
  • Let Lua scripts register callbacks
cataclysmbn/Cataclysm-BN12892026年10月27日 更新

Expose complex C++ classes to Lua by adding bindings for methods, inheritance, constructors, properties, and operators. The skill also guides ownership handling and registration so Lua scripts can use the intended class interface.

中文简介正在准备中。当前显示英语简介。

  • Exposing a C++ class to Lua
  • Binding inherited class methods
  • Adding constructors and properties
cataclysmbn/Cataclysm-BN12892026年10月27日 更新

Add Lua bindings that let Cataclysm-BN scripts access simple C++ types, including string IDs, enums, and basic read-only classes. The skill guides documentation macros, registration in the appropriate source file, and build and in-game checks.

中文简介正在准备中。当前显示英语简介。

  • Exposing a C++ string ID to Lua
  • Registering an enum for Lua scripts
  • Making a basic read-only C++ type available to Lua
cataclysmbn/Cataclysm-BN12892026年10月27日 更新

Generate and synchronize player-facing changelog files across English, Korean, and Japanese from a Git reference range. It groups related changes, organizes featured updates and fixes, and preserves localized labels and relevant media.

中文简介正在准备中。当前显示英语简介。

  • Preparing changelogs between two Git refs
  • Updating English, Korean, and Japanese release notes
  • Grouping related player-facing changes
cataclysmbn/Cataclysm-BN12892026年10月27日 更新

Create or update Deno and TypeScript scripts for Cataclysm-BN, following the project’s conventions. Use it for command-line tools, data migrations, code or documentation generators, Git hooks, and other development utilities.

中文简介正在准备中。当前显示英语简介。

  • Creating a Deno command-line utility
  • Writing a data migration script
  • Generating code or documentation
cataclysmbn/Cataclysm-BN12892026年10月27日 更新

A practical reference for adding Lua bindings to Cataclysm-BN. Look up Luna macros, usertypes, libraries, type and function patterns, documentation helpers, build steps, and common errors, with examples showing how C++ types and functions become usable from Lua.

中文简介正在准备中。当前显示英语简介。

  • Look up Luna macros for a type
  • Register C++ methods and properties for Lua
  • Troubleshoot binding or build errors
cataclysmbn/Cataclysm-BN12892026年10月27日 更新

查看 cataclysmbn 的全部技能

报告此技能的问题