Integrieren Sie die Lokalisierung in Ihre CI/CD-Pipeline mit der PTC-API

Erfahren Sie, wie Sie die PTC-API in Ihre CI/CD-Pipeline integrieren, um KI-Übersetzungen in menschlicher Qualität als Teil Ihres Build-Prozesses zu liefern.

Von Grund auf sicher – kein Lese- oder Schreibzugriff auf das Repository erforderlich.
Kompatibel mit jedem CI/CD-System, inklusive vorgefertigter Konfigurationen.
Kontrollierter Zugriff durch projektspezifische API-Tokens.
Übersetzungen in menschlicher Qualität, geliefert in wenigen Minuten, direkt in Ihrem Build.

Wie die CI/CD-Integration funktioniert

Bevor Sie PTC mit Ihrem CI-System einrichten, sind hier die drei Prinzipien hinter der PTC-API und der CLI:

1. Ressourcendateien sind an einen Branch gebunden

Jede Datei, die Sie an PTC senden, ist mit einem Branch-Namen verknüpft (z. B. main, feature/new-checkout). Dies hält Übersetzungen getrennt, sodass sich Übersetzungen von verschiedenen Funktionen nicht gegenseitig überschreiben. Wenn Sie die vorgefertigten CI/CD-Konfigurationen verwenden, wird diese Zuordnung bereits automatisch verarbeitet.

2. Übersetzungen werden asynchron verarbeitet

PTC gibt Übersetzungen nicht sofort zurück. Stattdessen:

Lädt die aktualisierten Dateien hoch
Identifiziert nur die neuen oder geänderten Strings
Übersetzt die Strings
Bereitet übersetzte Dateien zum Download vor

3. Ein CLI-Skript funktioniert überall

Anstatt die API selbst aufzurufen, verwenden Sie die PTC-CLI:

Ein Skript verarbeitet den gesamten Ablauf (Hochladen → Abfragen → Herunterladen). Die CLI läuft unter Linux und macOS und funktioniert mit GitHub Actions, GitLab, Bitbucket oder jeder anderen CI/CD-Plattform.

Ablauf im Überblick: Richten Sie die PTC-API in Ihrer CI/CD-Pipeline ein

1Melden Sie sich für eine Testphase an.

Erhalten Sie vollen Zugriff auf alle Funktionen und übersetzen Sie bis zu 20.000 Wörter in zwei beliebige Sprachen Ihrer Wahl.

2Erstellen Sie ein neues Projekt.

Wenn Sie auswählen, wie Sie PTC nutzen möchten, wählen Sie API integration. Während der Einrichtung geben Sie ein wenig Kontext zu Ihrem Projekt an (was es tut, für wen es ist) und wählen die Sprachen aus, in die Sie übersetzen möchten.

3Holen Sie sich Ihr API-Token.

Am Ende der Einrichtung erhalten Sie ein projektspezifisches API-Token. Kopieren Sie es und bewahren Sie es sicher auf – Sie benötigen es, um alle Anfragen zu authentifizieren. Sie finden dasselbe Token jederzeit in Ihrem Projekt-Dashboard unter Einstellungen → PTC-API-Tokens wieder.

Abrufen des PTC-API-Tokens aus der Projekteinrichtung — Abrufen des API-Tokens während der Projekteinrichtung

Abrufen des PTC-API-Tokens aus dem Dashboard — Abrufen des API-Tokens aus dem PTC-Dashboard

4Fügen Sie das PTC-API-Token an der richtigen Stelle zu Ihrem Repository hinzu.

Anbieter	Wo das Token hinzugefügt wird
GitHub Actions	Gehen Sie zu Settings → Secrets and variables → Actions und fügen Sie `PTC_API_TOKEN` hinzu. Gehen Sie dann zu Settings → Actions → General → Workflow permissions und aktivieren Sie Allow GitHub Actions to create and approve pull requests. Die Workflow-Datei fordert den benötigten Schreibzugriff bereits an; dieses Kontrollkästchen ist das Einzige, was sie sich nicht selbst gewähren kann.
GitLab CI/CD	Gehen Sie zu Settings → CI/CD → Variables und fügen Sie `PTC_API_TOKEN` hinzu.
Bitbucket Pipelines	Gehen Sie zu Repository settings → Pipelines → Repository variables und fügen Sie `PTC_API_TOKEN` hinzu.

5Kopieren Sie die vorgefertigte CI/CD-Konfiguration.

Fügen Sie bei GitHub Actions die PTC Translate Action zu Ihrem Workflow hinzu. Ihr API-Token ist die einzige Eingabe, die Sie übergeben müssen. Die Action enthält eine feste Version der CLI in sich, sodass Ihr Build zur Laufzeit niemals ein Skript herunterlädt, und wenn ein Durchlauf neue Übersetzungen produziert, öffnet sie den Pull Request für Sie.

Kopieren Sie bei GitLab CI, Bitbucket Pipelines oder jeder anderen Plattform den Job für Ihre Plattform aus den PTC CLI CI/CD-Templates. Jedes Template bindet die CLI an ein spezifisches Release und veröffentlicht die Prüfsumme zur Verifizierung, sodass ein späteres CLI-Release nicht ändern kann, was Ihr Build ausführt.

6Führen Sie den Workflow aus.

Sie können den Workflow manuell, bei Commits, die Ressourcendateien aktualisieren, oder nach einem Zeitplan auslösen. Siehe Trigger für GitHub, GitLab und Bitbucket. Ein Pull Request benötigt einen Branch, gegen den er geöffnet wird. Daher öffnet die PTC Translate Action bei GitHub Actions einen bei einem Push, nach einem Zeitplan und bei einem manuellen Durchlauf aus einem Branch heraus. Bei einem pull_request-, pull_request_target- oder merge_group-Event, oder bei einem Tag oder einem Release, stoppt sie stattdessen mit einer Erklärung – übersetzen Sie bei einem Push in Ihren Quell-Branch oder setzen Sie create-pr: false für diesen Durchlauf.

Wenn sie ausgeführt wird, lädt die CLI Ihre Dateien hoch, wartet auf den Abschluss der Übersetzungen und schreibt die aktualisierten Übersetzungen zurück in Ihr Repository. Wenn Sie die vorgefertigten Konfigurationen verwenden und der Durchlauf neue Übersetzungen produziert hat, wird der Workflow mit den Änderungen auch die Aktion create a merge request ausführen, sodass Sie diese wie jedes andere Code-Update überprüfen und mergen können. Ein Durchlauf, der nichts zu übersetzen findet, schreibt nichts und öffnet keinen Merge Request. Von hier an bleiben Ihre Übersetzungen automatisch synchron.

CI/CD-Beispiele

WordPress

Ruby on Rails

GitHub Actions

JSON-Dateien (React-Apps)

Weiterführende Literatur

Warum PTC für Software-Übersetzungen nutzen?

PTC ist ein komplettes Übersetzungssystem für Entwickler und Produktteams – entwickelt, um Ihren Code, Ihre Marke und Ihr Publikum synchron zu halten.

Kontextbewusste Übersetzungen, die Ihre Marke schützen

Vor dem Übersetzen lernt PTC Ihr Produkt, Ihr Publikum und Ihre Terminologie kennen. Deshalb gehen 99,5 % der Sätze ohne Bearbeitung live und 85 % der Projekte werden überhaupt nicht bearbeitet.

Wie die KI-Übersetzungen von PTC Ihre Marke schützen →

Breite Unterstützung für Plattformen und Dateiformate

PTC funktioniert mit den gängigsten Ressourcendateiformaten und Plattformen, darunter: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify und WordPress.

Mehr über unterstützte Dateiformate →

Übersetzen Sie mehr als nur Ressourcendateien

Müssen Sie Release Notes, E-Mails oder Dokumentationen übersetzen? PTC enthält auch eine schnelle Funktion „Paste to translate“, die Ihnen dieselben kontextbewussten Übersetzungen für Text außerhalb von Code bietet.

So übersetzen Sie Text außerhalb von Ressourcendateien →

Automatisieren Sie Übersetzungen in Ihrer CI/CD

Richten Sie PTC einmal ein, und Ihre Ressourcendateien und Übersetzungen bleiben in Ihrer CI/CD-Pipeline automatisch auf dem neuesten Stand.