i18n y Localización
Prácticas recomendadas para 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 - las 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 | ¿Se necesita i18n? |
|---|
| App web pública | ✅ Sí |
| Producto SaaS | ✅ Sí |
| Herramienta interna | ⚠️ Quizás |
| App de una sola región | ⚠️ Considerar futuro |
| Proyecto personal | ❌ Opcional |
3. Patrones de implementación
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Bienvenido() {
const { t } = useTranslation();
return <h1>{t('bienvenido.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/
├── es/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
5. Buenas prácticas
SÍ ✅
- Usar claves de traducción, no texto sin formato
- Agrupar las traducciones por funcionalidad
- Dar soporte a pluralización
- Manejar formatos de fecha/número por locale
- Planificar para RTL desde el principio
- Usar formato ICU para cadenas complejas
NO ❌
- Hardcodear cadenas en los 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 hardcodeadas | Usar script de linting/comprobación |
| Formato de fecha | Usar Intl.DateTimeFormat |
| Formato de número | Usar Intl.NumberFormat |
| Pluralización | Usar formato 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 del lanzamiento:
Script
| Script | Propósito | Comando |
|---|
scripts/i18n_checker.py | Detectar cadenas hardcodeadas y traducciones faltantes | python scripts/i18n_checker.py <ruta_del_proyecto> |
Cuándo usar
Este skill es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la descripción general.
Conexiones
- Dominio: [[Software Entwicklung]]
- Categoría: [[Software Architektur]]
- Archivos:
- Navegación: [[Skills Übersicht]], [[Home]]