GitLab-Integration mit PTC

Verbinden Sie GitLab mit PTC für eine kontinuierliche Lokalisierung. Erhalten Sie Übersetzungen über automatische Merge Requests, sobald 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 Ihren Code, und PTC erkennt sie 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 selbst gehostete GitLab-Repositories. Je nachdem, wo Sie sich in Ihrem Workflow befinden, gibt es zwei Möglichkeiten, um zu beginnen:

Wählen Sie beim Erstellen eines neuen Projekts in PTC im Einrichtungsassistenten die Option Git Integration.
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 (empfohlen) verwenden oder sich mit 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. Bei Verwendung eines Access Tokens hängen die benötigte 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 Integrationsablaufs in Ihrem Namen.	PTC stellt Ihnen eine Callback-URL und ein Secret Token bereit. Sie erstellen mit diesen Angaben einen Webhook in Ihren GitLab-Einstellungen, mit Push events und Merge request events als Auslösern.
Token erstellen	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` → Ermöglicht PTC das Lesen aus dem und Pushen in das Repository	`read_repository` + `write_repository`

Speichern Sie das Token sicher und fügen Sie es zu PTC hinzu. Es überprüft Ihre Berechtigungen und lässt Sie auswählen, welche Branches und Ressourcendateien überwacht werden sollen.

Der Zugriff bleibt auf die Dateien beschränkt, die PTC übersetzt

PTC nutzt Lesezugriff, um Änderungen in Ihren Ressourcendateien zu erkennen, und Schreibzugriff, um Übersetzungen über Pull Requests bereitzustellen. 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 es betroffene Strings automatisch neu übersetzen kann. 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 etwas Kontext zu Ihrer App oder Software bereitzustellen und Ihre Zielsprachen auszuwählen.

PTC übersetzt dann die Ressourcendateien in Ihrem verbundenen GitLab-Branch. Wenn Ihr Repository bereits Übersetzungsdateien enthält, kann PTC diese erkennen und wiederverwenden.

Prüfen Sie den Merge Request mit den Übersetzungen

PTC übersetzt in wenigen Minuten und sendet einen Merge Request mit Übersetzungen direkt an Ihr GitLab-Repo. Sobald Sie bereit sind, mergen Sie ihn einfach - keine weitere Aktion nötig.

Von diesem Zeitpunkt an erkennt PTC Änderungen, sobald Sie sie an 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 einen neuen Merge Request erstellen, um Übersetzungen zu synchronisieren, die Sie bearbeitet oder neu übersetzt haben.

Gehen Sie dazu zum Tab Translations. Hier können Sie übersetzten Text prüfen, der das Längenlimit überschreitet, und ihn entweder manuell bearbeiten oder PTC eine kürzere Version erstellen lassen. Wenn Sie fertig sind, klicken Sie auf Generate MR, um die aktualisierten Übersetzungen in Ihr Repository zu pushen.

Erstellen eines Merge Requests in PTC

Geben Sie PTC Zugriff auf neue Ressourcendateien, sobald Sie sie hinzufügen

Wenn Sie nach der ersten Integration neue Ressourcendateien zu Ihrem Repository hinzufügen, können Sie PTC bitten, danach zu suchen.

Gehen Sie zu Settings → Monitored Files und klicken Sie auf Rescan your repository. PTC durchsucht 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 einzubeziehen, und klicken Sie dann auf Save with translation, um zu bestätigen.

Erneutes Scannen des Repositorys

Um die manuelle Prüfung vollständig zu überspringen, aktivieren Sie das Kontrollkästchen Automatically include new translation files. Von diesem Zeitpunkt an erkennt und überwacht PTC automatisch alle neuen Ressourcendateien, die es findet, ohne dass Sie diese bestätigen müssen.

Auswahl, neue Übersetzungsdateien automatisch einzubeziehen

Um weitere 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 Übersetzungen über Merge Requests. Sie behalten die Kontrolle, indem Sie den GitLab-Workflow nutzen, den Sie bereits kennen und dem Sie vertrauen - und ohne ein 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.

Höhere Übersetzungsgenauigkeit

PTC eliminiert das Risiko menschlicher Fehler wie falsch platzierter Keys oder veralteter Übersetzungen. Sie erhalten hochpräzise und markengerechte Übersetzungen.

Die Lokalisierung hält Schritt mit der Software- und Mobile-Entwicklung

PTC ist für Teams konzipiert, 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. Mehr dazu, wie PTC in diese Workflows passt, finden Sie auf unseren Seiten zur Software-Lokalisierung und Mobile-App-Lokalisierung.

Verbinden Sie GitLab ohne zusätzliche Kosten

Für die Verbindung von GitLab fallen keine zusätzlichen Kosten an. Statt eines Abo-Modells verwendet 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

Neben GitLab lässt sich PTC auch mit GitHub und Bitbucket integrieren und bietet für jede Plattform dieselben automatisierten Lokalisierungs-Workflows und -Funktionen.