Traducción automática

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

npx gtx-cli@latest

Descripción general

La herramienta de línea de comandos (CLI) 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, permitiéndote escanearlo para encontrar contenido traducible, traducir tu proyecto y generar archivos de datos de traducción en JSON.

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

Por último, la herramienta 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 configurará tu proyecto para la internacionalización, incluyendo:
  • Configurar plugins y proveedores de React
    • Generar claves de API
    • Configurar los locales 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 escanear tu proyecto en busca de contenido que deba traducirse. Luego, el contenido se sube a una red de entrega de contenido (CDN) o se agrega al bundle 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 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 parece esta guía?