Localización en CI/CD: traduzca en cada commit

Añada la traducción a su pipeline de CI/CD con PTC: un token, un archivo de flujo de trabajo, y los archivos traducidos regresan como un pull request en GitHub, GitLab o Bitbucket.

En resumen: cuatro pasos

1. Cree un proyecto de PTC y elija la API integration. Usted describe el producto, elige los idiomas y obtiene un token de API del proyecto.
2. Añada el token a su repositorio como el secreto PTC_API_TOKEN.
3. Añada el flujo de trabajo ya preparado para su CI. Consulte los ejemplos para GitHub Actions y GitLab CI.
4. Haga push. PTC traduce solo las cadenas nuevas y modificadas, y los archivos traducidos regresan como un pull request.

La configuración completa se encuentra a continuación. Usted la configura una vez; después de eso, cada commit se traduce sin que nadie lo inicie.

Los archivos de origen cambian, PTC traduce automáticamente, los archivos traducidos regresan a su repositorio como un merge request, y AI Visual QA verifica la aplicación renderizada antes de que se publique el lanzamiento. Sin traslados de archivos entre equipos, sin traspasos a agencias entre lanzamientos.

El flujo de trabajo de localización que está ralentizando a su equipo

La mayoría de los equipos de ingeniería adoptan la localización de la misma manera. Se topan con los mismos tres problemas:

• Las traducciones rompen la interfaz. Las palabras en alemán son aproximadamente un 30 % más largas que en inglés. Usted solo descubre que sus botones se desbordan en producción.
• La localización es siempre el último paso. Usted exporta manualmente los archivos .json, .po o .strings. Las traducciones regresan tarde y retrasan su lanzamiento.
• Las traducciones no reflejan su marca. Las herramientas genéricas de traducción de software no conocen los nombres de sus funciones, su terminología técnica ni si su tono es formal o informal.

PTC reemplaza los tres con un flujo nativo de CI.

Lo que distingue a PTC en la localización de software

Cada elemento a continuación enlaza a la sección detallada más abajo en la página.

• PTC aprende el vocabulario y la voz de marca de su producto: traducciones a medida por proyecto, con precisión contextualizada en cada archivo de recursos.
• Revisión visual de la traducción de su software en ejecución: PTC revisa su aplicación renderizada para que publique sin control de calidad manual por idioma.
• Integración nativa de CI/CD con GitHub, GitLab y Bitbucket: un push que añade o cambia cadenas de origen regresa como un merge request.
• Glosario y memoria de traducción por proyecto: la terminología se mantiene coherente en cada archivo de recursos del proyecto y en cada lanzamiento.
• Todos los formatos de recursos comunes procesados de serie: JSON, YAML, PO, .strings, .xcstrings, .properties, XLIFF, CSV y más.

PTC aprende el vocabulario y la voz de marca de su producto

PTC no es una herramienta de traducción que ayuda a su equipo a traducir. PTC es el traductor. Aprende el vocabulario, el tono y las reglas de su producto a partir de las cadenas que usted sube, y los aplica de manera coherente en cada lanzamiento.

Creado para equipos de desarrollo, no añadido a posteriori

Una herramienta de traducción de software se gana su lugar cuando encaja en el flujo de trabajo existente, entiende los formatos de archivo técnicos y conserva los marcadores de posición y las variables. PTC está creado exactamente para esto: analiza sus archivos de recursos automáticamente, aprende la terminología de su producto y ofrece traducciones que respetan las restricciones de su interfaz, para que sus ingenieros mantengan su flujo de trabajo en lugar de adaptarse a una aplicación de traducción genérica.

• Voz de marca por proyecto. Defina el propósito y el público de su producto una sola vez. PTC utiliza este contexto para cada cadena, de modo que sus traducciones suenan como si hubieran sido escritas por su equipo. Esto se mantiene tanto si su producto es formal como informal, técnico o dirigido al consumidor.
• Glosario que se acumula. Añada términos específicos de la marca, nombres de funciones y reglas de «no traducir» una sola vez. «Cart = Carrito» para español. PTC los aplica en cada archivo, en cada idioma y en cada futura actualización.
• Traducciones que encajan en su interfaz. PTC utiliza valores predeterminados de longitud inteligentes para cada idioma de destino y señala los desbordamientos mientras usted traduce, no después de compilar.
• Marcadores de posición, procesados correctamente. PTC reconoce marcadores de posición como %s, {{name}}, {0}, %1$s en todos los formatos de recursos compatibles. Las variables se conservan para que usted nunca publique una cadena rota.
• Memoria de traducción entre actualizaciones. Cuando usted cambia una palabra en un párrafo, PTC vuelve a traducir solo lo que cambió y conserva el resto.
• Sin adivinanzas. Si una cadena es ambigua (¿es «Submit» un verbo o un sustantivo?), PTC se detiene y pregunta en lugar de elegir un significado incorrecto.

Revisión visual de la traducción de su software en ejecución: publique sin control de calidad manual por idioma

La traducción es necesaria pero no suficiente para publicar software multilingüe. Una cadena traducida puede hacer que publique un producto defectuoso. Una etiqueta en alemán que desborda un botón. Una palabra en francés con la categoría gramatical incorrecta. Una cadena en inglés que alguien olvidó envolver en el helper de i18n. Detectar esto tradicionalmente significa una pasada de control de calidad manual de varios días por idioma en cada lanzamiento. Esa es la etapa más cara y lenta de la localización, y la razón por la que muchos equipos se limitan a dos o tres idiomas.

AI Visual QA de PTC reemplaza esa pasada con automatización nativa de CI. Dos variantes cubren todo tipo de software:

• Extensión de navegador (para software basado en navegador como SaaS, interfaces de administración web, aplicaciones de escritorio basadas en web). Instale la extensión de navegador de PTC y grabe un recorrido de los flujos de usuario críticos de su aplicación una sola vez. A partir de entonces, PTC vuelve a ejecutar la grabación después de cada lanzamiento, captura cada pantalla en cada idioma e inspecciona el resultado renderizado.
• Subida de capturas de pantalla (para aplicaciones de escritorio nativas, herramientas de CLI de servidor o cualquier software que no sea de navegador). Suba una captura de pantalla por idioma por pantalla. La IA de visión de PTC inspecciona el resultado renderizado de la misma manera.

Los problemas que PTC puede solucionar en los archivos de recursos (ambigüedad entre verbo y sustantivo, desbordamiento del diseño, desajustes de plurales) se solucionan automáticamente. Los problemas que residen en su código fuente (falta de envolturas, cadenas incrustadas en el código, concatenación de oraciones) regresan como prompts listos para pegar para Cursor o Claude Code.

El entregable pasa de ser «archivos de recursos traducidos» a «software multilingüe listo para su lanzamiento». Ninguna otra plataforma de localización ofrece esto en la actualidad.

Integración nativa de CI/CD con GitHub, GitLab y Bitbucket

Haga un commit de un .ptc-config.yml que nombre los archivos que contienen sus cadenas de origen y a dónde pertenecen las traducciones:

# .ptc-config.yml
source_locale: en
files:
  - file: src/locales/en.json
    output: src/locales/{{lang}}.json
  - file: app/src/main/res/values/strings.xml
    output: app/src/main/res/values-{{lang}}/strings.xml

A continuación, añada la acción PTC Translate a su flujo de trabajo. Lleva una versión fijada de la CLI de PTC en su interior, por lo que su compilación no descarga nada en tiempo de ejecución:

# .github/workflows/translate.yml
name: Translate
on:
  push:
    branches: [main]
    paths:
      - 'src/locales/en.json'
      - 'app/src/main/res/values/strings.xml'
  workflow_dispatch: {}

jobs:
  translate:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: OnTheGoSystems/ptc-action@v1
        with:
          api-token: ${{ secrets.PTC_API_TOKEN }}
          create-pr: true

PTC sincroniza las nuevas cadenas de origen, las traduce a sus idiomas de destino y abre un pull request con los es.json, de.json, values-es/strings.xml actualizados, y así sucesivamente. Su equipo lo revisa como cualquier otro cambio de código. Un push que deja sus cadenas de origen sin cambios no traduce nada y no abre nada.

Para GitLab CI, Bitbucket Pipelines, CircleCI o cualquier otro sistema de CI, el mismo flujo funciona a través de REST. Consulte la referencia de la API de PTC para ver la API completa de sincronización y webhooks.

Para los equipos que publican múltiples lanzamientos por semana, PTC escala sin esfuerzo de coordinación adicional por lanzamiento. PTC solo vuelve a traducir las cadenas que realmente cambiaron. Una actualización de 10 cadenas no vuelve a traducir las otras 10.000. PTC funciona las 24 horas del día, los 7 días de la semana. Usted nunca espera a la estimación de entrega de la próxima semana de una agencia.

La localización se ejecuta junto a su código, no después de él

La localización continua significa que la traducción vive dentro de su ciclo de vida de desarrollo en lugar de convertirse en una etapa separada al final. PTC ofrece esto al conectarse a su repositorio Git o pipeline de CI/CD. Cuando usted hace push de nuevo código, PTC detecta las nuevas cadenas, aplica el contexto y el glosario de su producto, las traduce y las devuelve como un merge request, para que la localización siga el ritmo de cada commit en lugar de bloquear el próximo lanzamiento.

Cómo funciona la integración de CI/CD

Antes de configurar PTC con su sistema de CI, aquí están 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 usted envía a PTC está vinculado a un nombre de rama (por ejemplo, main, feature/new-checkout). Esto mantiene las traducciones separadas, para que las traducciones de diferentes funciones no se sobrescriban entre sí. Cuando usted utiliza las configuraciones de CI/CD ya preparadas, esta asignación 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 usted mismo, utilice la CLI de PTC:

Un script procesa 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 funciones y traduzca hasta 20.000 palabras a los dos idiomas que usted elija.

2Cree un nuevo proyecto.

Al elegir cómo usar PTC, seleccione la API integration. Durante la configuración, usted 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, usted 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 Configuración → Tokens de API de PTC.

4Añada el token de API de PTC a su repositorio en la ubicación correcta.

5Copie la configuración de CI/CD ya preparada.

En GitHub Actions, añada la acción PTC Translate a su flujo de trabajo. Su token de API es la única entrada que usted 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 cuando una ejecución produce nuevas traducciones, abre el pull request 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, de modo que un lanzamiento posterior de la CLI no pueda cambiar lo que ejecuta su compilación.

6Ejecute el flujo de trabajo.

Usted puede desencadenar el flujo de trabajo manualmente, en commits que actualizan archivos de recursos, o de forma programada. Consulte los desencadenadores para GitHub, GitLab y Bitbucket. Un pull request necesita una rama sobre la cual abrirse, por lo que en GitHub Actions la acción PTC Translate abre uno en un push, de forma programada y en una ejecución manual desde una rama. En un evento pull_request, pull_request_target o merge_group, o en una etiqueta o un lanzamiento, se detiene con una explicación en su lugar: traduzca en un push a su rama de origen, o configure create-pr: false para esa ejecución.

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 usted está utilizando las configuraciones ya preparadas y la ejecución produjo nuevas traducciones, el flujo de trabajo también create a merge request con los cambios, para que pueda revisarlos y fusionarlos como cualquier otra actualización de código. Una ejecución que no encuentra nada que traducir no escribe nada y no abre ningún merge request. A partir de aquí, sus traducciones se mantienen sincronizadas automáticamente.

Ejemplos de CI/CD

WordPress

• GitHub Actions
• GitLab CI

Ruby on Rails

• GitHub Actions

Archivos JSON (aplicaciones React)

• GitHub Actions
• GitLab CI

Glosario y memoria de traducción por proyecto

Añada una entrada de glosario una sola vez. Por ejemplo: «Cart = Carrito» para español. PTC aplica la entrada en cada archivo del mismo proyecto, ahora y en cada futura actualización. Usted nunca vuelve a subir archivos TMX entre ejecuciones.

Usted puede gestionar las entradas del glosario de dos maneras. El panel de control de PTC proporciona un editor para entradas ad hoc. La API REST de PTC admite la importación y exportación de glosarios para los equipos que mantienen la terminología en un sistema separado.

Edite o vuelva a traducir cualquier cadena después de que se genere

PTC nunca bloquea una traducción. Usted puede revisar, editar o pedir a PTC que vuelva a traducir cualquier cadena desde la pestaña Translations en cualquier momento, para que su equipo tenga la última palabra sobre cada palabra que se publica.

PTC procesa todos los formatos de recursos comunes de serie

PTC procesa los formatos que su stack utiliza realmente. Los formatos nombrados a continuación enlazan a sus páginas de traducción dedicadas:

• Web: JSON (i18next, react-intl, vue-i18n, next-intl), YAML (Rails), PO/POT (Django, WordPress).
• iOS: .strings, .stringsdict, .xcstrings (String Catalogs).
• Android: strings.xml, plurales, arrays de cadenas.
• Escritorio / multiplataforma: .properties (Java), .po (gettext).
• Datos / catálogos: CSV, XLIFF.

La localización de software no empieza ni termina en la interfaz de usuario. PTC también traduce notas de lanzamiento, notificaciones por correo electrónico, documentación de ayuda, materiales de marketing, comentarios de los usuarios e informes de errores. Todo en el mismo proyecto, para que la terminología se mantenga coherente en todo lo que tocan sus usuarios.

Consulte la matriz completa de compatibilidad de formatos e idiomas para ver la lista completa.

Publique en más de 40 idiomas, desde árabe hasta japonés

PTC traduce a más de 40 idiomas, incluyendo árabe, chino, francés, alemán, japonés, coreano, portugués, español y más, para que usted pueda llegar a nuevos mercados sin añadir una nueva herramienta para cada uno. Consulte la lista completa de idiomas admitidos para confirmar que sus idiomas de destino están cubiertos.

Traduzca notas de lanzamiento multiplataforma, correos electrónicos de clientes y documentos de soporte

Las notas de lanzamiento multiplataforma, los correos electrónicos dirigidos a los clientes, la documentación de soporte y el texto del sitio de marketing viven fuera de sus archivos de recursos. El Paste to Translate de PTC procesa ese texto en el mismo proyecto. Pegue el texto de origen, elija los idiomas de destino y obtenga traducciones que utilizan el mismo glosario y voz de marca que sus cadenas dentro de la aplicación.

Traduzca contenido generado por el usuario, tickets de soporte y datos dinámicos con la API de PTC

El contenido generado por el usuario, los tickets de soporte y los datos dinámicos que su software procesa en tiempo de ejecución necesitan traducción a medida que llegan. La API REST de PTC traduce este contenido bajo demanda con autenticación Bearer, utilizando el mismo glosario y voz de marca que las traducciones de sus archivos de recursos.

Precios: prueba de 30 días, luego pago al consumo

La prueba cubre 20.000 palabras en 2 idiomas sin tarjeta de crédito. Cuando termina la prueba, PTC ofrece pago al consumo. Sin suscripción. Sin compromiso mínimo. Las primeras 500 palabras de cada mes son gratuitas. Usted solo paga por el resto. La página de precios tiene una calculadora de costes. Regístrese con un correo electrónico de empresa para obtener una prueba empresarial ampliada.

PTC cuenta con certificación ISO 27001 para uso empresarial

PTC cuenta con la certificación ISO 27001, lo que significa que sus datos y los de sus usuarios se procesan conforme a estándares de seguridad reconocidos internacionalmente. PTC admite la localización continua para equipos de ingeniería de cualquier tamaño, desde una startup de 3 desarrolladores hasta una empresa que publica semanalmente en 12 idiomas.

Siga un camino comprobado desde la primera cadena hasta el lanzamiento publicado

Empezar es sencillo cuando se tiene un mapa. Nuestra guía de localización de software le guía a través de todo, desde la preparación de sus cadenas para la traducción hasta la gestión de actualizaciones a medida que su producto crece, para que usted adopte PTC con un plan claro en lugar de ensayo y error. Lea la guía de localización de software para configurar su primer proyecto.

¿Listo para publicar software multilingüe verificado?

Conecte su repositorio de GitHub o GitLab. PTC traduce sus archivos de recursos a más de 40 idiomas y revisa la aplicación en ejecución en cada uno de ellos en cada lanzamiento. Usted publica con confianza.

Comience su prueba de 30 días: 20.000 palabras por nuestra cuenta, no requiere tarjeta de crédito.

Para los desarrolladores listos para profundizar:

• Lea la referencia de la API de PTC: endpoints REST, webhooks, integración de CI.
• Consulte la compatibilidad de idiomas y formatos de archivo.
• Hable con nosotros sobre planes empresariales: SLA personalizados, opciones on-premise, soporte dedicado.

Última actualización: 11 de noviembre de 2026