Traducción automática

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

npx gtx-cli@latest

Descripción general

La CLI de General Translation (gtx-cli) te permite traducir automáticamente tu proyecto a cualquiera de los idiomas admitidos.

Ofrece compatibilidad de primer nivel con gt-next y gt-react, permitiéndote analizar tu proyecto para detectar 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 de 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. ¡Obtén una gratis en generaltranslation.com!


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

  • El comando init se utiliza para configurar tu proyecto. Proporciona un asistente paso a paso que preparará 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 locales y de la estructura de archivos de tu proyecto
  • El comando translate está pensado para añadirse a tu pipeline de CI/CD. Se utiliza para analizar tu proyecto en busca de contenido que deba traducirse. Luego, el contenido se sube a un CDN (Red de distribución de contenido) o se incluye en el bundle de tu aplicación para usarse en tiempo de ejecución.

Introducción

Según la biblioteca de i18n que use tu proyecto, sigue uno de estos 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 ha parecido esta guía?

Traducción automática