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 del plan 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 comenzar:
- 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 utilizar 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 dependen 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 su 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. Dele 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. Dele 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 al 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, el cual GitLab reserva para el Mantenedor, mientras que la configuración manual solo lee el repositorio y hace push a una rama, por lo que Desarrollador es suficiente.
Guarde el token de forma segura y añádalo a PTC. Este 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 su traducción y no realiza cambios en ninguna otra parte de su repositorio.
Los webhooks mantienen las traducciones sincronizadas automáticamente
A través de los webhooks, PTC recibe notificaciones cuando usted hace push de los cambios a su repositorio, de modo que puede volver a traducir las cadenas afectadas automáticamente. Sin acceso a los 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. Una vez que 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 hacerlo, vaya a la pestaña Translations. Desde aquí, puede revisar el texto traducido que exceda 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 a su repositorio.
Dé a PTC acceso a los nuevos archivos de recursos a medida que los añade
Si añade nuevos archivos de recursos a su repositorio después de la integración inicial, puede pedir 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 para su traducción, luego haga clic en Save with translation para confirmar.
Para omitir la revisión manual por completo, seleccione 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 e Idiomas.
Por qué localizar proyectos de GitLab con PTC
Traducción automática 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.
Mejor precisión de traducción
PTC elimina el riesgo de errores humanos, como claves mal ubicadas o traducciones obsoletas. Obtendrá traducciones muy precisas y acordes a la marca.
La localización sigue el ritmo del desarrollo de software y aplicaciones móviles
PTC está diseñado para equipos de software que crean productos y aplicaciones móviles y que desean que la localización siga el ritmo del desarrollo. Una vez que conecta su repositorio de GitLab, PTC detecta automáticamente las cadenas nuevas y actualizadas, y devuelve las traducciones a través de un merge request, sin necesidad de intervención manual.
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 precio de pago al consumo: solo se le cobra por las palabras que traduce, y las primeras 500 palabras de cada mes son gratuitas. Puede 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 automática y funciones para cada plataforma.