i18n & Lokalisierung
Best Practices für Internationalisierung (i18n) und Lokalisierung (L10n).
1. Kernkonzepte
| Begriff | Bedeutung |
|---|
| i18n | Internationalisierung – Anwendung übersetzbar machen |
| L10n | Lokalisierung – eigentliche Übersetzungen |
| Locale | Sprache + Region (de-DE, tr-TR) |
| RTL | Rechts-nach-links-Sprachen (Arabisch, Hebräisch) |
2. Wann i18n verwendet werden sollte
| Projekttyp | i18n erforderlich? |
|---|
| Öffentliche Web-App | ✅ Ja |
| SaaS-Produkt | ✅ Ja |
| Internes Tool | ⚠️ Eventuell |
| Einregionen-App | ⚠️ 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/
├── en/
│ ├── 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 Funktion benennen
- Pluralisierung unterstützen
- Datums-/Zahlenformate pro Locale behandeln
- RTL von Anfang an einplanen
- ICU-Nachrichtenformat für komplexe Zeichenfolgen verwenden
NICHT TUN ❌
- Zeichenfolgen in Komponenten hartcodieren
- Übersetzte Zeichenfolgen verketten
- Textlänge annehmen (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 Zeichenfolgen | 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 | Hartcodierte Zeichenfolgen und fehlende Übersetzungen erkennen | python scripts/i18n_checker.py <project_path> |
Verwendung
Dieses Skill kann angewendet werden, um den im Überblick beschriebenen Workflow oder die Aktionen auszuführen.
Verknüpfungen
- Domain: [[Software Entwicklung]]
- Kategorie: [[Software Architektur]]
- Dateien:
- Navigation: [[Skills Uebersicht]], [[Home]]