Skip to content

frontend-i18n.md

Latest commit

 

History

History
54 lines (37 loc) · 1.34 KB

frontend-i18n.md

File metadata and controls

54 lines (37 loc) · 1.34 KB
Raw

Frontend i18n

中文

CyberStrikeAI frontend i18n is static and lightweight. Text is organized in JSON files and applied through data-i18n attributes plus JavaScript helper functions.

Files

web/static/i18n/zh-CN.json
web/static/i18n/en-US.json
web/static/js/i18n.js

Key Principles

  • Keep keys stable and semantic.
  • Update Chinese and English together.
  • Do not hardcode new visible text in JS when it should be localized.
  • Preserve default HTML text as fallback before JS initialization.

HTML Usage

<button data-i18n="common.save">保存</button>

For attributes, follow the existing i18n.js conventions.

JavaScript Usage

Use the global translation helper where available:

const label = t('common.save');

When adding dynamic UI, make sure language switching refreshes the text or re-renders the component.

Migration Workflow

  1. Add or update UI text.
  2. Add keys to zh-CN.json.
  3. Add matching keys to en-US.json.
  4. Replace hardcoded text with data-i18n or t().
  5. Test both languages and browser console.

Common Pitfalls

  • Missing keys only in one language.
  • Dynamic text built from hardcoded fragments.
  • Button labels too long in English.
  • HTML fallback text diverges from JSON text.
  • Adding new page text without updating language switch behavior.