next-intl

Übersicht

In diesem Tutorial zeigen wir dir, wie du die Übersetzungsdateien deines Projekts automatisch verwalten kannst, wenn du next-intl verwendest.

Wir gehen dabei in diesen 4 Schritten vor:

Schritt 1: Fügen Sie Ihre Umgebungsvariablen hinzu

Fügen Sie Ihren Produktions-API-Schlüssel und Ihre Projekt-ID zu Ihren Umgebungsvariablen hinzu. Dies ist notwendig, um das gtx-cli-Tool zu verwenden. Sie erhalten diese im General Translation Dashboard.

GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>

Schritt 2: Installiere gtx-cli

Installiere das Tool gtx-cli in deinem Projekt.

npm i --save-dev gtx-cli

yarn add --dev gtx-cli

bun add --dev gtx-cli

pnpm add --save-dev gtx-cli

Schritt 3: Erstellen Sie eine gt.config.json-Datei

Erstellen Sie eine gt.config.json-Datei im Root-Verzeichnis Ihres Projekts.

{
  "defaultLocale": "en",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["i18n/[locale]/*.json"]
    },
  },
}

Passen Sie die gt.config.json-Datei gerne an Ihre Bedürfnisse an. Weitere Informationen finden Sie in der Konfigurationsdokumentation.

Aktualisieren Sie das json-Dateiformat so, dass der include-Pfad Ihrer Projektstruktur entspricht.

Schritt 4: Fügen Sie den Befehl gtx-cli translate zu Ihrem Build-Prozess hinzu

Fügen Sie den Befehl gtx-cli translate zu Ihrem Build- oder CI-Prozess vor dem Build-Befehl hinzu, um automatisch Übersetzungen zu Ihrem Projekt hinzuzufügen.

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <your build command>"
  }
}

Dadurch werden Übersetzungen für alle Ihre Sprachversionen generiert und in Ihrem Projekt gespeichert. Wenn Sie diese Dateien in Ihr Repository einchecken möchten, können Sie stattdessen diesen Befehl vor dem Commit ausführen.

Fertig! Ihr Projekt wird nun automatisch alle Ihre Übersetzungs-JSON-Dateien aktualisieren, sobald sich Ihr Projekt ändert.

Hinweise

• Sie können Übersetzungen automatisch zu Ihrem Projekt hinzufügen mit dem gtx-cli translate Befehl.
• Wenn Sie Ihre Übersetzungsdateien committen möchten, können Sie stattdessen den gtx-cli translate Befehl vor dem Commit ausführen.
• Um den Ausgabepfad für Ihre Übersetzungen zu konfigurieren, siehe die Konfigurations- Dokumentation.

Nächste Schritte

• Siehe die Nutzungsanleitung für das cli-Tool.
• Erfahre, wie du von next-intl zu gt-next mit unserem Migrationsleitfaden wechseln kannst.