Skip to content

localization.md

Latest commit

 

History

History
38 lines (27 loc) · 1.29 KB

localization.md

File metadata and controls

38 lines (27 loc) · 1.29 KB

Localization Guide

ClickForMe keeps all UI text in the TRANSLATIONS catalog inside i18n.py.

Translations should use the natural writing system of each language.

  • Turkish should use native Turkish characters consistently and avoid ASCII fallbacks or transliteration
  • Russian should use Cyrillic text, not transliteration
  • French, Italian, German, Spanish, and Portuguese should keep their native accented characters where appropriate

Current Languages

  • TR Turkish
  • EN English
  • DE German
  • ES Spanish
  • RU Russian
  • FR French
  • IT Italian
  • PT Portuguese

How to Extend It

  1. Add the new language code to LANGUAGE_OPTIONS
  2. Add a new translation block after the English catalog
  3. Keep placeholders like {count}, {width}, {delay} unchanged
  4. Use English fallback only temporarily while a translation is in progress
  5. Run the translation completeness check before committing

Validation snippet:

.\.venv\Scripts\python.exe -c "import sys; sys.path.insert(0, 'src'); from clickforme.i18n import get_missing_translation_keys; print(get_missing_translation_keys())"

If the result is {}, every configured language has the full key set.

Automated validation also runs in pytest through test_i18n.py.