GitHub-Lokalisierung

+

Automatisieren Sie die GitHub-Lokalisierung durch die Integration mit PTC. Erhalten Sie automatische Pull-Requests mit qualitativ hochwertigen Übersetzungen.

So integrieren Sie GitHub mit PTC

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

1

Verbinden Sie Ihr Repository

Der Einstieg in die GitHub-Integration ist einfach:

  • Wenn Sie bereits ein PTC-Konto haben und ein weiteres Projekt erstellen, wählen Sie im Einrichtungs-Assistenten die Option Git-Integration.
  • 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 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 den Dienst, den Sie verwenden.


2

In GitHub authentifizieren

Um PTC Zugriff auf Ihr Repository zu geben, können Sie ein Zugriffstoken (empfohlen) verwenden oder sich per OAuth anmelden. Wenn Sie die Verbindung über ein Zugriffstoken herstellen, stellen Sie sicher, dass es die richtigen Scopes und Repository-Zugriffe umfasst.

Persönlicher fein abgestufter Token

Wo Sie ihn erstellen können

Persönliche Zugriffstoken in den Entwicklereinstellungen

Ressourcen-Eigentümer

Ihr GitHub-Benutzerkonto

Erforderliche Berechtigungen

Wählen Sie „nur ausgewählte Repositorys“ (empfohlen) oder „alle Repositorys“

Repository-Zugriff

Commit-Status → Nur lesen
Inhalte → Lesen und schreiben
Pull-Requests → Lesen und schreiben
Webhooks → Lesen und schreiben

Fein abgestufter Organisations-Token

Wo Sie ihn erstellen können

Persönliche Zugriffstoken in den Entwicklereinstellungen

Wichtig: Das Erstellen eines feingranularen Zugriffstokens kann durch die Zugriffsrichtlinien Ihrer Organisation eingeschränkt sein. Wenn Sie das Token nicht erstellen können, bitten Sie einen Organisationsadministrator, die Einstellungen der Richtlinie für persönliche Zugriffstoken in GitHub zu überprüfen.

Ressourcen-Eigentümer

Die GitHub-Organisation

Erforderliche Berechtigungen

Wählen Sie „nur ausgewählte Repositorys“ (empfohlen) oder „alle Repositorys“

Repository-Zugriff

Commit-Status → Nur lesen
Inhalte → Lesen und schreiben
Pull-Requests → Lesen und schreiben
Webhooks → Lesen und schreiben

Wo Sie ihn erstellen können

Ressourcen-Eigentümer

Erforderliche Berechtigungen

Repository-Zugriff

Persönlicher fein abgestufter Token

Persönliche Zugriffstoken in den Entwicklereinstellungen

Ihr GitHub-Benutzerkonto

Wählen Sie „nur ausgewählte Repositorys“ (empfohlen) oder „alle Repositorys“

Commit-Status → Nur lesen
Inhalte → Lesen und schreiben
Pull-Requests → Lesen und schreiben
Webhooks → Lesen und schreiben

Fein abgestufter Organisations-Token

Persönliche Zugriffstoken in den Entwicklereinstellungen

Wichtig: Das Erstellen eines feingranularen Zugriffstokens kann durch die Zugriffsrichtlinien Ihrer Organisation eingeschränkt sein. Wenn Sie das Token nicht erstellen können, bitten Sie einen Organisationsadministrator, die Einstellungen der Richtlinie für persönliche Zugriffstoken in GitHub zu überprüfen.

Die GitHub-Organisation

Wählen Sie „nur ausgewählte Repositorys“ (empfohlen) oder „alle Repositorys“

Commit-Status → Nur lesen
Inhalte → Lesen und schreiben
Pull-Requests → Lesen und schreiben
Webhooks → Lesen und schreiben

Speichern Sie das Token sicher und fügen Sie es in PTC hinzu. PTC überprüft Ihre Berechtigungen und fordert Sie auf, auszuwählen, welche Branches überwacht werden sollen.

3

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.

PTC kann zwar mit vorhandenen Übersetzungsdateien in Ihrem Repo arbeiten, aber wenn Sie Ihr gesamtes Projekt mit PTC übersetzen, sorgt das für Konsistenz über alle Sprachen hinweg.

4

Pull Requests prüfen

PTC benötigt in der Regel nur wenige Minuten, um die Dateien in Ihrem ausgewählten GitHub-Branch zu übersetzen. Nach Abschluss sendet Ihnen PTC eine E-Mail mit einem Link zum Pull Request.

Prüfen und genehmigen Sie den Pull Request, sobald Sie bereit sind. Die Übersetzungen von PTC sind produktionsreif und können ohne manuelle Prü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 erstellen Sie neue Pull Requests manuell

Gehen Sie in PTC zum Tab Übersetzungen, um Übersetzungen in jeder von Ihnen ausgewählten Sprache zu sehen, übersichtlich in einer Tabelle organisiert. Auf dieser Seite können Sie Änderungen vornehmen oder PTC um eine Neuübersetzung bitten – zum Beispiel, wenn Übersetzungen ein Längenlimit überschreiten.

Klicken Sie auf MR erstellen, um einen neuen Pull Request mit den aktualisierten Übersetzungen zu senden.

5

Neue Ressourcendateien zur Übersetzung hinzufügen

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

  1. Gehen Sie zu Einstellungen → Überwachte Dateien und klicken Sie auf Repository erneut scannen. PTC scannt Ihr Repository und zeigt alle neu gefundenen Dateien als Entwürfe an.
  2. Klicken Sie auf das +-Symbol neben einer gefundenen Datei, um sie für die Übersetzung einzuschließen, und klicken Sie anschließend auf Mit Übersetzung speichern, um zu bestätigen.

Aktivieren Sie das Kontrollkästchen Neue Übersetzungsdateien automatisch einschließen, damit PTC neu gefundene Ressourcendateien überwacht und ohne jedes Mal eine Bestätigung anzufordern einschließt.

Warum Sie Ihre GitHub-Projekte mit PTC lokalisieren sollten

Einfache Verbindung zu Ihrem Repository

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

Echtzeit-Synchronisierung

PTC überwacht Ihr GitHub-Repository auf Änderungen in Ressourcendateien, generiert automatisch Übersetzungen und sendet diese per Pull-Requests zurück.

Schnellere Lokalisierung für globale Märkte

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

Häufig gestellte Fragen zur GitHub-Integration

Nach oben scrollen