Überblick

In diesem Tutorial zeigen wir dir, wie du die Übersetzungsfiles deines Projekts automatisch verwaltest, wenn du i18next verwendest.

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 beide im General Translation Dashboard.

GT_API_KEY=<Ihr-API-Key>
GT_PROJECT_ID=<Ihre-Projekt-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 im Stammverzeichnis Ihres Projekts die Datei gt.config.json.

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

Passen Sie die Datei gt.config.json nach Bedarf 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 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 erzeugt Ü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 vor dem Commit diesen Befehl 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.
• Um den Ausgabepfad für Ihre Übersetzungen zu konfigurieren, siehe die Konfigurations-Dokumentation.

Nächste Schritte

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