Traducir tu app de Next.js al francés 🇫🇷, español 🇪🇸, japonés 🇯🇵 o a cualquier otro idioma es tedioso y consume mucho tiempo.

Locadex es un agente de IA creado para encargarse del 100% del trabajo de internacionalización (i18n) por ti. La instalación lleva 5 minutos.

Locadex:

• Configura tu proyecto para usar la biblioteca i18n gt-next
• Modifica tus componentes de React y tus cadenas para admitir contenido multilingüe
• Traduce tu app a tantos idiomas como necesites
• Internacionaliza y traduce de forma continua a medida que incorporas contenido nuevo

Proceso de configuración

Paso 1: Inicia sesión en el Dashboard de General Translation

Ve a tu Dashboard e inicia sesión en tu cuenta.

Paso 2: Conectar GitHub

1. Ve a la sección de integración de GitHub en tu dashboard
2. Haz clic en “Conectar GitHub” para vincular tu cuenta de GitHub
3. Serás redirigido a GitHub para autorizar la conexión

Paso 3: Instalar la app de GitHub

1. Después de conectar GitHub, se te redirigirá para instalar la app de GitHub de Locadex
2. Elige a qué repositorios quieres darle acceso a Locadex:
   • Instalar en todos los repositorios, o
   • Seleccionar repositorios específicos
3. Haz clic en «Install» para completar la instalación de la app de GitHub

Paso 4: Vincular el repositorio al proyecto

1. De vuelta en tu dashboard de GT, selecciona el repositorio que quieres internacionalizar
2. Esto conecta tu repositorio con tu configuración de traducción y los idiomas de destino
3. Solo se puede vincular un repositorio a un proyecto, pero puedes crear varios proyectos, cada uno con un repositorio distinto

Paso 5: Configurar la configuración

En la pantalla de configuración, establece:

• Idiomas de destino: Elige a qué locales traducir

Paso 6: Completar la instalación

1. Revisa tu configuración
2. Haz clic en “Install” para activar Locadex en tu repositorio
3. Se te llevará a una página de resumen que muestra tu repositorio de GitHub conectado

Qué sigue

Configuración inicial

Una vez que completes la instalación:

1. Creación inmediata de PR: Locadex creará un pull request en tu rama principal.
2. Configuración completa: Este PR ejecuta el comando de configuración completo de Locadex que:
   • Instala las bibliotecas de GT
   • Configura tu proyecto para la internacionalización
   • Implementa la infraestructura de traducción
3. Revisión y merge: Revisa el PR y haz merge para completar tu configuración de i18n

Internacionalización continua

Después de integrar la configuración inicial:

1. Locadex supervisa tu rama principal o la que especifiques para detectar pull requests
2. Cuando haces push de código nuevo con contenido traducible, espera a que Locadex agregue su commit al PR
3. Una vez que Locadex haga un commit en el PR, es seguro hacer merge: tu nuevo código queda internacionalizado
4. Tu aplicación permanece traducida sin intervención manual

Monitoreo de tu repositorio

Estado del dashboard

En el dashboard, puedes supervisar:

• Estado del repositorio: Indicador de monitoreo activo
• Configuración: Ajustes actuales e idiomas objetivo

Integración con GitHub

• Comprobaciones de estado: Locadex añade actualizaciones de estado a las pull requests
• Ejecuciones de comprobación: GitHub muestra el estado de procesamiento de Locadex

Resolución de problemas

Problemas comunes

Locadex no crea PR

• Verifica que la app de GitHub tenga acceso al repositorio
• Comprueba que los commits incluyan contenido traducible

Se requieren cambios de configuración

• Actualiza la configuración de ramas en tu dashboard de GT
• Los cambios se aplican a los nuevos commits después de la actualización

Frameworks compatibles

Actualmente, Locadex solo es compatible con aplicaciones que usan el App Router de Next.js.