Tip
Para obtener información sobre integración GitHub en Phrase TMS, consulte GitHub (TMS).
Requisitos previos
-
El archivo de configuración
.phrase.ymldebe estar presente en la raíz de la rama a monitorizar. El archivo define qué archivos importar (pull) o exportar (push) del repositorio. -
Se requiere acceder lectura y escritura para el repositorio.
-
Los archivos de configuración definidos incorrectamente pueden causar errores. Asegúrese de que el archivo contenga al menos una meta push y una pull, los formatos de archivo correctos y la configuración correcta del parámetro
actualization_translations. -
-
Identificadores únicos clásicos
Requiere el alcance repo (
public_reposi se sincroniza con un repositorio público) -
Identificadores únicos de grano fino
Se requieren los siguientes permisos:
-
Contenido: Lectura y escritura
-
Solicitudes pull: Lectura y escritura
-
-
-
Si SSO está habilitado en GitHub, también debe estar habilitado para el token de acceso.
-
No se puede proteger la rama phrase_translations.
-
Asegúrese de que la configuración repositorio no requiera compromisos firmados.
Nota
Debido a las continuas mejoras, es posible que la interfaz de usuario no sea exactamente la misma que se presenta en el vídeo.
Una vez que el archivo de configuración está en su lugar, para conectar un repositorio, siga estos pasos:
-
Desde la página , desplácese hacia abajo hasta el conector y haga clic en Configurar.
Se abre la página .
-
Haz clic en Agregar sincronización / GitHub.
Se abre la ventana de configuración .
-
Selecciona un proyecto de la lista desplegable.
-
Opcionalmente selecciona y proporciona el autohospedado de GitHub.
-
Selecciona un de la lista desplegable.
-
Selecciona una de la lista desplegable desde la que importar (push) y exportar (pull). Esta suele ser la rama principal.
-
Haga clic en Validar configuración para asegurarse de que el token de acceso y el archivo de configuración son correctos.
-
Selecciona opcionalmente para importar archivos con cada commit a la rama GitHub seleccionada.
-
Haz clic en Guardar.
El proyecto ahora está conectado al repositorio GitHub seleccionado y se agrega a la lista.
Asegúrate de que los comandos push estén configurados correctamente dentro del archivo de configuración .phrase.yml. Las opciones push son las mismas que para el endpoint API uploads.
Para importar archivos:
-
Desde la página de , seleccione un proyecto y haga clic en Importar
.
Los archivos de idioma (definidos como entradas push fuente en el archivo de configuración) se importan al proyecto.
Debe estar presente una localización predeterminada.
Nota
En caso de problemas al importar, use el cliente CLI para probar el archivo de configuración
.phrase.ymllocalmente y verificar si hay mensajes de error.Si es necesario, contacte con Phrase Technical Support y adjunte el archivo de configuración
.phrase.ymla la solicitud de soporte.
Asegúrate de que los comandos pull estén configurados correctamente dentro del archivo de configuración .phrase.yml. Las opciones pull (por ejemplo, el parámetro include_empty_translations) son las mismas que para el endpoint local download API.
Exportar archivos:
-
Desde la página , seleccione un proyecto y haga clic en Exportar
.
Los archivos de idioma más recientes en el repositorio se exportan como una nueva solicitud pull.
-
Una vez exportados los archivos, la petición pull se puede fusionar o cerrar en el repositorio y se puede eliminar la rama.
Nota
En caso de problemas al exportar, use el cliente CLI para probar el archivo de configuración .phrase.yml localmente y verificar si hay mensajes de error.
Si es necesario, contacte con Phrase Technical Support y adjunte el archivo de configuración .phrase.yml a la solicitud de soporte.
Las sincronizaciones de repositorios mantienen un historial de las últimas importaciones y exportaciones para cada proyecto Phrase Strings.
Para ver el historial: