Branching (Strings)

Branching ist im Erweitert Tab der Projekteinstellungen aktiviert, mit der Option, den Hauptbranch vor Änderungen zu schützen.

Wenn aktiviert, wird ein Branch-Menü auf dem Projektbildschirm angezeigt, wo arbeitende Branches ausgewählt werden können. Um einen Branch in CLI anzugeben, verwenden Sie den --branch Parameter:

--branch <branch_name>

Branches werden im Branches Tab eines Projekts aufgelistet, wo Informationen zur Erstellung und Zusammenführung angezeigt werden. Branches können auch gelöscht oder zusammengeführt und Jobs für diesen Branch im Branches Tab erstellt werden.

Um alle Branches für das Projekt über API oder CLI aufzulisten, führen Sie aus:

$ phrase branches list --project_id <project_id>

# z.B.
$ phrase branches list --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches list <project_id>

Um einen Branch über API oder CLI zu löschen, führen Sie aus:

$ phrase branches delete --project_id <project_id> --name <branch_name>

# z.B.
$ phrase branches delete --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branch delete <project_id> <branch_name>

Admin-, Projektmanager- und Entwicklerrollen können neue Branches im Übersetzungseditor, über API oder in der CLI erstellen.

Um einen Branch im Übersetzungseditor zu erstellen, befolgen Sie diese Schritte:

Um einen Branch über API oder CPI zu erstellen, führen Sie aus:

$ phrase branches create --project_id <project_id> --data <data>

Um einen Branch beim Pushen von Übersetzungen zu erstellen, führen Sie aus:

$ Phrase push --branch <branch_name>

Nachdem Änderungen an einem Branch vorgenommen wurden, kann er in die Hauptübersetzung zusammengeführt werden, um neue Übersetzungen zu integrieren.

Nur Änderungen an den folgenden Ressourcen werden während der Zusammenführungen auf den Hauptbranch angewendet:

Änderungen an anderen Ressourcen, wie Aktivitäten, Jobs und Bestellungen, werden nicht angewendet.

Konflikte

Ein Konflikt tritt auf, wenn eine Ressource (Übersetzung, Schlüssel oder Gebietsschema) sowohl im Hauptprojekt als auch im Branch zwischen der Erstellung eines Branches und der Zusammenführung in das Hauptprojekt geändert wurde. Zum Beispiel können sich Übersetzungen und Schlüsseleinstellungen (wie Pluralformen) im Hauptprojekt nach der Erstellung eines Branches geändert haben, wodurch die Werte im Branch von denen im Hauptprojekt abweichen.

Um einen Branch zusammenzuführen, befolgen Sie diese Schritte:

Um einen Branch über die API oder CPI zusammenzuführen, führen Sie aus:

$ phrase branches merge \\
  --project_id <project_id> \\
  --name <name> \\
  --data '{"strategy":"verwenden_haupt"}' \\
  --access_token <token>

Bei der Verwendung der CLI geben Sie einen Branch an, von dem Sie pushen oder pullen möchten, mit dem --branch Parameter an.

$ Phrase push --branch <branch_name>
$ phrase pull --branch <branch_name>

Wenn der angegebene Branch in einem Projekt nicht existiert, erstellt der Kunde ihn.

Verwenden Sie --use-local-branch-name, um mit dem Branch-Namen eines aktiven Git-Branches zu pushen und zu pullen:

$ phrase push --use-local-branch-name
$ phrase pull --use-local-branch-name

Alle API-Endpunkte, die ein Projektargument akzeptieren, unterstützen auch den --branch Parameter, um eine Aktion auf einem bestimmten Branch eines Projekts auszuführen:

$ phrase upload create <project_id> \\

  --branch <branch_name>

  --file /path/to/my/file.json \

  --file-format json \\

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  --tags großartige-funktion, benötigt-korrekturlesen \

  --locale-mapping "{"en": "2"}" \

  --format-options "{"foo": "bar"}"