Internacionalización (i18n)
Prioridad: P2 (MEDIA)
Mantener una única fuente de verdad para los locales y garantizar un enrutamiento SEO-friendly mediante sub-rutas.
Directrices de Implementación
- Enrutamiento Regional: Seguir el enfoque URL-first para SEO. Usar segmentos dinámicos en App Router (ej.,
app/[lang]/page.tsx) y la configuracióni18nennext.config.jspara Pages Router. - Selección de Biblioteca: Usar
next-intlpara App Router (moderno) oreact-intl/next-translatepara aplicaciones heredadas. - Detección: Implementar localización mediante Middleware (en
middleware.ts) para detectar el idioma del usuario a partir de las cabecerasAccept-Languageo cookies y realizar redirecciones. - Lado del Servidor: Cargar los diccionarios de traducción
messages/*.jsonen Server Components para mantener pequeño el bundle del cliente. Usar los patronesgetMessages()orequestConfig. - SEO: Asegurar que las etiquetas
hreflangse generen correctamente en la APImetadatapara todas las rutas traducidas. - Generación Estática: Usar
generateStaticParamspara pre-renderizar versiones localizadas de páginas estáticas en tiempo de construcción.module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. Especificidades de las Bibliotecas
Para una configuración detallada con bibliotecas comunes, consulta:
Anti-Patrones
- No usar cadenas hardcodeadas en JSX: Usar claves de traducción; nunca introducir texto sin formato.
- No usar bundles de traducción del lado del cliente: Cargar los diccionarios del lado del servidor con
getMessages(). - No mezclar patrones de URL de configuración regional: Usar sub-rutas o dominios de forma consistente.