gt-next & gt-react

Descripción general

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

Nota: Esto solo debe usarse cuando estés publicando una versió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

Ejecuta gtx-cli translate

Consejo: Evita la molestia de usar archivos de traducción con el componente <T>.

Paso 1: Agrega tus variables de entorno

Agrega tu clave API de producción y el ID de tu proyecto a tus variables de entorno. Esto es necesario para usar la herramienta gtx-cli. Obtienes estos datos desde el panel de control de General Translation.

.env

GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>

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: Agrega el comando `gtx-cli translate` a tu proceso de compilación

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

package.json

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <your build command>"
  }
}

Esto generará traducciones para todos tus locales y las guardará en tu proyecto. Si deseas agregar estos archivos a tu repositorio, puedes ejecutar este comando antes de hacer commit.

¡Listo! Ahora tu proyecto actualizará automáticamente todos tus archivos 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 deseas confirmar tus archivos de traducción, puedes ejecutar el comando gtx-cli translate antes de hacer el commit.
Para configurar la ruta de salida de tus traducciones, consulta la documentación de configuración.

Próximos pasos

Consulta la guía de uso para la herramienta cli.
Si quieres ver traducciones en tiempo real durante el desarrollo (como recarga en caliente), revisa el componente <T>.