globalize.now mit Next.js verwenden
Richte Internationalisierung in einer Next.js-App in unter fünf Minuten ein.
Next.js hat First-Class-i18n-Unterstützung durch Bibliotheken wie next-intl und next-i18next, aber diese Bibliotheken erwarten eine Codebase mit bereits vorhandenen Übersetzungsschlüsseln. globalize.now ist der Schritt davor: Es nimmt eine Next.js-App voller hartcodiertem Englisch und produziert die Schlüssel, Locale-Dateien und refaktorierten Komponenten, die next-intl (oder jede Runtime-Bibliothek) bedienen kann.
Voraussetzungen
- Ein Next.js-Projekt (App Router oder Pages Router)
- Ein Git-Repository
- Node.js 18+
- Eine gewählte i18n-Runtime-Bibliothek (next-intl empfohlen)
So richtest du globalize.now mit Next.js ein
Installiere deine Runtime-Bibliothek
Füge next-intl oder die Bibliothek deiner Wahl hinzu, damit die App Pro-Locale-Nachrichten zur Laufzeit laden kann.
npm install next-intlKonfiguriere grundlegendes next-intl-Routing
Verdrahte Middleware, Provider und Route-Segmente wie in der next-intl-Dokumentation beschrieben, oder überspringe diesen Schritt, wenn du ihn bereits abgeschlossen hast.
Führe den Globalize-Skills-Installer aus
Installiere vom Next.js-Projekt-Root aus Skills, damit der Agent sich mit deinem Routing-Setup ausrichten kann.
npx globalize-skillsBestätige next-intl-Erkennung
Lass den Agent überprüfen, dass Provider und Message-Pfade den Konventionen entsprechen, die globalize.now für Next.js erwartet.
Überprüfe das vorgeschlagene Locale-Datei-Layout
Inspiziere das vorgeschlagene Messages-Verzeichnis und die Dateinamen, damit sie dem Messages-pro-Locale-Muster folgen, das du gewählt hast.
Refaktoriere Literals zu Übersetzungsaufrufen
Genehmige Updates, die eingebettetes Englisch durch t() oder äquivalente Helfer ersetzen, die zu deinem Provider verdrahtet sind.
Pushe zu Git
Merge den Branch und pushe, damit globalize.now Übersetzungen bei nachfolgenden Git-Pushes synchron halten kann.
Häufige Probleme
next-intl erwartet eine spezifische Message-Struktur
Lösung: globalize.now erkennt automatisch die next-intl-Konvention und schreibt JSON, das deiner konfigurierten Locale-Ordner entspricht, was manuelle Umgestaltung reduziert.
Ich habe bereits ein paar übersetzte Strings – wird globalize.now sie überschreiben?
Lösung: Bestehende Schlüssel werden wann immer möglich beibehalten, und neue Literals werden inkrementell hinzugefügt, sodass Übersetzer frühere Arbeiten nicht verlieren.
Häufig gestellte Fragen
Funktioniert globalize.now mit next-intl und next-i18next?
Ja. globalize.now konzentriert sich auf Repository-Struktur – Schlüssel, JSON-Kataloge und Component-Call-Sites – während next-intl oder next-i18next weiterhin Nachrichten zur Laufzeit lädt. Wähle die Runtime, die zu deinem Routing-Modell passt; globalize.now passt seine Ausgabe an diese Wahl an. Du führst npx globalize-skills einmal pro Projekt-Bootstrap aus, es sei denn, du aktualisierst Skills absichtlich.
Unterstützt globalize.now sowohl App Router als auch Pages Router?
Ja. Die Agent-Skills erkennen den Router-Stil, den du nutzt, und richten die Extraktion auf die korrekten Layout-Dateien, Route Handler und Provider aus. globalize.now ersetzt Next.js-Routing nicht; es stellt sicher, dass Strings, die durch diese Routes fließen, Schlüssel haben. Nach dem Setup referenzieren App Router Server Components und Client Components beide die gleichen Locale-Dateien, die deine Runtime erwartet.
Kann ich globalize.now mit einer Next.js-App nutzen, die bereits teilweise i18n hat?
Ja. Zeige dem Agent auf das Repo und er wird existierende Message-Bundles erweitern, Lücken füllen, wo Literals bleiben. Das ist häufig, wenn nur Marketing-Seiten zuerst übersetzt wurden. globalize.now mergt neue Schlüssel, ohne ältere Übersetzungen zu verwerfen, damit Teams Screen für Screen migrieren können.
Behandelt globalize.now Server Components und Client Components unterschiedlich?
globalize.now schreibt Literals in den Helper um, den dein Stack für jede Grenze nutzt, respektiert Next.js-Regeln darüber, wo Hooks und Provider laufen dürfen. Der JSON-Output bleibt über Server- und Client-Bundles geteilt, damit du Kataloge nicht duplizierst. Du folgst immer noch der Next.js-Dokumentation, um Client Components zu markieren, wenn Interaktivität es erfordert.
Wie integriert sich globalize.now mit Next.js' statischer Generierung?
Locale-Dateien leben in Git, daher `next build` bundelt weiterhin die gleiche JSON, die deine SSG- oder SSR-Routes bereits durch next-intl importieren. globalize.now ändert die Pipeline der statischen Generierung nicht, außer dass Strings aus Datendateien statt aus Literals kommen. Wenn neue Copy ausgeliefert wird, aktualisiert ein weiterer Git-Push Übersetzungen vor dem nächsten Deployment.
Sollte ich next-intl vor dem Ausführen von npx globalize-skills installieren?
next-intl zuerst zu installieren ist ideal, wenn du bereits weißt, dass das deine Runtime ist, weil der Agent Provider sofort verdrahten kann. Wenn du noch keine Bibliothek gewählt hast, kannst du immer noch npx globalize-skills ausführen — die Skills helfen, einen Stack zu empfehlen — aber du könntest Setup nach der Installation von Abhängigkeiten erneut ausführen. Beide Wege enden mit Schlüsseln, eingecheckt in Git und Sync bei Push.
Probiere globalize.now mit Next.js aus
Starte von deinem Projekt-Root:
npx globalize-skills