¿Qué hace Asistente de Internacionalización?
Ayuda a gestionar la internacionalización (i18n) y localización (l10n) en aplicaciones multilingües.
Cuándo usar
- El usuario solicita soporte i18n
- Agregar nuevos idiomas
- Encontrar cadenas sin traducir
- Administrar archivos de traducción
- El usuario menciona "traducción", "i18n", "l10n", "locale"
Instrucciones
1. Detectar el framework i18n
JavaScript/React:
- react-i18next
- react-intl (FormatJS)
- i18next
- LinguiJS
Vue:
- vue-i18n
Python:
- gettext
- Django i18n
- Flask-Babel
Ruby/Rails:
- I18n gem (integrado)
Busca imports, archivos de configuración o directorios de traducción.
2. Encontrar cadenas fijas
Busca texto sin traducir:
// Mal: Fijo
<button>Enviar</button>
<p>¡Bienvenido, {user.name}!</p>
// Bien: Traducido
<button>{t('common.submit')}</button>
<p>{t('welcome.message', { name: user.name })}</p>
Patrones de búsqueda:
- Cadenas en etiquetas JSX/plantilla
- Mensajes de alerta/error
- Etiquetas y marcadores de formulario
- Texto de botones
- Mensajes de validación
Excluir: comentarios de código, console.log, cadenas de prueba
3. Extraer a archivos de traducción
Formato react-i18next (JSON):
{
"common": {
"submit": "Enviar",
"cancel": "Cancelar"
},
"welcome": {
"message": "¡Bienvenido, {{name}}!"
}
}
Formato Gettext (.po):
msgid "submit_button"
msgstr "Enviar"
msgid "welcome_message"
msgstr "¡Bienvenido, %(name)s!"
4. Organizar claves de traducción
Buenas prácticas:
- Espacio de nombres por funcionalidad:
usuarios.perfil.titulo - Agrupar cadenas comunes:
comun.botones.guardar - Describir contexto, no contenido:
errores.login.invalidonoerrores.contraseña_incorrecta - Convención de nomenclatura consistente
5. Verificar cobertura de traducciones
Compara archivos de configuración regional para encontrar traducciones faltantes:
en.json: 150 claves
es.json: 142 claves (faltan 8)
fr.json: 150 claves ✓
Faltantes en es.json:
- usuarios.perfil.biografia
- configuracion.privacidad.titulo
[...]
6. Manejar pluralización
Diferentes idiomas tienen reglas de plural distintas:
// react-i18next
t('items', { count: 0 }) // "0 elementos"
t('items', { count: 1 }) // "1 elemento"
t('items', { count: 5 }) // "5 elementos"
// Archivo de traducción
{
"items_zero": "{{count}} elementos",
"items_one": "{{count}} elemento",
"items_other": "{{count}} elementos"
}
7. Formato de fechas, horas y números
Usa formato sensible a la configuración regional:
// Números
const precio = new Intl.NumberFormat('es-ES', {
style: 'currency',
currency: 'EUR'
}).format(29.99);
// Fechas
const fecha = new Intl.DateTimeFormat('es-ES').format(new Date());
8. Soporte para RTL (derecha a izquierda)
Para árabe, hebreo:
- CSS:
direction: rtl; - HTML:
<html dir="rtl"> - Propiedades lógicas:
margin-inline-starten lugar demargin-left
9. Generar plantilla de traducción
Crea plantilla para un nuevo idioma:
# Copiar claves del idioma base, valores vacíos
cp locales/en.json locales/de.json
# Marcar para traducción
10. Buenas prácticas
- Mantener traducciones en archivos separados
- Usar claves, no el texto fuente como claves
- Proporcionar contexto a los traductores
- Probar con cadenas largas (el alemán suele ser más largo)
- Usar ICU MessageFormat para cadenas complejas
- Evitar concatenar cadenas traducidas
- Extraer todo el texto visible al usuario
Archivos de soporte
templates/i18n-config.js: Ejemplos de configuracióntemplates/locale-file.json: Plantilla de archivo de traducción