GitHub-Lokalisierung
Automatisieren Sie die GitHub-Lokalisierung durch die Integration mit der PTC. Erhalten Sie automatische Pull Requests mit Übersetzungen in menschlicher Qualität.
So integrieren Sie GitHub in die PTC
Die PTC verbindet sich mit Ihrem GitHub-Repository und hält Ihre Ressourcendateien während Ihrer Arbeit übersetzt. Pushen Sie Änderungen an Ihrem Code, und die PTC erkennt diese automatisch, übersetzt die aktualisierten Strings und öffnet einen Pull Request – ganz ohne manuelle Schritte Ihrerseits.
Die Git-Integration ist ein Pro-Feature. Sie wird verfügbar, wenn Sie Pay-As-You-Go aktivieren.
Verbinden Sie Ihr Repository
Der Einstieg in die GitHub-Integration ist einfach:
- Wenn Sie bereits ein PTC-Konto haben und ein neues Projekt erstellen, wählen Sie im Einrichtungsassistenten Git-Integration aus.
- Wenn Sie mit einem manuellen Datei-Upload begonnen haben, können Sie jederzeit zu einem kontinuierlichen Git-basierten Workflow wechseln. 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. Die PTC erkennt automatisch den von Ihnen genutzten Dienst.
Authentifizierung in GitHub
Um der PTC Zugriff auf Ihr Repository zu gewähren, können Sie ein Zugriffstoken verwenden (empfohlen) oder sich mit OAuth anmelden. Wenn Sie sich über ein Zugriffstoken verbinden, stellen Sie sicher, dass es die richtigen Scopes und den korrekten Repository-Zugriff enthält.
| Wo es erstellt wird | Ressourcenbesitzer | Erforderliche Berechtigungen | Repository-Zugriff | |
|---|---|---|---|---|
| Persönliches Fine-Grained Token | Personal access tokens in den Developer Settings | Ihr GitHub-Benutzerkonto | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Wählen Sie „Only select repositories“ (empfohlen) oder „All repositories“ |
| Fine-Grained Token der Organisation | Personal access tokens in den Developer Settings Wichtig: Die Erstellung eines Fine-Grained Tokens kann durch die Zugriffsrichtlinien Ihrer Organisation eingeschränkt sein. Wenn Sie das Token nicht erstellen können, bitten Sie einen Administrator Ihrer Organisation, die Einstellungen der Personal Access Token Policy in GitHub zu überprüfen. |
Die GitHub-Organisation | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Wählen Sie „Only select repositories“ (empfohlen) oder „All repositories“ |
Bewahren Sie das Token sicher auf und fügen Sie es der PTC hinzu. Sie wird Ihre Berechtigungen überprüfen und Sie auffordern, auszuwählen, welche Branches überwacht werden sollen.
Übersetzen Sie Dateien in Ihrem Repository mit der PTC
Sobald Ihr GitHub-Repository mit der PTC verbunden ist, fahren Sie mit der Einrichtung fort, um Sprachen und Projektdetails hinzuzufügen.
Obwohl die PTC mit vorhandenen Übersetzungsdateien in Ihrem Repo arbeiten kann, stellt die Übersetzung Ihres gesamten Projekts mit der PTC die Konsistenz über alle Sprachen hinweg sicher.
Überprüfen Sie Pull Requests
Die PTC benötigt in der Regel nur wenige Minuten, um die Dateien in Ihrem ausgewählten GitHub-Branch zu übersetzen. Sobald dies abgeschlossen ist, sendet Ihnen die PTC eine E-Mail mit einem Link zum Pull Request.
Überprüfen und genehmigen Sie den Pull Request, wenn Sie bereit sind. Die Übersetzungen der PTC haben Produktionsqualität und können ohne manuelle Überprüfung gemergt werden.
Nachdem Sie die ersten Übersetzungen gemergt haben, überwacht die PTC weiterhin Ihre Ressourcendateien und sendet neue Pull Requests mit aktualisierten Übersetzungen, sobald Änderungen erkannt werden.
So generieren Sie neue Pull Requests manuell
Gehen Sie in der PTC zum Tab Translations, um Übersetzungen in jeder von Ihnen ausgewählten Sprache in einer Tabelle organisiert zu sehen. Auf dieser Seite können Sie Bearbeitungen vornehmen oder die PTC bitten, neu zu übersetzen – zum Beispiel, wenn Übersetzungen eine Längenbegrenzung überschreiten.
Klicken Sie auf Create a merge request, um einen neuen Pull Request mit den aktualisierten Übersetzungen zu senden.
Fügen Sie neue Ressourcendateien zur Übersetzung hinzu
Wenn Sie nach der Verbindung mit der PTC 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 wird Ihr Repository scannen und alle neu entdeckten Dateien als Entwürfe anzeigen.
- Klicken Sie auf das +-Symbol neben einer entdeckten Datei, um sie für die Übersetzung einzuschließen, und klicken Sie dann zur Bestätigung auf Save with translation.
Aktivieren Sie das Kontrollkästchen Automatically include new translation files, damit die PTC neu entdeckte Ressourcendateien überwacht und einschließt, ohne jedes Mal um Bestätigung zu bitten.
Warum Sie Ihre GitHub-Projekte mit der PTC lokalisieren sollten
Einfache Verbindung zu Ihrem Repository
Die PTC integriert sich direkt in Ihr GitHub-Repository und eliminiert manuelle Datei-Uploads und -Downloads oder die Notwendigkeit, Übersetzungsskripte auszuführen.
Echtzeitsynchronisation
Die PTC überwacht Ihr GitHub-Repository auf Änderungen in Ressourcendateien, generiert automatisch Übersetzungen und sendet diese über Pull Requests zurück.
Schnellere Lokalisierung für globale Märkte
Die PTC beschleunigt den Lokalisierungsprozess, indem sie automatisch hochwertige Übersetzungen liefert – direkt über Pull Requests. Passen Sie Ihre Software schnell an globale Märkte an und verkürzen Sie Ihre Markteinführungszeit.
Nur der Repository-Zugriff, der benötigt wird
Die PTC nutzt Lesezugriff, um Änderungen an Ihren Ressourcendateien zu erkennen, und Schreibzugriff, um Übersetzungen über Pull 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 Repositorys vor.
Lokalisierung, die mit Ihrem Release-Zyklus Schritt hält
Die PTC wurde für Entwicklungsteams entwickelt, die möchten, dass die Lokalisierung im gleichen Tempo wie ihr Code voranschreitet. Die PTC überwacht Ihr Repository auf neue oder aktualisierte Strings und liefert Übersetzungen automatisch per Pull Request zurück, sodass die Lokalisierung niemals zu einem Engpass in Ihrem Release-Zyklus wird.
Sie funktioniert mit den Dateiformaten, die in der Software- und Mobile-Entwicklung üblich sind, einschließlich PO-Dateien und JSON-Dateien. Weitere Informationen dazu, wie sich die PTC in diese Workflows einfügt, finden Sie auf unseren Seiten zur Software-Lokalisierung und Lokalisierung mobiler Apps.
Funktioniert mit GitHub, GitLab und Bitbucket
Zusätzlich zu GitHub lässt sich die PTC in GitLab und Bitbucket integrieren und bietet für jede Plattform dieselben automatisierten Lokalisierungs-Workflows und Funktionen.
Ohne zusätzliche Kosten inbegriffen
Die GitHub-Integration ist ohne zusätzliche Kosten inbegriffen. Bei der PTC gibt es keine Abonnementgebühren oder Kosten pro Funktion. Sie zahlen nur für die Wörter, die Sie übersetzen, und die ersten 500 Wörter jeden Monat sind kostenlos. Ausführliche Preisinformationen finden Sie auf der Preisseite.