GitLab-Integration mit PTC
Verbinden Sie GitLab mit PTC für eine kontinuierliche Lokalisierung. Erhalten Sie Übersetzungen über automatische 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 übersetzt, während Sie arbeiten. Pushen Sie Änderungen an Ihrem Code, und PTC wird diese automatisch erkennen, die aktualisierten Strings übersetzen und einen Merge Request öffnen.
Die GitLab-Integration ist eine Pro-Funktion. Sie wird verfügbar, wenn Sie Pay-As-You-Go aktivieren.
Verbinden Sie Ihr GitLab-Repository
PTC unterstützt sowohl GitLab.com als auch selbstgehostete GitLab-Repositorys. Je nachdem, wo Sie sich in Ihrem Workflow befinden, gibt es zwei Möglichkeiten, um zu starten:
- Wählen Sie beim Erstellen eines neuen Projekts in PTC 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 Repositorys eingeben können. PTC erkennt automatisch, dass Sie GitLab verwenden.
Authentifizieren Sie sich bei GitLab
Um Ihr Repository zu verbinden, können Sie ein Zugriffstoken verwenden (empfohlen) oder sich mit OAuth anmelden. PTC unterstützt sowohl Projekt-Zugriffstokens als auch Gruppen-Zugriffstokens.
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 | |
|---|---|---|
| Wie es funktioniert | PTC erstellt und konfiguriert den Webhook in GitLab in Ihrem Namen während des Integrationsprozesses. | 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. |
| Erstellen des Tokens | Gehen Sie in Ihrem Projekt zu Einstellungen → Zugriffstokens. 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 Einstellungen → Zugriffstokens. 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, aus dem Repository zu lesen und in dieses zu pushen |
read_repository + write_repository |
Speichern Sie das Token sicher und fügen Sie es zu PTC hinzu. PTC 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 PTC übersetzt
PTC verwendet 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 sie 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 sie betroffene Strings automatisch neu übersetzen kann. Ohne Webhook-Zugriff kann PTC Ihre Branches nicht auf Updates ü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 bereitzustellen und Ihre Zielsprachen auszuwählen.
PTC wird dann die Ressourcendateien in Ihrem verbundenen GitLab-Branch übersetzen. Wenn Ihr Repository bereits Übersetzungsdateien enthält, kann PTC diese erkennen und wiederverwenden.
Überprüfen Sie den Merge Request mit Übersetzungen
PTC übersetzt in Minuten und sendet einen Merge Request mit Übersetzungen direkt an Ihr GitLab-Repo. Sobald Sie bereit sind, mergen Sie ihn einfach – es ist keine weitere Aktion erforderlich.
Wenn Sie von diesem Zeitpunkt an Änderungen an Ihrem Code pushen, wird PTC diese erkennen und neue Merge Requests mit aktualisierten Übersetzungen senden, wodurch Ihre Software dauerhaft vollständig lokalisiert bleibt.
Generieren Sie neue Merge Requests manuell
Zusätzlich zu automatischen Updates 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 diesen entweder manuell bearbeiten oder von 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, wenn Sie diese hinzufügen
Wenn Sie nach der anfänglichen Integration neue Ressourcendateien zu Ihrem Repository hinzufügen, können Sie PTC anweisen, nach diesen zu suchen.
- Gehen Sie zu Einstellungen → Überwachte Dateien und klicken Sie auf Rescan your repository. PTC wird Ihr Repository scannen und alle neu entdeckten Dateien als Entwürfe anzeigen.
- Klicken Sie auf das +-Symbol neben einer Datei, um sie in die Übersetzung einzubeziehen, und klicken Sie dann zur Bestätigung auf Save with translation.
Um die manuelle Überprüfung komplett zu überspringen, aktivieren Sie das Kontrollkästchen Automatically include new translation files. Von diesem Zeitpunkt an wird PTC automatisch alle neuen Ressourcendateien, die sie findet, 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, Überwachte Dateien und Sprachen.
Warum GitLab-Projekte mit PTC lokalisieren
Automatisierte Dateiübersetzung
PTC erkennt und übersetzt Ihre Ressourcendateien automatisch und liefert Ü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 Skript erstellen zu müssen.
Weniger manuelle Arbeit
PTC spart Entwicklungszeit und beschleunigt Releases, indem sie Ihr Repository überwacht und Übersetzungsdateien aktualisiert, während Sie Änderungen pushen.
Verbesserte Übersetzungsgenauigkeit
PTC eliminiert das Risiko menschlicher Fehler wie falsch platzierter Keys oder veralteter Übersetzungen. Sie erhalten hochpräzise und markenkonforme Übersetzungen.
Lokalisierung hält Schritt mit der 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 verbinden, erkennt PTC automatisch neue und aktualisierte Strings und liefert Ü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 zur Software-Lokalisierung und Lokalisierung mobiler Apps.
GitLab ohne zusätzliche Kosten verbinden
Für die Verbindung von GitLab fallen keine zusätzlichen Gebühren an. Anstelle eines Abonnementmodells nutzt 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 PTC in GitHub und Bitbucket integrieren und bietet für jede Plattform die gleichen automatisierten Lokalisierungs-Workflows und Funktionen.