-
Team-, Business- und Enterprise-Pläne
Kontaktiere Vertrieb für Fragen zur Lizenzierung.
-
Ultimate- und Enterprise-Pläne (Legacy)
Kontaktiere Vertrieb für Fragen zur Lizenzierung.
Tipp
Informationen zur GitHub-Integration in Phrase Strings findest du unter GitHub (Strings).
Der GitHub-Konnektor ermöglicht das Herunterladen von Ausgangssprache-Dateien und das Hochladen von Zielsprache-Dateien direkt in das/aus dem GitHub-Repository.
Der Konnektor verwendet die GitHub-API, um die Integration zu implementieren. Der Konnektor ermöglicht den Zugriff auf alle Repositories, die mit einem GitHub-User-Konto verknüpft sind. Die Authentifizierung des GitHub-User-Kontos kann auch in der GitHub App erfolgen.
Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:
-
Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen.
-
Richte das Submitter Portal ein, um Einreichern zu ermöglichen, Dateien direkt aus dem Online-Repository zu Anfragen hinzuzufügen.
-
Verwende die Automatisierte Projekterstellung (APE), um automatisch neue Projekte erstellen zu lassen, wenn bei überwachten Dateien oder Ordnern eine Änderung der Dateigröße festgestellt wird.
-
Dieser Konnektor unterstützt die Einstellung absoluter Pfade. Zielsprache-Übersetzungsdateien können nur im selben Branch wie die Ausgangssprache-Datei gespeichert werden.
-
-
Richte kontinuierliche Jobs ein, um ausgewählte Dateien auf Änderungen zu überwachen.
GitHub (Beta)
Hinweis
Der Konnektor befindet sich seit Juni 2026 in der Beta-Phase.
Authentifizierung
Der GitHub (Beta)-Konnektor verwendet das GitHub App-Installationstoken anstelle eines individuellen User-Kontos. Token sind kurzlebig und erneuern sich automatisch. Wenn ein User die Organisation verlässt oder den Zugriff auf das Repository verliert, funktioniert der Konnektor weiterhin.
Der GitHub (Beta)-Konnektor unterstützt nur die GitHub App-Authentifizierung. Die OAuth-Option des ursprünglichen Konnektors wird nicht unterstützt.
Exportieren
Der GitHub (Beta)-Konnektor fasst alle Dateien aus einem einzelnen Export in einem Commit und einem Pull Request zusammen, sodass CI pro Export unabhängig von der Dateianzahl nur einmal ausgeführt wird.
Dateien werden in einem einzigen Commit zusammengefasst, wenn der gesamte Content denselben Repository-Eigentümer, dasselbe Repository und denselben Branch teilt.
Wenn der APE so konfiguriert ist, dass Dateien hochgeladen werden, sobald sie einzeln fertiggestellt sind, wird jede Datei separat committet, anstatt sie zusammenzufassen.
Commit-Nachrichten werden automatisch generiert und können nicht angepasst werden. Beim Exportieren als Pull Request können der Name des Pull Requests und der Name des Zielsprache-Branch angepasst werden.
Bekannte Einschränkungen
-
Der Konnektor kann Dateien nur auflisten, herunterladen und hochladen. Das Löschen oder Verschieben von Dateien in GitHub wird nicht unterstützt. Jegliche Löschungen oder Umbenennungen müssen direkt in GitHub vorgenommen werden.
-
Die Dateiauflistung funktioniert aufgrund von GitHub API-Beschränkungen möglicherweise nicht korrekt für Repositorys mit mehr als 50.000 Dateien.
-
GitHub Enterprise Server wird derzeit nicht unterstützt.
-
Der neue Konnektor unterstützt nicht den OAuth-Flow des Vermächtnis-Konnektors. Wenn Ihre Organisation Beschränkungen für GitHub App-Installationen hat, lösen Sie diese vor der Migration.
Wechsel zum neuen GitHub (Beta)-Konnektor
Eine automatisierte Migration ist aufgrund der Änderung des Authentifizierungsmodells nicht möglich.
Hinweis
Das Wechseln eines kontinuierlichen APE vom Vermächtnis-Konnektor zum neuen Konnektor ist keine Migration. Phrase behandelt dies als eine neue Konnektor-Konfiguration, daher importiert der APE die Ausgangssprache-Datei als neuen Job erneut, anstatt den bestehenden zu aktualisieren. Die Datei wird als neuer Content behandelt, daher werden zuvor verarbeitete Wörter und maschinelle Übersetzungseinheiten (MTUs) nicht übernommen. Wenn Sie Konnektoren mitten im Projekt wechseln, erwarten Sie, dass die Wortanzahl und der MTU-Verbrauch für die betroffenen Dateien einen vollständigen Reimport widerspiegeln.
Voraussetzungen:
-
Admin-Zugriff auf deine GitHub Organisation, um eine GitHub App zu installieren. Installiere sie auf Organisationsebene, damit sie alle Repositories abdeckt, die deine APEs überwachen.
-
Bestehende APE-Einstellungen sichtbar (lasse den alten Konnektor in einem zweiten Tab geöffnet).
-
Ein Test-Branch oder ein Nicht-Produktions-Repository zur Validierung, bevor Live-Workflows umgestellt werden.
Folge diesen Schritten:
-
Installiere die Phrase GitHub App.
-
Scrolle in Phrase TMS auf der Seite „Einstellungen“
nach unten zum Abschnitt .
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Klicke auf Neuer Konnektor.
Die Seite öffnet sich.
-
Ändere den Typ auf GitHub (Beta).
-
Klicke auf Verbinden.
Phrase leitet zu GitHub weiter, um die Phrase GitHub App zu autorisieren.
-
Wähle auf GitHub die Organisation oder das User-Konto sowie die Repositories aus, auf die zugegriffen werden soll, und bestätige dann die Installation. Schließe jedes Repository ein, das derzeit von dem/den bestehenden Konnektor(en) überwacht wird.
GitHub leitet automatisch zu Phrase weiter.
-
Wähle das User-Konto oder die Organisation aus, das/die verbunden werden soll.
-
-
Erstelle einen neuen Konnektor.
-
Scrolle in Phrase TMS auf der Seite „Einstellungen“
-
Klicke auf Konnektoren.
-
Klicke auf Neuer Konnektor.
-
Wähle die im ersten Schritt festgelegte GitHub App-Installation aus.
-
Kopiere die Einstellungen vom bestehenden Konnektor:
-
Repository und Branch
-
Unterordner-Pfad (bei Verwendung der Unterordner-Überwachung)
-
Datei-filtern-Regex (falls konfiguriert)
-
Exportieren-Modus: direkter Commit oder Pull Request sowie Zielsprache-Branch
-
Name des Pull Requests und Name des Zielsprache-Branch (bei Verwendung des PR-Modus)
Es ist möglich, mehrere Konnektoren unter derselben GitHub App-Installation zu erstellen, jeder mit unabhängigen Einstellungen.
-
-
-
Erstellen Sie bestehende APEs im Dry-Run-Modus neu.
Löschen oder deaktivieren Sie die bestehenden APEs noch nicht.
-
Erstellen Sie neue APEs, die auf den neuen Konnektor verweisen und die bestehende APE-Konfiguration spiegeln.
-
Aktivieren Sie den dry-run-Modus für jeden neuen APE, bevor Sie ihn aktivieren. Der Dry-Run-Modus scannt das Repository und gleicht Dateien ab, ohne Übersetzungsaufträge auszulösen.
-
Überprüfen Sie die abgeglichenen Dateien. Bestätigen Sie, dass der Umfang mit dem übereinstimmt, den der bestehende APE überwacht.
-
-
Validieren Sie mit einem Test-Exportieren.
-
Nehmen Sie eine kleine Änderung an einer Datei im überwachten Bereich vor.
-
Lösen Sie ein Exportieren über den neuen Konnektor aus.
-
Bestätigen:
-
Es wird ein einzelner Commit erstellt (nicht einer pro Datei).
-
Der Commit erscheint unter der GitHub App-Identität, nicht unter einem persönlichen User-Konto.
-
CI läuft einmal, nicht einmal pro Datei.
-
-
-
Live-Workflows umschalten.
Sobald die Validierung erfolgreich war:
-
Deaktivieren Sie die APCs auf dem Vermächtnis Konnektor.
-
Aktivieren Sie die APCs auf dem neuen Konnektor (entfernen Sie den Dry-Run-Modus).
-
Überwachen Sie ein oder zwei Exportzyklen, bevor Sie den Vermächtnis Konnektor stilllegen.
-
-
Stilllegen Sie den Vermächtnis Konnektor.
Nachdem Sie bestätigt haben, dass der neue Konnektor stabil ist:
-
Löschen Sie die alten APCs.
-
Löschen Sie den Vermächtnis Konnektor unter Einstellungen → Konnektoren → GitHub (Vermächtnis).
-
Optional können Sie das OAuth-Token für das User-Konto widerrufen, das vom Vermächtnis Konnektor verwendet wurde.
-
GitHub Einstellungen (Vermächtnis)
Es sind keine Änderungen erforderlich.
Wichtig
Wenn Sie über einen Individuellen Fachbereich zugreifen (z. B. mydomain.phrase.jp), öffnen Sie ein Inkognito-Browserfenster und melden Sie sich über cloud.memsource.com oder us.cloud.memsource.com an, um die für das Erstellen oder Speichern des Konnektors erforderliche Authentifizierung anzuwenden. Nach dem Speichern kann über den Individuellen Fachbereich auf den Konnektor zugegriffen werden.
-
Scrolle auf der Seite Einstellungen
-
Klicke auf Konnektoren.
Die Seite wird geöffnet.
-
Klicke auf Neuer Konnektor.
Die Seite öffnet sich.
-
Ändern Sie den Typ auf GitHub und geben Sie einen Namen für den Konnektor an.
-
Optional können Sie aktivieren und die angeben.
-
Wählen Sie optional aus und geben Sie einen an.
-
Wählen Sie bei Bedarf , um die Phrase GitHub App-URL anzuzeigen und Dateien über den GitHub App-Autorisierungsablauf zu importieren/exportieren:
-
Klicken Sie auf den Link, um die offizielle Seite des Phrase App Konnektors in einem neuen Tab zu öffnen: https://github.com/apps/phrase-app-connector-eu (EU-Rechenzentrum) oder https://github.com/apps/phrase-app-connector-us (US-Rechenzentrum).
-
Installieren Sie die Phrase GitHub App für das Zielsprache GitHub User-Konto.
Hinweis
Wenn die GitHub App nicht für das Zielsprache GitHub User-Konto des Users installiert ist, sind für den GitHub Konnektor nur öffentliche Repositories sichtbar.
-
Schließen Sie den Installationsvorgang ab, indem Sie alle privaten Repositories auswählen, die für den GitHub-Konnektor sichtbar und zugänglich sein sollen.
-
Gehen Sie zurück zur Phrase -Seite, um die GitHub-App zu autorisieren und eine Verbindung zu GitHub herzustellen.
-
-
Klicken Sie auf Mit GitHub verbinden. Wenn keine Verbindung über die GitHub-App hergestellt wurde, erscheint ein Popup-Fenster oder ein neuer Tab, in dem Sie zur Autorisierung aufgefordert werden.
-
Geben Sie bei Bedarf eine an.
-
Klicken Sie auf die Schaltfläche Phrase autorisieren.
Wenn Sie die GitHub-App verwenden, klicken Sie auf die Schaltfläche Phrase App-Konnektor autorisieren.
Bei Erfolg schließt sich das Fenster/der Tab und ein kleines Häkchen erscheint neben der Schaltfläche Mit GitHub verbinden.
-
Klicke auf Speichern.
Der Konnektor wird der Liste auf der Seite hinzugefügt.
Wichtig
Wenn der GitHub-Konnektor über den Autorisierungsablauf der GitHub-App erstellt wurde, ist es nicht möglich, die Autorisierungsmethode nach dem Speichern der Konnektor-Einstellungen zu ändern.