Traducción Automática

Cómo traducir automáticamente tu proyecto usando la herramienta CLI de General Translation

npx gtx-cli@latest

Descripción general

La herramienta de línea de comandos de General Translation (gtx-cli) te permite traducir automáticamente tu proyecto a cualquiera de los idiomas compatibles.

Ofrece compatibilidad de primer nivel con gt-next y gt-react en tu proyecto, lo que te permite analizar tu proyecto en busca de contenido traducible, traducirlo y generar archivos JSON con los datos de traducción.

La herramienta de CLI también puede usarse para generar traducciones para bibliotecas i18n de terceros como next-intl o i18next.

Por último, la herramienta de CLI puede usarse para traducir archivos JSON, Markdown, MDX, JS y TS.

Se requiere una clave de API de producción para el comando translate. ¡Consigue una gratis en generaltranslation.com!


Hay dos comandos principales que debes conocer: init y translate.

  • El comando init se utiliza para configurar tu proyecto. Ofrece un asistente paso a paso que configurará tu proyecto para la internacionalización, incluyendo:
  • Configuración de plugins y proveedores de React
  • Generación de claves de API
  • Configuración de los idiomas y la estructura de archivos de tu proyecto
  • El comando translate está pensado para añadirse a tu canalización de CI/CD. Se utiliza para analizar tu proyecto en busca de contenido que deba traducirse. Luego, el contenido se carga en una CDN o se incorpora al paquete de tu aplicación para usarse en tiempo de ejecución.

Primeros pasos

Según la biblioteca de i18n que utilice tu proyecto, sigue uno de los siguientes tutoriales:

Uso

ComandoDescripción
npx gtx-cli initEjecuta el asistente de configuración de GT.
npx gtx-cli configureConfigura los ajustes de GT de tu proyecto.
npx gtx-cli translateTraduce tu proyecto mediante la API de GT.
npx gtx-cli authGenera una clave de API y un ID de proyecto para tu proyecto.
npx gtx-cli generateGenera un nuevo archivo JSON de datos de traducción. Debe usarse cuando se utilice la biblioteca de forma independiente.

¿Qué te parece esta guía?