i18n y Localización
Mejores prácticas de Internacionalización (i18n) y Localización (L10n).
1. Conceptos Básicos
| Término | Significado |
|---|
| i18n | Internacionalización - hacer que la aplicación sea traducible |
| L10n | Localización - traducciones reales |
| Locale | Idioma + Región (en-US, tr-TR) |
| RTL | Idiomas de derecha a izquierda (árabe, hebreo) |
2. Cuándo Usar i18n
| Tipo de Proyecto | ¿i18n Necesario? |
|---|
| Aplicación web pública | ✅ Sí |
| Producto SaaS | ✅ Sí |
| Herramienta interna | ⚠️ Quizás |
| Aplicación de una sola región | ⚠️ Considerar futuro |
| Proyecto personal | ❌ Opcional |
3. Patrones de Implementación
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Bienvenida() {
const { t } = useTranslation();
return <h1>{t('bienvenida.titulo')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Pagina() {
const t = useTranslations('Inicio');
return <h1>{t('titulo')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Bienvenido a nuestra aplicación"))
4. Estructura de Archivos
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
5. Mejores Prácticas
HACER ✅
- Usar claves de traducción, no texto sin formato
- Agrupar las traducciones por funcionalidad
- Soporte para pluralización
- Manejar formatos de fecha/número por locale
- Planificar para RTL desde el inicio
- Usar formato de mensaje ICU para cadenas complejas
NO HACER ❌
- Escribir cadenas fijas en componentes
- Concatenar cadenas traducidas
- Asumir la longitud del texto (el alemán es un 30% más largo)
- Olvidar el diseño RTL
- Mezclar idiomas en el mismo archivo
6. Problemas Comunes
| Problema | Solución |
|---|
| Traducción faltante | Recurrir al idioma predeterminado |
| Cadenas fijas | Usar un script de linting/verificación |
| Formato de fecha | Usar Intl.DateTimeFormat |
| Formato de número | Usar Intl.NumberFormat |
| Pluralización | Usar formato de mensaje ICU |
7. Soporte RTL
.contenedor {
margin-inline-start: 1rem;
padding-inline-end: 1rem;
}
[dir="rtl"] .icono {
transform: scaleX(-1);
}
8. Lista de Verificación
Antes de publicar:
Script
| Script | Propósito | Comando |
|---|
scripts/i18n_checker.py | Detectar cadenas fijas y traducciones faltantes | python scripts/i18n_checker.py <ruta_del_proyecto> |
Cuándo Usar
Esta habilidad es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la descripción general.
Limitaciones
- Use esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trate la salida como un sustituto de la validación específica del entorno, las pruebas o la revisión por expertos.
- Deténgase y solicite aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.