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 requiere acceso de lectura ni escritura al repositorio.- Compatible con cualquier sistema de CI/CD, con configuraciones listas para usar incluidas.
- Acceso controlado mediante tokens de API específicos del 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 detrás de 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, por lo que las traducciones de diferentes funcionalidades no se sobrescriben entre sí.
Cuando utiliza las configuraciones de CI/CD listas para usar, este mapeo ya se procesa automáticamente.
2. Las traducciones se procesan de forma asíncrona
PTC no devuelve las traducciones inmediatamente. En su lugar:
- Sube los archivos actualizados
- Identifica solo las cadenas nuevas o modificadas
- Traduce las cadenas
- Prepara los archivos traducidos para su descarga
3. Un script de CLI funciona en todas partes
En lugar de llamar a la API por su cuenta, utilice la CLI de PTC:
Un único script se encarga de todo el flujo (subida → sondeo → descarga). La CLI se ejecuta en Linux y macOS, y funciona con GitHub Actions, GitLab, Bitbucket o cualquier otra plataforma de CI/CD.
Flujo de alto nivel: Configure la API de PTC en su pipeline de CI/CD
1Regístrese para una prueba.
Obtenga acceso completo a todas las características y traduzca hasta 20.000 palabras a dos idiomas de su elección.
2Cree un nuevo proyecto.
Al elegir cómo usar PTC, seleccione API integration. Durante la configuración, proporcionará un poco de contexto sobre su proyecto (qué hace, para quién es) 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 del proyecto. Cópielo y guárdelo de forma segura; lo necesitará para autenticar todas las solicitudes. Siempre puede volver a encontrar el mismo token 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 habilite 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.
En GitHub Actions, añada la acción PTC Translate a su flujo de trabajo. Su token de API es el único parámetro de entrada que debe pasar. La acción lleva una versión fija de la CLI en su interior, por lo que su compilación nunca descarga un script en tiempo de ejecución, y abre el pull request de traducción por usted.
En GitLab CI, Bitbucket Pipelines o cualquier otra plataforma, copie el trabajo para su plataforma desde las plantillas de CI/CD de la CLI de PTC. Cada plantilla fija la CLI a un lanzamiento específico y publica la suma de comprobación para verificarla, por lo que un lanzamiento posterior de la CLI no puede cambiar lo que ejecuta su compilación.
6Ejecute el flujo de trabajo.
Puede activar el flujo de trabajo manualmente, en 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 vuelve a escribir las traducciones actualizadas en su repositorio. Si utiliza las configuraciones listas para usar, el flujo de trabajo también creará un create a 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 mantienen sincronizadas automáticamente.
Ejemplos de CI/CD
WordPress
Ruby on Rails
Archivos JSON (aplicaciones React)Lecturas adicionales
- Parámetros de entrada de la acción PTC Translate
- Plantillas de CI/CD para GitHub y GitLab
- Archivo de configuración
- Flujo de trabajo de procesamiento
- Solución de problemas
¿Por qué usar PTC para traducciones de software?
PTC es un sistema de traducción completo para desarrolladores y equipos de producto, creado para mantener su código, su marca y su audiencia en sintonía.
Traducciones conscientes del contexto que protegen su marca
Antes de traducir, PTC aprende sobre su producto, su audiencia y su terminología. Por eso, el 99,5 % de las oraciones pasan a producción sin ediciones, y el 85 % de los proyectos no se editan en absoluto.
Cómo las traducciones con IA de PTC protegen su marca →
Amplia compatibilidad con plataformas y formatos de archivo
PTC funciona con los formatos de archivos de recursos y plataformas más populares, incluyendo: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify y WordPress.
Más 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 rápida función “Paste to translate” que le ofrece las mismas traducciones conscientes del contexto para el texto 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.