GitLab-Integration mit PTC
Verbinden Sie GitLab mit PTC für kontinuierliche Lokalisierung. Erhalten Sie Übersetzungen automatisch über Merge Requests, wann immer sich Ihr Code ändert.
So integrieren Sie GitLab mit PTC
PTC verbindet sich mit Ihrem GitLab-Repository und hält Ihre Ressourcendateien während der Arbeit übersetzt. Pushen Sie Änderungen an Ihrem Code und PTC erkennt diese automatisch, übersetzt die aktualisierten Strings und öffnet einen Merge Request.
Die GitLab-Integration ist eine Pro-Funktion. Sie wird verfügbar, sobald Sie Pay-As-You-Go aktivieren.
Verbinden Sie Ihr GitLab-Repository
PTC unterstützt sowohl GitLab.com als auch selbstgehostete GitLab-Repositories. Je nachdem, wo Sie sich in Ihrem Workflow befinden, gibt es zwei Möglichkeiten für den Einstieg:
- Wenn Sie ein neues Projekt in PTC erstellen, wählen Sie im Setup-Assistenten Git Integration aus.
- Um ein bestehendes Projekt von manuellen Datei-Uploads auf einen kontinuierlichen Git-basierten Workflow umzustellen, gehen Sie zu Settings → 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 Repositorys eingeben können. PTC erkennt automatisch, dass Sie GitLab verwenden.
Authentifizierung bei GitLab
Um Ihr Repository zu verbinden, können Sie ein Access-Token verwenden (empfohlen) oder sich über OAuth anmelden. PTC unterstützt sowohl Project Access Tokens als auch Group Access Tokens.
PTC benötigt Webhook-Zugriff, um Änderungen in Ihrem Repository zu erkennen. Wenn Sie ein Access-Token verwenden, hängen die erforderliche Rolle und die Scopes davon ab, wie der Webhook eingerichtet werden soll:
| Automatische Webhook-Einrichtung | Manuelle Webhook-Einrichtung | |
|---|---|---|
| Funktionsweise | PTC erstellt und konfiguriert den Webhook in GitLab während des Integrationsprozesses in Ihrem Namen. | PTC stellt Ihnen eine Callback URL und ein Secret Token zur Verfügung. Sie erstellen einen Webhook in Ihren GitLab-Einstellungen mit diesen Details und wählen Push-Events sowie Merge-Request-Events als Trigger aus. |
| Erstellung des Tokens | Gehen Sie in Ihrem Projekt zu Settings → Access Tokens. Geben Sie dem Token einen Namen, eine optionale Beschreibung und legen Sie ein Ablaufdatum fest (aus Sicherheitsgründen empfohlen). | Gehen Sie in Ihrer Gruppe zu Settings → Access Tokens. 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 PTC das Lesen aus dem und das Pushen in das Repository |
read_repository + write_repository |
Speichern Sie das Token sicher und fügen Sie es in PTC hinzu. Es wird Ihre Berechtigungen verifizieren und Sie wählen lassen, welche Branches und Ressourcendateien überwacht werden sollen.
Der Zugriff bleibt auf die Dateien beschränkt, die PTC übersetzt
PTC nutzt den Lesezugriff, um Änderungen in Ihren Ressourcendateien zu erkennen, und den Schreibzugriff, um Übersetzungen über Merge Requests zu liefern. PTC interagiert nur mit den Dateien, die es für die Übersetzung verwaltet, und nimmt keine Änderungen an anderen Teilen Ihres Repositorys vor.
Webhooks halten Übersetzungen automatisch synchron
Über Webhooks wird PTC benachrichtigt, wenn Sie Änderungen in Ihr Repository pushen, sodass betroffene Strings automatisch neu übersetzt werden können. Ohne Webhook-Zugriff kann PTC Ihre Branches nicht auf Aktualisierungen überwachen.
Übersetzen Sie Ihr Projekt mit PTC
Sobald Ihr GitLab-Repository verbunden ist, fahren Sie mit den Einrichtungsschritten fort, um Kontext zu Ihrer App oder Software anzugeben und Ihre Zielsprachen auszuwählen.
PTC übersetzt dann die Ressourcendateien in Ihrem verbundenen GitLab-Branch. Falls Ihr Repository bereits Übersetzungsdateien enthält, kann PTC diese erkennen und wiederverwenden.
Prüfen Sie den Merge Request mit Übersetzungen
PTC übersetzt innerhalb von Minuten und sendet einen Merge Request mit den Übersetzungen direkt an Ihr GitLab-Repository. Sobald Sie bereit sind, führen Sie ihn einfach zusammen — keine weiteren Schritte erforderlich.
Von diesem Zeitpunkt an erkennt PTC alle Änderungen, die Sie in Ihren Code pushen, und sendet neue Merge Requests mit aktualisierten Übersetzungen, sodass Ihre Software dauerhaft vollständig lokalisiert bleibt.
Neue Merge Requests manuell erstellen
Zusätzlich zu den automatischen Aktualisierungen können Sie jederzeit manuell einen neuen Merge Request erstellen, um Übersetzungen zu synchronisieren, die Sie bearbeitet oder neu übersetzt haben.
Gehen Sie dazu auf den Tab Translations. Hier können Sie übersetzte Texte prüfen, die das Längenlimit überschreiten, und diese entweder manuell bearbeiten oder 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 PTC Zugriff auf neue Ressourcendateien beim Hinzufügen
Wenn Sie nach der Ersteinrichtung neue Ressourcendateien zu Ihrem Repository hinzufügen, können Sie PTC anweisen, nach diesen zu suchen.
- Gehen Sie zu Settings → Monitored Files und klicken Sie auf Rescan your repository. PTC scannt Ihr Repository und zeigt alle neu entdeckten Dateien als Entwürfe an.
- Klicken Sie auf das +-Symbol neben einer Datei, um sie für die Übersetzung einzuschließen, und klicken Sie dann zur Bestätigung auf Save with translation.
Um die manuelle Prüfung vollständig zu überspringen, aktivieren Sie das Kontrollkästchen Automatically include new translation files. Von diesem Zeitpunkt an wird PTC alle neu gefundenen Ressourcendateien automatisch erfassen 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, Monitored Files und Languages.
Warum GitLab-Projekte mit PTC lokalisieren
Automatisierte Dateiübersetzung
PTC erkennt und übersetzt Ihre Ressourcendateien automatisch und liefert die Übersetzungen per Merge Request. Sie behalten die Kontrolle, indem Sie den GitLab-Workflow nutzen, den Sie bereits kennen und dem Sie vertrauen — und das ohne ein eigenes Skript erstellen zu müssen.
Weniger manuelle Arbeit
PTC spart Entwicklungszeit und beschleunigt Releases, indem es Ihr Repository überwacht und Übersetzungsdateien aktualisiert, sobald Sie Änderungen pushen.
Verbesserte Übersetzungsgenauigkeit
PTC eliminiert das Risiko menschlicher Fehler wie falsch platzierte Keys oder veraltete Übersetzungen. Sie erhalten hochpräzise und markengerechte Übersetzungen.
Lokalisierung hält Schritt mit Software- und Mobile-Entwicklung
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 verbunden haben, erkennt 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 PTC in diese Workflows einfügt, finden Sie auf unseren Seiten für Software-Lokalisierung und Lokalisierung mobiler Apps.
GitLab ohne zusätzliche Kosten verbinden
Für die Verbindung mit GitLab fallen keine zusätzlichen Gebühren an. Anstelle eines Abomodells nutzt PTC eine einfache Pay-As-You-Go-Preisgestaltung: Sie zahlen nur für die Wörter, die Sie übersetzen, und die ersten 500 Wörter pro Monat sind kostenlos. Alle Details finden Sie auf der PTC-Preisseite.
Funktioniert auch mit GitHub und Bitbucket
Zusätzlich zu GitLab lässt sich PTC mit GitHub und Bitbucket integrieren und bietet für jede Plattform die gleichen automatisierten Lokalisierungs-Workflows und Funktionen.