gt-next & gt-react

Ü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 einen Produktions-Build auslieferst. Wenn du gt-next oder gt-react in der Entwicklung verwendest, 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

Führe gtx-cli translate aus

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

Nächste Schritte

Siehe den Nutzungsleitfaden für das CLI-Tool.
Wenn Sie Live-Übersetzungen während der Entwicklung sehen möchten (ähnlich wie Hot Reload), schauen Sie sich die <T> Komponente an.