GT Libraries

Übersetzen Sie Ihr Projekt automatisch mit GT Libraries

Überblick

Dieses Tutorial zeigt Ihnen, wie Sie die Übersetzungsdateien Ihres Projekts automatisch verwalten können, wenn Sie gt-next oder gt-react verwenden.

Hinweis: Dies sollte nur verwendet werden, wenn Sie einen Produktions-Build ausliefern. Wenn Sie die GT-Bibliotheken in der Entwicklung verwenden, ist dieser Befehl nicht erforderlich.

Wir werden diese 4 Schritte befolgen:

Fügen Sie Ihre Umgebungsvariablen hinzu

Installieren Sie gtx-cli

Initialisieren Sie Ihr Projekt mit dem Befehl gtx-cli init

Führen Sie gtx-cli translate aus

Tipp: Vermeiden Sie den Aufwand der Verwendung von Übersetzungsdateien mit der <T> Komponente.


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: Installieren Sie gtx-cli

Installieren Sie das gtx-cli-Tool in Ihrem Projekt.

npm i --save-dev gtx-cli

Schritt 3: Initialisieren Sie Ihr Projekt mit dem Befehl gtx-cli init

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

npx gtx-cli init

Schritt 4: 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>"
  }
}

Dies generiert Übersetzungen für alle Ihre Sprachen und speichert sie in Ihrem Projekt. Wenn Sie diese Dateien in Ihr Repository übernehmen möchten, können Sie diesen Befehl stattdessen vor dem Commit ausführen.

Sie sind fertig! Jetzt wird Ihr Projekt automatisch alle Ihre Übersetzungs-JSON-Dateien aktualisieren, wenn 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