GT Libraries

Übersetzen Sie Ihr Projekt automatisch mit GT Libraries

Übersicht

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

Hinweis: Dies sollte nur verwendet werden, wenn du ein Produktions-Build auslieferst. Wenn du die GT Libraries in der Entwicklung nutzt, ist dieser Befehl nicht erforderlich.

Wir folgen diesen 4 Schritten:

Füge deine Umgebungsvariablen hinzu

Konfiguriere dein Projekt mit dem Befehl npx gtx-cli configure

Tipp: Vermeide den Aufwand mit Übersetzungsdateien, indem du die <T> Komponente verwendest.


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

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

Schritt 2: Konfigurieren Sie Ihr Projekt mit dem Befehl npx gtx-cli configure

Führen Sie den Befehl gtx-cli configure aus, um Ihr Projekt zu konfigurieren.

npx gtx-cli configure

Schritt 3: 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.

package.json
{
  "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 Befehl gtx-cli translate.
  • Wenn Sie Ihre Übersetzungsdateien committen möchten, können Sie stattdessen den Befehl gtx-cli translate vor dem Commit ausführen.
  • Um den Ausgabepfad für Ihre Übersetzungen zu konfigurieren, siehe die Konfigurationsdokumentation.

Nächste Schritte

  • Sehen Sie sich die Nutzungsanleitung für das CLI-Tool an.
  • Wenn Sie Live-Übersetzungen in der Entwicklung sehen möchten (denken Sie an Hot Reload), schauen Sie sich die <T> Komponente an.

Auf dieser Seite