Integre la localización en su pipeline de CI/CD con la API de PTC
Aprenda a integrar la API de PTC en su pipeline de CI/CD para ofrecer traducciones con IA de calidad humana como parte de su proceso de compilación.
Seguro por diseño: no se requiere acceso de lectura o escritura al repositorio.- Compatible con cualquier sistema de CI/CD, con configuraciones listas para usar incluidas.
- Acceso controlado mediante tokens de API específicos para cada proyecto.
- Traducciones de calidad humana entregadas en minutos, directamente en su compilación.
Cómo funciona la integración de CI/CD
Antes de configurar PTC con su sistema de CI, estos son los tres principios en los que se basan la API y la CLI de PTC:
1. Los archivos de recursos están vinculados a una rama
Cada archivo que envía a PTC está vinculado al nombre de una rama (por ejemplo, main, feature/new-checkout). Esto mantiene las traducciones separadas, de modo que el trabajo de diferentes funcionalidades no se sobrescriba entre sí.
Al utilizar las configuraciones de CI/CD listas para usar, este mapeo ya se gestiona automáticamente.
2. Las traducciones se procesan de forma asíncrona
PTC no devuelve las traducciones de inmediato. En su lugar:
- Subir los archivos actualizados
- Identificar solo las cadenas nuevas o modificadas
- Traducir las cadenas
- Preparar los archivos traducidos para su descarga
3. Un único script de CLI funciona en cualquier lugar
En lugar de llamar a la API usted mismo, utilice la CLI de PTC:
Un solo script gestiona todo el flujo (subida → sondeo → descarga). La CLI está alojada en GitHub pero funciona en Linux, macOS, GitHub Actions, GitLab, Bitbucket o cualquier otra plataforma de CI/CD.
Flujo general: configure la API de PTC en su pipeline de CI/CD
1Regístrese para una prueba gratuita.
Obtenga acceso completo a todas las funciones y traduzca hasta 20.000 palabras a los dos idiomas que elija.
2Cree un nuevo proyecto.
Al elegir cómo usar PTC, seleccione integración por API. Durante la configuración, proporcionará un poco de contexto sobre su proyecto (qué hace, a quién va dirigido) y seleccionará los idiomas a los que desea traducir.
3Obtenga su token de API.
Al final de la configuración, recibirá un token de API específico para el proyecto. Cópielo y guárdelo de forma segura; lo necesitará para autenticar todas las solicitudes. Siempre podrá encontrar el mismo token de nuevo en el panel de control de su proyecto, en Settings → PTC API tokens.
4Añada el token de API de PTC a su repositorio en la ubicación correcta.
| Proveedor | Dónde añadir el token |
|---|---|
| GitHub Actions | Vaya a Settings → Secrets and variables → Actions y añada PTC_API_TOKEN. Luego vaya a Settings → Actions → General y active Workflow permissions para que el flujo de trabajo pueda crear pull requests. |
| GitLab CI/CD | Vaya a Settings → CI/CD → Variables y añada PTC_API_TOKEN. |
| Bitbucket Pipelines | Vaya a Repository settings → Pipelines → Repository variables y añada PTC_API_TOKEN. |
5Copie la configuración de CI/CD lista para usar.
Puede obtener la configuración de CI/CD lista para usar para su plataforma en la wiki de la CLI de PTC. Estas plantillas ya incluyen los pasos para descargar y ejecutar la CLI.
6Ejecute el flujo de trabajo.
Puede activar el flujo de trabajo manualmente, tras commits que actualicen archivos de recursos o de forma programada. Consulte los activadores para GitHub, GitLab y Bitbucket.
Cuando se ejecuta, la CLI sube sus archivos, espera a que terminen las traducciones y escribe las traducciones actualizadas de nuevo en su repositorio. Si utiliza las configuraciones listas para usar, el flujo de trabajo también creará un pull/merge request con los cambios, para que pueda revisarlos y fusionarlos como cualquier otra actualización de código. A partir de aquí, sus traducciones se mantendrán sincronizadas automáticamente.
Ejemplos de CI/CD
WordPress
Ruby on Rails
Archivos JSON (aplicaciones React)Lecturas adicionales
¿Por qué usar PTC para traducciones de software?
PTC es un sistema de traducción completo para desarrolladores y equipos de producto, diseñado para mantener sincronizados su código, su marca y su audiencia.
Traducciones conscientes del contexto que protegen su voz de marca
Antes de traducir, PTC aprende sobre su producto, su audiencia y su terminología. Por eso, el 99,5 % de las frases se publican sin ediciones y el 85 % de los proyectos no reciben ninguna edición.
Cómo las traducciones con IA de PTC protegen su voz de marca →
Amplia compatibilidad con plataformas y formatos de archivo
PTC funciona con las plataformas y los formatos de archivos de recursos más populares, incluyendo: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify y WordPress.
Más información sobre los formatos de archivo compatibles →
Traduzca más que archivos de recursos
¿Necesita traducir notas de lanzamiento, correos electrónicos o documentación? PTC también incluye una función rápida de «Pegar para traducir» que le ofrece las mismas traducciones conscientes del contexto para textos fuera del código.
Cómo traducir texto fuera de los archivos de recursos →
Automatice las traducciones en su CI/CD
Configure PTC una vez y sus archivos de recursos y traducciones se mantendrán actualizados automáticamente en su pipeline de CI/CD.