Automatische Übersetzung

So übersetzen Sie Ihr Projekt automatisch mit dem CLI-Tool von General Translation

npx gtx-cli@latest

Überblick

Das CLI-Tool von General Translation („gtx-cli“) ermöglicht es Ihnen, Ihr Projekt automatisch in eine der unterstützten Sprachen zu übersetzen.

Es bietet erstklassige Unterstützung für gt-next und gt-react in Ihrem Projekt und ermöglicht es Ihnen, Ihr Projekt nach übersetzbaren Inhalten zu scannen, Ihr Projekt zu übersetzen und Übersetzungsdaten als JSON-Dateien zu erzeugen.

Das CLI-Tool kann außerdem verwendet werden, um Übersetzungen für i18n-Bibliotheken von Drittanbietern wie next-intl oder i18next zu generieren.

Schließlich kann das CLI-Tool zum Übersetzen von JSON-, Markdown-, MDX-, JS- und TS-Dateien verwendet werden.

Für den Befehl translate ist ein Production-API-Schlüssel erforderlich. Holen Sie sich kostenlos einen auf generaltranslation.com!


Es gibt zwei Hauptbefehle, die Sie kennen sollten: init und translate.

  • Der Befehl init wird verwendet, um Ihr Projekt einzurichten. Er bietet einen Schritt-für-Schritt- Assistenten, der Ihr Projekt für Internationalisierung konfiguriert, einschließlich:
  • Einrichten von Plugins und React-Providern
    • Generieren von API-Schlüsseln
    • Konfigurieren der Locales Ihres Projekts und der Dateistruktur
  • Der Befehl translate sollte zu Ihrer CI/CD-Pipeline hinzugefügt werden. Er wird verwendet, um Ihr Projekt nach zu übersetzenden Inhalten zu scannen. Die Inhalte werden anschließend in ein CDN (Content Delivery Network) hochgeladen oder in Ihr App-Bundle integriert, um zur Laufzeit verwendet zu werden.

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 deines Projekts.
npx gtx-cli translateÜbersetzt dein Projekt über die GT API.
npx gtx-cli authErstellt einen API-Schlüssel und eine Projekt-ID für dein Projekt.
npx gtx-cli generateErstellt eine neue JSON-Datei mit Übersetzungsdaten. Sollte verwendet werden, wenn die Bibliothek eigenständig genutzt wird.

Wie ist diese Anleitung?