Integración de GitLab con PTC
Conecte GitLab con PTC para disfrutar de una localización continua. Reciba 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 pasar un proyecto existente de la subida manual 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 es compatible tanto con tokens de acceso de proyecto como con tokens de acceso de grupo.
PTC requiere acceso a webhooks para detectar cambios en su repositorio. Si utiliza 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. Deberá crear un webhook en la configuración de GitLab utilizando estos datos, con Push events y eventos de merge request como activadores. |
| Creación del token | En su proyecto, vaya a Configuración → Tokens de acceso. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad). | En su grupo, vaya a Configuración → Tokens de acceso. Asigne un nombre al token, una descripción opcional y establezca una fecha de caducidad (recomendado por seguridad). |
| Rol necesario | Mantenedor | Desarrollador (o equivalente) |
| Scopes | api → Permite a PTC leer y hacer push en el repositorio |
read_repository + write_repository |
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 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
Los webhooks son la forma en que PTC recibe notificaciones cuando usted hace push de los cambios en su repositorio, para poder 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 conectado su repositorio de GitLab, 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.
Generar 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 supere 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é 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 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á los archivos recién descubiertos como borradores.
- Haga clic en el icono + junto a un archivo para incluirlo para su traducción, y luego haga clic en Save with translation para confirmar.
Para omitir la revisión manual por completo, 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 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.
Mayor precisión en las traducciones
PTC elimina el riesgo de errores humanos, como claves mal ubicadas 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 a través de 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 sobre 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 sistema 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. Tiene 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 automatizada y funciones para cada plataforma.