GitLab-Integration mit der PTC
Verbinden Sie GitLab mit der PTC für eine kontinuierliche Lokalisierung. Erhalten Sie Übersetzungen über automatische Merge Requests, sobald sich Ihr Code ändert.
So integrieren Sie GitLab in die PTC
Die PTC verbindet sich mit Ihrem GitLab-Repository und hält Ihre Ressourcendateien während Ihrer Arbeit übersetzt. Wenn Sie Änderungen an Ihrem Code pushen, erkennt die PTC diese automatisch, übersetzt die aktualisierten Strings und öffnet einen Merge Request.
Die GitLab-Integration ist eine Pro-Funktion. Sie wird verfügbar, wenn Sie Pay-As-You-Go aktivieren.
Verbinden Sie Ihr GitLab-Repository
Die PTC unterstützt sowohl GitLab.com als auch selbst gehostete GitLab-Repositories. Abhängig davon, wo Sie sich in Ihrem Workflow befinden, gibt es zwei Möglichkeiten, um zu starten:
- Wenn Sie ein neues Projekt in der PTC erstellen, wählen Sie im Einrichtungsassistenten Git-Integration aus.
- Um ein bestehendes Projekt von manuellen Datei-Uploads auf einen kontinuierlichen Git-basierten Workflow umzustellen, gehen Sie zu Einstellungen → Merge Requests und klicken Sie auf Add Git Integration.
In beiden Fällen sehen Sie einen Bildschirm, auf dem Sie die URL zu Ihrem Projekt innerhalb des Repositories eingeben können. Die PTC erkennt automatisch, dass Sie GitLab verwenden.
Authentifizieren Sie sich bei GitLab
Um Ihr Repository zu verbinden, können Sie ein Zugriffstoken (empfohlen) verwenden oder sich mit OAuth anmelden. Die PTC unterstützt sowohl Projekt-Zugriffstoken als auch Gruppen-Zugriffstoken.
Die PTC benötigt Webhook-Zugriff, um Änderungen in Ihrem Repository zu erkennen. Wenn Sie ein Zugriffstoken verwenden, hängen die benötigte Rolle und die Scopes davon ab, wie der Webhook eingerichtet werden soll:
| Automatische Webhook-Einrichtung | Manuelle Webhook-Einrichtung | |
|---|---|---|
| So funktioniert es | Die PTC erstellt und konfiguriert den Webhook in GitLab während des Integrationsprozesses für Sie. | Die PTC stellt Ihnen eine Callback-URL und ein Secret Token zur Verfügung. Sie erstellen mit diesen Details einen Webhook in Ihren GitLab-Einstellungen, mit Push-Events und Merge-Request-Events als Trigger. |
| Erstellung des Tokens | Gehen Sie zu Einstellungen → Zugriffstoken, entweder in Ihrem Projekt oder in Ihrer Gruppe. Geben Sie dem Token einen Namen, eine optionale Beschreibung und legen Sie ein Ablaufdatum fest (aus Sicherheitsgründen empfohlen). | Gehen Sie zu Einstellungen → Zugriffstoken, entweder in Ihrem Projekt oder in Ihrer Gruppe. Geben Sie dem Token einen Namen, eine optionale Beschreibung und legen Sie ein Ablaufdatum fest (aus Sicherheitsgründen empfohlen). |
| Erforderliche Rolle | Maintainer | Developer (oder gleichwertig) |
| Scopes | api → Erlaubt der PTC, aus dem Repository zu lesen und in dieses zu pushen |
read_repository + write_repository |
Ein Projekt-Token und ein Gruppen-Token funktionieren beide in jeder Spalte – die PTC liest die jeweils höhere Zugriffsebene. Was die beiden Spalten unterscheidet, ist die Rolle, und das ergibt sich aus dem, was jede Einrichtung tut: Die automatische Einrichtung verwaltet einen Projekt-Webhook für Sie, den GitLab für Maintainer reserviert, während die manuelle Einrichtung nur das Repository liest und einen Branch pusht, wofür Developer ausreicht.
Bewahren Sie das Token sicher auf und fügen Sie es zur PTC hinzu. Sie wird Ihre Berechtigungen überprüfen und Sie auswählen lassen, welche Branches und Ressourcendateien überwacht werden sollen.
Der Zugriff bleibt auf die Dateien beschränkt, die die PTC übersetzt
Die PTC verwendet Lesezugriff, um Änderungen in Ihren Ressourcendateien zu erkennen, und Schreibzugriff, um Übersetzungen über Merge Requests zu liefern. Die PTC interagiert nur mit den Dateien, die sie für die Übersetzung verwaltet, und nimmt keine Änderungen an anderen Teilen Ihres Repositories vor.
Webhooks halten Übersetzungen automatisch synchron
Über Webhooks wird die PTC benachrichtigt, wenn Sie Änderungen in Ihr Repository pushen, sodass sie betroffene Strings automatisch neu übersetzen kann. Ohne Webhook-Zugriff kann die PTC Ihre Branches nicht auf Aktualisierungen überwachen.
Übersetzen Sie Ihr Projekt mit der PTC
Sobald Ihr GitLab-Repository verbunden ist, fahren Sie mit den Einrichtungsschritten fort, um Kontext zu Ihrer App oder Software bereitzustellen und Ihre Zielsprachen auszuwählen.
Die PTC übersetzt dann die Ressourcendateien in Ihrem verbundenen GitLab-Branch. Wenn Ihr Repository bereits Übersetzungsdateien enthält, kann die PTC diese erkennen und wiederverwenden.
Überprüfen Sie den Merge Request mit den Übersetzungen
Die PTC übersetzt in wenigen Minuten und sendet einen Merge Request mit den Übersetzungen direkt an Ihr GitLab-Repo. Sobald Sie bereit sind, mergen Sie ihn einfach – es ist keine weitere Aktion erforderlich.
Von diesem Zeitpunkt an wird die PTC, wenn Sie Änderungen an Ihrem Code pushen, diese erkennen und neue Merge Requests mit aktualisierten Übersetzungen senden, sodass Ihre Software dauerhaft vollständig lokalisiert bleibt.
Generieren Sie neue Merge Requests manuell
Zusätzlich zu automatischen Aktualisierungen können Sie jederzeit einen neuen Merge Request generieren, um Übersetzungen zu synchronisieren, die Sie bearbeitet oder neu übersetzt haben.
Gehen Sie dazu zum Tab Translations. Von hier aus können Sie übersetzten Text überprüfen, der die Längenbegrenzung überschreitet, und ihn entweder manuell bearbeiten oder die PTC eine kürzere Version generieren lassen. Wenn Sie fertig sind, klicken Sie auf Generate MR, um die aktualisierten Übersetzungen in Ihr Repository zu pushen.
Geben Sie der PTC Zugriff auf neue Ressourcendateien, wenn Sie diese hinzufügen
Wenn Sie nach der anfänglichen Integration neue Ressourcendateien zu Ihrem Repository hinzufügen, können Sie die PTC anweisen, nach diesen zu suchen.
- Gehen Sie zu Einstellungen → Überwachte Dateien und klicken Sie auf Rescan your repository. Die PTC scannt Ihr Repository und zeigt alle neu entdeckten Dateien als Entwürfe an.
- Klicken Sie auf das +-Symbol neben einer Datei, um sie in die Übersetzung aufzunehmen, und klicken Sie dann zur Bestätigung auf Save with translation.
Um die manuelle Überprüfung vollständig zu überspringen, aktivieren Sie das Kontrollkästchen Automatically include new translation files. Von diesem Zeitpunkt an wird die PTC alle neuen Ressourcendateien, die sie findet, automatisch aufnehmen und überwachen, ohne dass Sie diese bestätigen müssen.
Um andere Einstellungen wie überwachte Branches und Sprachen anzupassen, navigieren Sie durch die Tabs Branch Management, Überwachte Dateien und Languages.
Warum Sie GitLab-Projekte mit der PTC lokalisieren sollten
Automatisierte Dateiübersetzung
Die PTC erkennt und übersetzt Ihre Ressourcendateien automatisch und liefert die Übersetzungen über Merge Requests. Sie behalten die Kontrolle, indem Sie den GitLab-Workflow nutzen, den Sie bereits kennen und dem Sie vertrauen – und das ohne ein einziges Skript erstellen zu müssen.
Weniger manuelle Arbeit
Die PTC spart Entwicklungszeit und beschleunigt Releases, indem sie Ihr Repository überwacht und Übersetzungsdateien aktualisiert, während Sie Änderungen pushen.
Verbesserte Übersetzungsgenauigkeit
Die PTC eliminiert das Risiko menschlicher Fehler wie falsch platzierter Keys oder veralteter Übersetzungen. Sie erhalten hochpräzise und markenkonforme Übersetzungen.
Die Lokalisierung hält mit der Software- und Mobile-Entwicklung Schritt
Die PTC wurde für Teams entwickelt, die Softwareprodukte und Mobile-Apps entwickeln und möchten, dass die Lokalisierung mit der Entwicklung Schritt hält. Sobald Sie Ihr GitLab-Repository verbinden, erkennt die PTC automatisch neue und aktualisierte Strings und liefert die Übersetzungen über einen Merge Request zurück, ohne dass eine manuelle Übergabe erforderlich ist.
Gängige Formate in Software- und Mobile-Projekten – wie PO-Dateien und JSON-Dateien – werden vollständig unterstützt. Weitere Informationen dazu, wie sich die PTC in diese Workflows einfügt, finden Sie auf unseren Seiten zur Software-Lokalisierung und Lokalisierung von Mobile-Apps.
Verbinden Sie GitLab ohne zusätzliche Kosten
Für die Verbindung von GitLab fallen keine zusätzlichen Gebühren an. Anstelle eines Abonnementmodells nutzt die PTC ein einfaches Pay-As-You-Go-Preismodell: Ihnen werden nur die Wörter berechnet, die Sie übersetzen, und die ersten 500 Wörter jeden Monat sind kostenlos. Alle Details finden Sie auf der PTC-Preisseite.
Funktioniert auch mit GitHub und Bitbucket
Zusätzlich zu GitLab lässt sich die PTC in GitHub und Bitbucket integrieren und bietet für jede Plattform die gleichen automatisierten Lokalisierungs-Workflows und Funktionen.