Ramificación (Strings)

La ramificación está habilitada en la pestaña Avanzado de Configuración del proyecto con la opción de proteger la rama principal de cambios.

Cuando está habilitado, se presenta un menú de ramas en la pantalla del proyecto donde se pueden seleccionar las ramas en las que se está trabajando. Para especificar una rama en CLI, usa el parámetro --branch:

--branch <branch_name>

Las ramas se enumeran en la pestaña Ramas de un proyecto, donde se presenta información sobre la 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 Ramas.

Para listar todas las ramas del proyecto a través de API o CLI, ejecuta:

$ phrase branches list --project_id <project_id>

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

Para eliminar una rama a través de API o CLI, ejecuta:

$ 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 Developer pueden crear nuevas ramas en el editor de traducción, a través de API o en la CLI.

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

Para crear una rama a través de API o CPI, ejecuta:

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

Para crear una rama al enviar traducciones, ejecuta:

$ phrase push --branch <branch_name>

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

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

Los cambios en otros recursos, como Actividades, Trabajos y Órdenes, 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 claves (como las formas plurales) pueden haber cambiado en el proyecto principal después de que se crea una rama, haciendo que los valores en la rama sean diferentes de los del proyecto principal.

Para unir una rama, sigue estos pasos:

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

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

Al usar CLI, especifica una rama para empujar o jalar con el parámetro --branch.

$ phrase push --branch <branch_name>
$ frase jalar --branch <branch_name>

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

Usa --usar-nombre-rama-local para empujar y jalar usando el nombre de la rama activa de git:

$ frase empujar --usar-nombre-rama-local
$ frase jalar --usar-nombre-rama-local

Todos los puntos finales de API que toman un argumento de proyecto también soportan 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 característica-asombrosa,necesita-corrección \

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

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