+
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 stellt eine Verbindung zu Ihrem GitLab-Repository her und sorgt dafür, dass Ihre Ressourcendateien während der Arbeit übersetzt bleiben. Übertragen Sie Änderungen an Ihrem Code, und PTC wird diese automatisch erkennen, die aktualisierten Zeichenfolgen übersetzen und einen Merge-Request öffnen.
1
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 für den Einstieg:
- Wenn Sie in PTC ein neues Projekt 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 Git-Integration hinzufügen.
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.
2
Authentifizierung mit GitLab
Um Ihr Repository zu verbinden, können Sie ein Zugriffs-Token verwenden (empfohlen) oder sich über OAuth anmelden. PTC unterstützt sowohl Projekt-Zugriffs-Token als auch Gruppen-Zugriffs-Token.
PTC benötigt Webhook-Zugriff, um Änderungen in Ihrem Repository zu erkennen. Wenn Sie ein Zugriffs-Token verwenden, hängen die erforderliche Rolle und die Scopes davon ab, wie der Webhook eingerichtet werden soll:
Speichern Sie das Token sicher und fügen Sie es zu PTC hinzu. Es wird Ihre Berechtigungen überprüfen und Sie auswählen lassen, welche Branches und Ressourcendateien überwacht werden sollen.
3
Ü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.
4
Überprüfen Sie den Merge Request mit den Ü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 – es ist keine weitere Aktion erforderlich.
Von diesem Zeitpunkt an erkennt PTC jede Änderung, die Sie an Ihrem Code pushen, und sendet neue Merge Requests mit aktualisierten Übersetzungen, sodass Ihre Software dauerhaft vollständig lokalisiert bleibt.
Neue Merge Requests manuell generieren
Zusätzlich zu den 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 auf den Tab Übersetzungen. Hier können Sie übersetzte Texte überprüfen, die das Längenlimit überschreiten, und diese entweder manuell bearbeiten oder von PTC eine kürzere Version generieren lassen. Wenn Sie fertig sind, klicken Sie auf MR generieren, um die aktualisierten Übersetzungen in Ihr Repository zu übertragen.
5
Geben Sie PTC Zugriff auf neue Ressourcendateien beim Hinzufügen
Wenn Sie nach der ersten 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 Repository neu scannen. 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 Mit Übersetzung speichern.
Um die manuelle Überprüfung ganz zu überspringen, aktivieren Sie das Kontrollkästchen Neue Übersetzungsdateien automatisch einschließen. 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, Überwachte Dateien und Sprachen.
Warum Sie GitLab-Projekte mit PTC lokalisieren sollten
Automatisierte Dateiübersetzung
PTC erkennt und übersetzt Ihre Ressourcendateien automatisch und liefert die Übersetzungen über Merge Requests aus. 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 manueller Aufwand
PTC spart Entwicklungszeit und beschleunigt Releases, indem es Ihr Repository überwacht und Übersetzungsdateien aktualisiert, sobald Sie Änderungen pushen.
Verbesserte Genauigkeit der Übersetzung
PTC eliminiert das Risiko menschlicher Fehler wie falsch platzierte Schlüssel oder veraltete Übersetzungen. Sie erhalten hochpräzise und markenkonforme Übersetzungen.
