GitHub (Strings)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Tipp

Informationen zur GitHub Integration in Phrase TMS findest du auf GitHub (TMS).

Voraussetzungen

Die Konfigurationsdatei .phrase.yml muss im Stamm des zu überwachenden Branch vorhanden sein. Die Datei definiert, welche Dateien aus dem Repository importiert (pull) oder exportiert (push) werden sollen.
Für das Repository ist Lese- und Schreibzugriff erforderlich.
Falsch definierte Konfigurationsdateien können Fehler verursachen. Stelle sicher, dass die Datei mindestens eine push und eine pull Zielsprache, die korrekten Dateiformate und die korrekte Einstellung des Parameters update_translations enthält.
GitHub Zugriffstoken:
- Klassische Token
  
  Erfordert den Repository-Bereich (public_repo bei Synchronisierung mit einem öffentlichen Repository)
- Feinkörnige Token
  
  Erfordert die folgenden Berechtigungen:
  - Inhalte: Lesen und schreiben
  - Pull Anfragen: Lesen und schreiben
Wenn SSO in GitHub aktiviert ist, muss es auch für das Zugriffstoken aktiviert sein.
Der Branch phrase_translations kann nicht geschützt werden.
Stelle sicher, dass für die Repository-Einstellungen keine signierten Commits erforderlich sind.

Hinweis

Aufgrund der kontinuierlichen Verbesserungen ist die User-Oberfläche möglicherweise nicht dieselbe wie im Video.

Repositorys verknüpfen

Sobald die Konfigurationsdatei angelegt ist, gehen Sie folgendermaßen vor, um ein Repository zu verbinden:

Scrolle von der Seite Integrationen nach unten zum Konnektor GitHub Sync und klicke auf Konfigurieren.

Die Seite Repository-Synchronisierungen wird geöffnet.
Klicke auf Hinzufügen Sync / GitHub.

Das Fenster GitHub Sync Einstellungen wird geöffnet.
auswählen ein Projekt aus der Dropdown-Liste.
Optional selbstgehostete Instanz auswählen und den GitHub selbstgehosteten API Endpunkt bereitstellen.
Stelle ein persönliches Repository-Zugriffstoken mit einem API-Bereich bereit.
Wähle ein GitHub Repository aus der Dropdown Liste.
Wähle einen Repository Branch aus der Dropdown Liste, den du importieren (push) und exportieren (pull) kannst. Dies ist in der Regel der Master Branch.
Klicke auf Konfiguration validieren, um sicherzustellen, dass Zugriffstoken und Konfigurationsdatei korrekt sind.
Optional Automatisch importieren, um Dateien mit jedem Commit in den ausgewählten GitHub Branch zu importieren.
Klicke auf speichern.

Das Projekt ist nun mit dem ausgewählten GitHub Repository verbunden und in die Liste aufgenommen.

Dateien importieren

Stelle sicher, dass die push commands innerhalb der .phrase.yml Konfigurationsdatei korrekt konfiguriert sind. Push Optionen sind die gleichen wie für den uploads API Endpunkt.

Dateien importieren:

Wähle auf der Seite Repository-Synchronisierungen ein Projekt aus und klicke auf importieren.

Sprachen (in der Konfigurationsdatei als push Ausgangssprachen definiert) werden in das Projekt importiert.

Eine Standard Sprache muss vorhanden sein.

Hinweis

Bei Problemen beim Import verwende den CLI Kunden, um die Konfigurationsdatei .phrase.yml lokal zu testen und auf Fehlermeldungen zu prüfen.

Kontaktiere den technischen Support von phrase und füge der Supportanfrage die Konfigurationsdatei .phrase.yml hinzu.

Dateien exportieren

Stelle sicher, dass die pull Befehle innerhalb der .phrase.yml Konfigurationsdatei korrekt konfiguriert sind. Pull Optionen (z.B. include_empty_translations parameter) sind die gleichen wie für den locales download API Endpunkt.

Dateien exportieren:

Wähle auf der Seite Repository-Synchronisierungen ein Projekt aus und klicke auf exportieren.

Die aktuellsten Sprachen im Repository werden als neuer pull request exportiert.
Sobald Dateien exportiert wurden, kann der pull request im Repository zusammengeführt oder geschlossen und der Branch gelöscht werden.

Hinweis

Bei Exportproblemen verwende den CLI Kunden, um die Konfigurationsdatei .phrase.yml lokal zu testen und auf Fehlermeldungen zu prüfen.

Kontaktiere den technischen Support von phrase und füge der Supportanfrage die Konfigurationsdatei .phrase.yml hinzu.

Geschichte

Die Repository-Synchronisierungen speichern für jedes Projekt in Phrase Strings die letzten Importe und Exporte.

So sehen Sie den Verlauf:

Wähle auf der Seite Repository-Synchronisierungen ein Projekt aus und klicke auf Verlauf .

Der importieren- und exportieren für das Projekt wird angezeigt. exportieren im Verlauf enthalten einen Link zu der entsprechenden zusammenführen.