Was macht i18n & Lokalisierung?
Internationalisierungs- (i18n) und Lokalisierungs- (L10n) Best Practices.
1. Kernkonzepte
| Begriff | Bedeutung |
|---|
| i18n | Internationalisierung – die App übersetzbar machen |
| L10n | Lokalisierung – die eigentlichen Übersetzungen |
| Locale | Sprache + Region (de-DE, tr-TR) |
| RTL | Rechts-nach-links-Sprachen (Arabisch, Hebräisch) |
2. Wann i18n verwenden?
| Projekttyp | i18n nötig? |
|---|
| Öffentliche Web-App | ✅ Ja |
| SaaS-Produkt | ✅ Ja |
| Internes Tool | ⚠️ Vielleicht |
| App für eine Region | ⚠️ Zukunft bedenken |
| Persönliches Projekt | ❌ Optional |
3. Implementierungsmuster
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Willkommen in unserer App"))
4. Dateistruktur
locales/
├── de/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
5. Best Practices
TUN ✅
- Übersetzungsschlüssel verwenden, keinen Rohtext
- Übersetzungen nach Funktionen benennen
- Pluralisierung unterstützen
- Datums-/Zahlenformate pro Locale handhaben
- RTL von Anfang an einplanen
- ICU-Nachrichtenformat für komplexe Zeichenketten verwenden
NICHT TUN ❌
- Zeichenketten in Komponenten hartcodieren
- Übersetzungsstrings konkatenieren
- Textlänge ignorieren (Deutsch ist 30% länger)
- RTL-Layout vergessen
- Sprachen in derselben Datei mischen
6. Häufige Probleme
| Problem | Lösung |
|---|
| Fehlende Übersetzung | Fallback auf Standardsprache |
| Hartcodierte Zeichenketten | Linter/Prüfskript verwenden |
| Datumsformat | Intl.DateTimeFormat verwenden |
| Zahlenformat | Intl.NumberFormat verwenden |
| Pluralisierung | ICU-Nachrichtenformat verwenden |
7. RTL-Unterstützung
.container {
margin-inline-start: 1rem;
padding-inline-end: 1rem;
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
8. Checkliste
Vor dem Ausliefern:
Skript
| Skript | Zweck | Befehl |
|---|
scripts/i18n_checker.py | Erkennung hartcodierter Zeichenketten & fehlender Übersetzungen | python scripts/i18n_checker.py <Projektpfad> |
Wann dieses Skill verwenden?
Dieses Skill ist geeignet, um den im Überblick beschriebenen Workflow oder die beschriebenen Aktionen auszuführen.