Überblick

In diesem Tutorial zeigen wir Ihnen, wie Sie die Übersetzungsdateien Ihres Projekts automatisch verwalten, wenn Sie next-intl verwenden.

Wir folgen diesen 4 Schritten:

Schritt 1: Umgebungsvariablen hinzufügen

Fügen Sie Ihren Produktions-API-Schlüssel und Ihre Projekt-ID zu Ihren Umgebungsvariablen hinzu. Dies ist erforderlich, um das Tool gtx-cli zu verwenden. Sie erhalten beides 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: Erstellen Sie die Datei gt.config.json

Erstellen Sie die Datei gt.config.json im Stammverzeichnis Ihres Projekts.

{
  "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.

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 vor dem Build-Befehl in Ihren Build- oder CI-Prozess ein, um Übersetzungen automatisch zu Ihrem Projekt hinzuzufügen.

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

Dies generiert Übersetzungen für alle deine locales und speichert sie in deinem Projekt. Wenn du diese files in dein Repo committen möchtest, kannst du stattdessen diesen Befehl vor dem Commit ausführen.

Fertig! Dein Projekt aktualisiert nun automatisch alle deine Übersetzungs‑JSON files, sobald sich dein Projekt ändert.

Hinweise

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

Nächste Schritte

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