Übersicht

In diesem Tutorial erfährst du, wie du die Übersetzungsdateien deines Projekts automatisch verwaltest, wenn du next-intl verwendest.

Wir gehen in 4 Schritten vor:

Schritt 1: Füge deine Umgebungsvariablen hinzu

Füge deinen API-Schlüssel für die Produktion und deine Projekt-ID zu deinen Umgebungsvariablen hinzu. Dies ist erforderlich, um das CLI-Tool gtx-cli zu verwenden. Du erhältst diese im General Translation Dashboard.

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

Schritt 2: gtx-cli installieren

Installieren Sie das Tool gtx-cli in Ihrem Projekt.

npm i gtx-cli

yarn add --dev gtx-cli

bun add --dev gtx-cli

pnpm add --save-dev gtx-cli

Schritt 3: Datei gt.config.json erstellen

Erstellen Sie im Projektstammverzeichnis eine Datei namens gt.config.json.

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

Passen Sie die Datei gt.config.json nach Bedarf an. Weitere Informationen finden Sie in der Dokumentation zur Konfiguration.

Passen Sie das json-Dateiformat so an, 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 vor dem Build-Befehl in Ihren Build- oder CI-Prozess ein, um Übersetzungen automatisch in Ihr Projekt zu integrieren.

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <Ihr Build-Befehl>"
  }
}

Dadurch werden Übersetzungen für all deine locales erzeugt und in deinem Projekt gespeichert. Wenn du diese files in dein Repo einchecken möchtest, kannst du stattdessen diesen Befehl vor dem Commit ausführen.

Fertig! Dein Projekt aktualisiert jetzt automatisch alle deine Übersetzungs-JSON-Dateien, sobald sich etwas ändert.

Hinweise

• Sie können Ihrem Projekt automatisch Übersetzungen mit dem Befehl gtx-cli translate hinzufügen.
• Wenn Sie Ihre Übersetzungsdateien versionieren möchten, führen Sie stattdessen vor dem Commit den Befehl gtx-cli translate aus.
• Informationen zur Konfiguration des Ausgabepfads für Ihre Übersetzungen finden Sie in der Konfigurationsdokumentation.

Nächste Schritte

• Siehe den Nutzungsleitfaden für das CLI-Tool.