Compile i18n

SkillDev tools

How to update Qt translations and generate the web i18n catalog

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Compile i18n skill

What this skill tells your AI

The instructions your AI receives, as published by ok-oldking/ok-script in .agents/skills/compile_i18n/SKILL.md and read by ahel’s review.

When you are instructed to add or update internationalization (i18n) translations for this project, please follow these steps:

Identify the new strings that need to be translated.
Edit the .ts translation files located in the ok/ui/qt/i18n/ directory. Typically, these files include:
- zh_CN.ts (Simplified Chinese)
- zh_TW.ts (Traditional Chinese)
- ja_JP.ts (Japanese)
- ko_KR.ts (Korean)
- es_ES.ts (Spanish)
- en_US.ts (English)
Ensure that your new translations are correctly added under the appropriate <context> and <message> blocks in each XML file, without the type="unfinished" attribute. If you are adding many translations, or just want to minimize errors, use the provided add_translation.py script to automate the XML injection:
```
$py = if (Test-Path .\.venv\Scripts\python.exe) { ".\.venv\Scripts\python.exe" } else { "python" }
& $py .\.agents\skills\compile_i18n\add_translation.py --context "YourContext" --source "Your Source String" --zh_cn "Your Chinese String"
```
IMPORTANT WARNING: DO NOT use pyside6-lupdate as it corrupts and deletes existing translations. Always modify the XML nodes natively or use the python script!
Check that the translations added for the WebUI context are complete. You must replace <translation type="unfinished" /> with <translation>Your Translation</translation>.
Generate the web catalog from the WebUI context by running this command from the workspace root:

// turbo

npm run i18n

npm run dev and npm run build also run this generator automatically.

Advanced