Bibliotecas GT

Traduce automáticamente tu proyecto con las Bibliotecas GT

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 implementando una versión de producción. Si estás usando las Bibliotecas GT en desarrollo, este comando no es necesario.

Seguiremos estos 4 pasos:

Añade tus variables de entorno

Instala gtx-cli

Inicializa tu proyecto con el comando gtx-cli init

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


Paso 1: Añade tus variables de entorno

Añade tu clave API de producción y el ID del proyecto a tus variables de entorno. Esto es necesario para usar la herramienta gtx-cli. Puedes obtener 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: Instala gtx-cli

Instala la herramienta gtx-cli en tu proyecto.

npm i --save-dev gtx-cli

Paso 3: Inicializa tu proyecto con el comando gtx-cli init

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

npx gtx-cli init

Paso 4: 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 agregar automáticamente 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 idiomas y las guardará en tu proyecto. Si quieres confirmar estos archivos en tu repositorio, puedes ejecutar este comando antes de hacer commit.

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


Notas

  • Puedes añadir traducciones automáticamente a tu proyecto con el comando gtx-cli translate.
  • Si quieres confirmar tus archivos de traducción, puedes ejecutar el comando gtx-cli translate antes de hacer commit.
  • Para configurar la ruta de salida de tus traducciones, consulta la documentación de configuración.

Siguientes pasos

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

En esta página