Internationalisierung (i18n)
Priorität: P2 (MITTEL)
Verwalte eine einzige Quelle der Wahrheit für Lokalisierungen und stelle ein SEO-freundliches Sub-Pfad-Routing sicher.
Implementierungsrichtlinien
- Lokalisierungs-Routing: Folge dem URL-First-Ansatz für SEO. Verwende dynamische Segmente im App Router (z. B.
app/[lang]/page.tsx) und diei18n-Konfiguration innext.config.jsfür den Pages Router. - Bibliotheksauswahl: Verwende
next-intlfür den App Router (modern) oderreact-intl/next-translatefür ältere Apps. - Erkennung: Implementiere Middleware-Lokalisierung (in
middleware.ts), um die Benutzersprache ausAccept-Language-Headern oder Cookies zu erkennen und Weiterleitungen durchzuführen. - Serverseitig: Lade Übersetzungs-
messages/*.json-Wörterbücher in Server-Komponenten, um das Client-Bundle klein zu halten. VerwendegetMessages()oderrequestConfig-Muster. - SEO: Stelle sicher, dass
hreflang-Tags korrekt in dermetadata-API für alle übersetzten Routen generiert werden. - Statische Generierung: Verwende
generateStaticParams, um lokalisierte Versionen statischer Seiten zur Build-Zeit vorzurendern.module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. Bibliotheksspezifika
Für eine detaillierte Einrichtung mit gängigen Bibliotheken siehe:
Anti-Patterns
- Keine hartcodierten Strings in JSX: Verwende Übersetzungsschlüssel; übergebe niemals Rohtext.
- Keine clientseitigen Übersetzungsbündel: Lade Wörterbücher serverseitig mit
getMessages(). - Keine gemischten URL-Lokalisierungsmuster: Verwende konsistent Sub-Pfade oder Domänen.