Automatische Übersetzung
Wie Sie Ihr Projekt automatisch mit dem General Translation CLI-Tool übersetzen
npx gtx-cli@latest
Überblick
Das General Translation CLI-Tool (gtx-cli
) ermöglicht es dir, dein Projekt automatisch in jede der unterstützten Sprachen zu übersetzen.
Es bietet erstklassige Unterstützung für gt-next
und gt-react
in deinem Projekt und ermöglicht es dir, dein Projekt nach übersetzbaren Inhalten zu scannen, es zu übersetzen und JSON-Dateien mit Übersetzungsdaten zu erzeugen.
Das CLI-Tool kann auch verwendet werden, um Übersetzungen für i18n-Bibliotheken von Drittanbietern wie next-intl oder i18next zu generieren.
Außerdem kann das CLI-Tool verwendet werden, um JSON-, Markdown-, MDX-, JS- und TS-Dateien zu übersetzen.
Für den Befehl translate
wird ein Produktions-API-Schlüssel benötigt. Du kannst dir kostenlos einen unter generaltranslation.com erstellen!
Es gibt zwei Hauptbefehle, die du kennen solltest: init
und translate
.
- Der Befehl
init
dient zur Einrichtung deines Projekts. Er bietet einen Schritt-für-Schritt-Assistenten, der dein Projekt für die Internationalisierung konfiguriert, einschließlich:
- Einrichten von Plugins und React-Providern
- Erstellen von API-Schlüsseln
- Konfigurieren der Locale- und Dateistruktur deines Projekts
- Der Befehl
translate
ist dafür gedacht, in deine CI/CD-Pipeline integriert zu werden. Er scannt dein Projekt nach zu übersetzenden Inhalten. Diese werden anschließend auf ein CDN hochgeladen oder deinem App-Bundle hinzugefügt, um sie zur Laufzeit zu verwenden.
Erste Schritte
Je nachdem, welche i18n‑Bibliothek Ihr Projekt verwendet, folgen Sie bitte einem der folgenden Tutorials:
Verwendung
Befehl | Beschreibung |
---|---|
npx gtx-cli init | Startet den GT-Einrichtungsassistenten. |
npx gtx-cli configure | Konfiguriert die GT-Einstellungen Ihres Projekts. |
npx gtx-cli translate | Übersetzt Ihr Projekt über die GT-API. |
npx gtx-cli auth | Erstellt einen API-Schlüssel und eine Projekt-ID für Ihr Projekt. |
npx gtx-cli generate | Erstellt eine neue JSON-Datei mit Übersetzungsdaten. Sollte verwendet werden, wenn die Bibliothek eigenständig genutzt wird. |
Wie ist dieser Leitfaden?