Integración de GitLab con PTC
Conecte GitLab con PTC para obtener una localización continua. Reciba las traducciones mediante merge requests automáticos siempre que su código cambie.
Cómo integrar GitLab con PTC
PTC se conecta a su repositorio de GitLab y mantiene sus archivos de recursos traducidos mientras trabaja. Haga push de los cambios en su código y PTC los detectará automáticamente, traducirá las cadenas actualizadas y abrirá un merge request.
La integración con GitLab es una función Pro. Estará disponible cuando active el pago al consumo.
Conecte su repositorio de GitLab
PTC es compatible tanto con GitLab.com como con repositorios de GitLab autoalojados. Dependiendo de en qué punto de su flujo de trabajo se encuentre, hay dos formas de empezar:
- Al crear un nuevo proyecto en PTC, seleccione Integración con Git en el asistente de configuración.
- Para cambiar un proyecto existente de subidas manuales de archivos a un flujo de trabajo continuo basado en Git, vaya a Configuración → Merge Requests y haga clic en Add Git Integration.
En ambos casos, verá una pantalla donde podrá introducir la URL de su proyecto dentro del repositorio. PTC detectará automáticamente que está utilizando GitLab.
Autentíquese con GitLab
Para conectar su repositorio, puede usar un token de acceso (recomendado) o iniciar sesión con OAuth. PTC admite tanto tokens de acceso de proyecto como tokens de acceso de grupo.
PTC requiere acceso a webhooks para detectar cambios en su repositorio. Al utilizar un token de acceso, el rol y los scopes que necesita dependerán de cómo desee configurar el webhook:
| Configuración automática del webhook | Configuración manual del webhook | |
|---|---|---|
| Cómo funciona | PTC crea y configura el webhook en GitLab en su nombre durante el proceso de integración. | PTC le proporciona una URL de callback y un token secreto. Usted crea un webhook en la configuración de GitLab utilizando estos detalles, con eventos Push y eventos de Merge Request como activadores. |
| Creación del token | Vaya a Configuración → Tokens de acceso, ya sea en su proyecto o en su grupo. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad). | Vaya a Configuración → Tokens de acceso, ya sea en su proyecto o en su grupo. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad). |
| Rol requerido | Mantenedor | Desarrollador (o equivalente) |
| Scopes | api → Permite a PTC leer y hacer push en el repositorio |
read_repository + write_repository |
Tanto un token de proyecto como un token de grupo funcionan en cualquiera de las columnas: PTC lee el nivel de acceso que sea más alto. Lo que separa a las dos columnas es el rol, y se deriva de lo que hace cada configuración: la configuración automática gestiona un webhook de proyecto por usted, algo que GitLab reserva para el rol de Mantenedor, mientras que la configuración manual solo lee el repositorio y hace push de una rama, por lo que el rol de Desarrollador es suficiente.
Guarde el token de forma segura y añádalo a PTC. Verificará sus permisos y le permitirá elegir qué ramas y archivos de recursos monitorizar.
El acceso se mantiene limitado a los archivos que PTC traduce
PTC utiliza el acceso de lectura para detectar cambios en sus archivos de recursos y el acceso de escritura para entregar las traducciones mediante merge requests. PTC solo interactúa con los archivos que gestiona para la traducción y no realiza cambios en ninguna otra parte de su repositorio.
Los webhooks mantienen las traducciones sincronizadas automáticamente
Los webhooks son la forma en que PTC recibe notificaciones cuando hace push de los cambios en su repositorio, para que pueda volver a traducir las cadenas afectadas automáticamente. Sin acceso a webhooks, PTC no puede monitorizar sus ramas en busca de actualizaciones.
Traduzca su proyecto con PTC
Una vez que su repositorio de GitLab esté conectado, continúe con los pasos de configuración para proporcionar algo de contexto sobre su aplicación o software y elegir sus idiomas de destino.
A continuación, PTC traducirá los archivos de recursos en su rama de GitLab conectada. Si su repositorio ya contiene archivos de traducción, PTC puede detectarlos y reutilizarlos.
Revise el Merge Request con las traducciones
PTC traduce en minutos y envía un merge request con las traducciones directamente a su repositorio de GitLab. Cuando esté listo, simplemente fusiónelo; no se necesita ninguna otra acción.
A partir de ese momento, a medida que haga push de los cambios en su código, PTC los detectará y enviará nuevos merge requests con las traducciones actualizadas, manteniendo su software completamente localizado a lo largo del tiempo.
Genere nuevos Merge Requests manualmente
Además de las actualizaciones automáticas, puede generar un nuevo merge request en cualquier momento para sincronizar las traducciones que haya editado o vuelto a traducir.
Para ello, vaya a la pestaña Translations. Desde aquí, puede revisar el texto traducido que supera el límite de longitud y editarlo manualmente o dejar que PTC genere una versión más corta. Una vez que haya terminado, haga clic en Generate MR para hacer push de las traducciones actualizadas en su repositorio.
Dé acceso a PTC a los nuevos archivos de recursos a medida que los añada
Si añade nuevos archivos de recursos a su repositorio después de la integración inicial, puede pedirle a PTC que los busque.
- Vaya a Configuración → Archivos monitorizados y haga clic en Rescan your repository. PTC escaneará su repositorio y mostrará cualquier archivo recién descubierto como borrador.
- Haga clic en el icono + junto a un archivo para incluirlo en la traducción y, a continuación, haga clic en Save with translation para confirmar.
Para omitir por completo la revisión manual, marque la casilla Automatically include new translation files. A partir de ese momento, PTC recogerá y monitorizará automáticamente cualquier archivo de recursos nuevo que encuentre, sin necesidad de que usted lo confirme.
Para ajustar otras configuraciones, como las ramas monitorizadas y los idiomas, navegue por las pestañas Branch Management, Archivos monitorizados y Idiomas.
Por qué localizar proyectos de GitLab con PTC
Traducción automatizada de archivos
PTC detecta y traduce automáticamente sus archivos de recursos, entregando las traducciones mediante merge requests. Usted mantiene el control utilizando el flujo de trabajo de GitLab que ya conoce y en el que confía, y sin necesidad de crear ningún script.
Menos trabajo manual
PTC ahorra tiempo de desarrollo y acelera los lanzamientos al monitorizar su repositorio y actualizar los archivos de traducción a medida que hace push de los cambios.
Mayor precisión de traducción
PTC elimina el riesgo de errores humanos, como claves mal colocadas o traducciones desactualizadas. Obtendrá traducciones muy precisas y fieles a la marca.
La localización sigue el ritmo del desarrollo de software y aplicaciones móviles
PTC está diseñado para equipos que crean productos de software y aplicaciones móviles y que desean que la localización siga el ritmo del desarrollo. Una vez que conecte su repositorio de GitLab, PTC detectará automáticamente las cadenas nuevas y actualizadas y entregará las traducciones mediante un merge request, sin necesidad de traspasos manuales.
Los formatos comunes en proyectos de software y móviles, como los archivos PO y los archivos JSON, son totalmente compatibles. Para obtener más información sobre cómo encaja PTC en estos flujos de trabajo, consulte nuestras páginas de localización de software y localización de aplicaciones móviles.
Conecte GitLab sin coste adicional
No hay ningún cargo adicional por conectar GitLab. En lugar de un modelo de suscripción, PTC utiliza un sencillo modelo de precios de pago al consumo: solo se le cobra por las palabras que traduce, y las primeras 500 palabras de cada mes son gratuitas. Encontrará todos los detalles en la página de precios de PTC.
También funciona con GitHub y Bitbucket
Además de GitLab, PTC se integra con GitHub y Bitbucket, ofreciendo los mismos flujos de trabajo de localización automatizados y las mismas funciones para cada plataforma.