Gestionar Locales

Resumen

Este documento proporciona orientación sobre cómo gestionar locales en tu aplicación Next.js con el gt-next. Recorreremos la configuración de la lista de locales que deseas soportar, y luego activaremos la generación de traducciones.

Esta biblioteca utiliza el estándar BCP-47 para definir locales. Consulta una lista de los locales actualmente soportados aquí.

Configuración de Locales

Hay dos maneras de cambiar tus locales para producción:

1. La herramienta CLI
2. El archivo gt.config.json (preferido)

Para que se realice la traducción, debes agregar el comando de traducción a tu script de construcción:

{
  "scripts": {
    "build": "npx gtx-cli translate && next build"
  }
}

Esto generará las traducciones necesarias y las almacenará en la nube o en tu sistema de archivos local dependiendo de tu configuración.

Gestión de locales con la herramienta CLI

La forma más sencilla de gestionar locales es especificándolos a través del comando npx gtx-cli translate usando la bandera --locales.

{
  "scripts": {
    "build": "npx gtx-cli translate --locales en-US zh jp && <YOUR_BUILD_COMMAND>"
  }
}

Esto generará traducciones para chino (zh) y japonés (jp).

Usando gt.config.json (preferido)

Una forma más robusta de gestionar locales es usando el archivo gt.config.json. puedes especificar la lista de locales que deseas soportar con la propiedad locales.

{
  "locales": ["zh", "jp"],
}

Locales permitidos

Como una característica opcional, puedes agregar una lista de locales permitidos. Esto es accesible a través del panel de control en la página de Locales del Proyecto. Si habilitas esta característica, cualquier intento de llamar a npx translate con locales no permitidos fallará.

Notas

• Puedes gestionar los locales a través del panel de control, el archivo gt.config.json o la herramienta CLI.
• Usar gt.config.json o la herramienta CLI para gestionar los locales desactivará la función Gestionar Locales en el panel de control.

Próximos Pasos

• Aprende sobre la sintaxis de localización en la referencia de Cadenas de Localización.