GitHub-Lokalisierung

Automatisieren Sie die GitHub-Lokalisierung durch die Integration mit PTC. Erhalten Sie automatische Pull Requests mit Übersetzungen in menschlicher Qualität.

So integrieren Sie GitHub in PTC

PTC verbindet sich mit Ihrem GitHub-Repository und hält Ihre Ressourcendateien während Ihrer Arbeit übersetzt. Pushen Sie Änderungen an Ihrem Code, und PTC erkennt diese automatisch, übersetzt die aktualisierten Strings und eröffnet einen Pull Request – alles ohne manuelle Schritte Ihrerseits.

Die Git-Integration ist eine Pro-Funktion. 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. PTC erkennt den von Ihnen genutzten Dienst automatisch.

In GitHub authentifizieren

Um 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 korrekten Scopes und den richtigen 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 Organization Admin, 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 in PTC hinzu. Sie wird Ihre Berechtigungen überprüfen und Sie auffordern auszuwählen, welche Branches überwacht werden sollen.

Dateien in Ihrem Repository mit PTC übersetzen

Sobald Ihr GitHub-Repository mit PTC verbunden ist, fahren Sie mit der Einrichtung fort, um Sprachen und Projektdetails hinzuzufügen.

Obwohl PTC mit bestehenden Übersetzungsdateien in Ihrem Repository arbeiten kann, stellt die Übersetzung Ihres gesamten Projekts mit PTC die Konsistenz über alle Sprachen hinweg sicher.

Pull Requests überprüfen

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 PTC eine E-Mail mit einem Link zum Pull Request.

Überprüfen und genehmigen Sie den Pull Request, wenn Sie bereit sind. Die Übersetzungen von PTC haben Produktionsqualität und können ohne manuelle Überprüfung gemergt werden.

Nachdem Sie die ersten Übersetzungen gemergt haben, überwacht 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 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 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.

Neue Ressourcendateien zur Übersetzung hinzufügen

Wenn Sie Ihrem Repository nach der Verbindung mit PTC neue Ressourcendateien hinzufügen, können Sie PTC anweisen, danach zu suchen.

Gehen Sie zu Einstellungen → Überwachte Dateien 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 entdeckten Datei, um sie in 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 PTC neu entdeckte Ressourcendateien überwacht und einschließt, ohne jedes Mal um Bestätigung zu bitten.

Auswählen von automatically include new translation files

Warum Sie Ihre GitHub-Projekte mit PTC lokalisieren sollten

Einfache Verbindung zu Ihrem Repository

PTC integriert sich direkt in Ihr GitHub-Repository und eliminiert manuelle Datei-Uploads und -Downloads oder die Notwendigkeit, Übersetzungsskripte auszuführen.

Echtzeit-Synchronisierung

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

PTC beschleunigt den Lokalisierungsprozess, indem sie hochwertige Übersetzungen automatisch über Pull Requests liefert. Passen Sie Ihre Software schnell an globale Märkte an und verkürzen Sie Ihre Markteinführungszeit.

Nur der benötigte Repository-Zugriff

PTC verwendet Lesezugriff, um Änderungen in Ihren Ressourcendateien zu erkennen, und Schreibzugriff, um Übersetzungen über Pull 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.

Lokalisierung, die mit Ihrem Release-Zyklus Schritt hält

PTC wurde für Entwicklungsteams entwickelt, die möchten, dass die Lokalisierung im gleichen Tempo wie ihr Code voranschreitet. PTC überwacht Ihr Repository auf neue oder aktualisierte Strings und liefert Übersetzungen automatisch per Pull Request zurück, sodass die Lokalisierung in Ihrem Release-Zyklus nie zum Engpass wird.

Sie funktioniert mit den in der Software- und Mobile-Entwicklung üblichen Dateiformaten, einschließlich PO-Dateien und JSON-Dateien. Weitere Informationen dazu, wie sich PTC in diese Workflows einfügt, finden Sie auf unseren Seiten zur Software-Lokalisierung und Lokalisierung von mobilen Apps.

Funktioniert mit GitHub, GitLab und Bitbucket

Zusätzlich zu GitHub lässt sich 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 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.