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

BefehlBeschreibung
npx gtx-cli initStartet den GT-Einrichtungsassistenten.
npx gtx-cli configureKonfiguriert die GT-Einstellungen Ihres Projekts.
npx gtx-cli translateÜbersetzt Ihr Projekt über die GT-API.
npx gtx-cli authErstellt einen API-Schlüssel und eine Projekt-ID für Ihr Projekt.
npx gtx-cli generateErstellt eine neue JSON-Datei mit Übersetzungsdaten. Sollte verwendet werden, wenn die Bibliothek eigenständig genutzt wird.

Wie ist dieser Leitfaden?

Automatische Übersetzung