Ramificación (Strings)

La ramificación se habilita en la pestaña Advanced de configuración del proyecto con la opción de proteger la rama principal de cambios.

Cuando se habilita, se presenta un menú de rama en la pantalla del proyecto donde se pueden seleccionar las ramas de trabajo. Para especificar una rama en CLI, usar el parámetro --branch:

--branch <branch_name>

Las ramas se enumeran en la pestaña Branches de un proyecto, donde se presenta información de creación y fusión. Las ramas también se pueden eliminar o fusionar y se pueden crear trabajos para esa rama desde la pestaña Branches.

Para listar todas las ramas para el proyecto a través de API o CLI, ejecutar:

$ phrase branches list --project_id <project_id>

# p. ej.
$ phrase branches list --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches list <project_id>

Para eliminar una rama mediante API o CLI, ejecute:

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

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

Los roles de admin, project manager y desarrollador pueden crear nuevas ramas en el editor de traducción, mediante API o en la CLI.

Para crear una rama en el editor de traducción, siga estos pasos:

Para crear una rama mediante API o CLI, ejecute:

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

Para crear una rama al enviar traducciones, ejecute:

$ phrase push --branch <branch_name>

Después de realizar cambios en una rama, esta puede unirse de nuevo a la traducción principal para incorporar cualquier traducción nueva.

Solo los cambios en los siguientes recursos se aplican a la rama principal durante las uniones:

Los cambios en otros recursos, como Actividades, Trabajos y Pedidos, no se aplican.

Conflictos

Un conflicto ocurre cuando un recurso (traducción, clave o localización) ha cambiado tanto en el proyecto principal como en la rama entre el momento en que se crea una rama y cuando se une de nuevo al proyecto principal. Por ejemplo, las traducciones y la configuración de clave (como las formas plurales) pueden haber cambiado en el proyecto principal después de que se cree una rama, haciendo que los valores en la rama sean diferentes de los del proyecto principal.

Para unir una rama, siga estos pasos:

Para unir una rama a través de API o CPI, ejecute:

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

Al usar la CLI, especifique una rama desde la cual enviar o extraer con el parámetro --branch.

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

Si la rama especificada no existe en un proyecto, el cliente la crea.

Usar --use-local-branch-name para enviar y extraer usando el nombre de rama de una rama git activa:

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

Todos los puntos finales de la API que aceptan un argumento de proyecto también admiten el parámetro --branch para realizar una acción en una rama específica de un proyecto:

$ phrase upload create <project_id> \

  --branch <branch_name>

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

  --file-format json \

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  --tags awesome-feature,needs-proofreading \

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

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