JSON-Dateien
Wie man General Translation verwendet, um automatische Übersetzungen für die JSON-Dateien Ihres Projekts einzurichten
Überblick
gtx-cli
kann verwendet werden, um die JSON-Dateien Ihres Projekts automatisch zu übersetzen, unabhängig davon, welche i18n-Bibliothek Sie verwenden.
Hinweis:
Wir unterstützen derzeit benutzerdefinierte String-Syntax und Formatierung für die folgenden i18n-Bibliotheken: next-intl
, i18next
, gt-next
, gt-react
.
Wenn Sie eine andere i18n-Bibliothek verwenden, sind die Übersetzungsergebnisse möglicherweise nicht genau für Strings mit benutzerdefinierter Syntax und Formatierung (zum Beispiel ICU-Nachrichten). Vermissen Sie Ihre bevorzugte Bibliothek? Bitte teilen Sie uns das mit, und wir werden sie so schnell wie möglich hinzufügen!
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 mit Übersetzungsdateien durch die Verwendung 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 aus dem General Translation Dashboard.
Schritt 2: Installieren Sie gtx-cli
Installieren Sie das gtx-cli
-Tool in Ihrem Projekt.
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.
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 hinzu, bevor der Build-Befehl ausgeführt wird, um automatisch Übersetzungen zu Ihrem Projekt hinzuzufügen.
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 mit dem Befehl
gtx-cli translate
automatisch Übersetzungen zu Ihrem Projekt hinzufügen. - Wenn Sie Ihre Übersetzungsdateien committen möchten, sollten Sie 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
- Lesen Sie die Nutzungsanleitung für das CLI-Tool.
- Wenn Sie Live-Übersetzungen in der Entwicklung sehen möchten (wie Hot Reload), schauen Sie sich die
<T>
Komponente an.