hana-developer-cli-tool-example i18n-translation-management.instructions.md

i18n Translation Management Guidelines

Use this guide whenever adding, updating, or removing text elements from the _i18n/ directory.

Scope and Structure

The _i18n/ folder contains properties files for multi-language support:

• Base files: {feature}.properties (English)
• Language variants: {feature}_{code}.properties
  • _de.properties → German (Deutsch)
  • _es.properties → Spanish (Español)
  • _fr.properties → French (Français)
  • _ja.properties → Japanese (日本語)
  • _ko.properties → Korean (한국어)
  • _pt.properties → Portuguese (Português)

Example: examples.properties, examples_de.properties, examples_es.properties, examples_fr.properties, examples_ja.properties, examples_ko.properties, examples_pt.properties

Key Principle

ALL language files for a feature must contain identical keys. When adding a key to the base file, you MUST add the same key to all six language variants with appropriate translations. Never create incomplete language sets.

Adding New Text Elements

Step 1: Add to Base File

Edit the English base file (e.g., _i18n/examples.properties):

# Add your new key and English value
newKey=English text here
anotherKey=Another English string

Step 2: Add to All Language Variants

For EACH language (_de.properties, _es.properties, _fr.properties, _pt.properties):

# _i18n/examples_de.properties
newKey=Deutscher Text hier
anotherKey=Ein weiterer deutscher String

# _i18n/examples_es.properties
newKey=Texto en español aquí
anotherKey=Otra cadena en español

### Step 2: Add to All Language Variants

For EACH language (`_de.properties`, `_es.properties`, `_fr.properties`, `_ja.properties`, `_ko.properties`, `_pt.properties`):

```properties
# _i18n/examples_de.properties
newKey=Deutscher Text hier
anotherKey=Ein weiterer deutscher String

# _i18n/examples_es.properties
newKey=Texto en español aquí
anotherKey=Otra cadena en español

# _i18n/examples_fr.properties
newKey=Texte français ici
anotherKey=Une autre chaîne en français