Überblick

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

Wir gehen in 4 Schritten vor:

Schritt 1: Umgebungsvariablen hinzufügen

Fügen Sie Ihren API-Schlüssel für die Produktion und die Projekt-ID zu Ihren Umgebungsvariablen hinzu. Dies ist erforderlich, um das Tool gtx-cli zu verwenden. Sie erhalten 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: 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": ["messages/[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>"
  }
}

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

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

Hinweise

• Sie können mit dem Befehl gtx-cli translate automatisch Übersetzungen zu Ihrem Projekt hinzufügen.
• Wenn Sie Ihre Übersetzungsdateien committen 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 Leitfaden zur Verwendung des CLI-Tools.