gt-react, gt-next

Traduce automáticamente tu proyecto con gt-next o gt-react

Descripción general

Este tutorial te mostrará cómo administrar automáticamente los archivos de traducción de tu proyecto cuando uses gt-next o gt-react.

Nota: Esto solo debe usarse cuando vayas a publicar una compilación de producción. Si estás usando gt-next o gt-react en desarrollo, este comando no es necesario.

Seguiremos estos 4 pasos:

Agrega tus variables de entorno

Configura tu proyecto con el comando npx gtx-cli configure


Paso 1: Añade tus variables de entorno

Añade tu clave de API de producción y el id de tu proyecto a tus variables de entorno. Esto es necesario para usar la herramienta gtx-cli. Puedes obtenerlas desde el dashboard de General Translation.

.env
GT_API_KEY=<tu-clave-de-API>
GT_PROJECT_ID=<tu-id-de-proyecto>

Paso 2: Configura tu proyecto con el comando npx gtx-cli configure

Ejecuta el comando gtx-cli configure para configurar tu proyecto.

npx gtx-cli configure

Paso 3: Añade el comando gtx-cli translate a tu proceso de compilación

Añade el comando gtx-cli translate a tu proceso de compilación o CI antes del comando de compilación para incorporar automáticamente las traducciones a tu proyecto.

package.json
{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <tu comando de compilación>"
  }
}

Esto generará traducciones para todas tus locales y las guardará en tu proyecto. Si quieres subir estos files a tu repositorio, puedes ejecutar este comando antes de hacer el commit.

¡Listo! Ahora tu proyecto actualizará automáticamente todos tus files JSON de traducción cada vez que tu proyecto cambie.


Notas

  • Puedes agregar traducciones automáticamente a tu proyecto con el comando gtx-cli translate.
  • Si quieres confirmar (commit) tus files de traducción, en su lugar puedes ejecutar el comando gtx-cli translate antes de confirmar.
  • Para configurar la ruta de salida de tus traducciones, consulta la documentación de configuración.

Próximos pasos

¿Qué te parece esta guía?