Idioma de la interfaz de usuario de la herramienta
La ai-i18n-tools localiza su propia interfaz de usuario (texto de ayuda de la CLI, mensajes de registro/resumen/error de alto tráfico y el Panel de traducción) independientemente de la sourceLocale / targetLocales de su proyecto. No se requiere configuración: por defecto, la herramienta sigue la configuración regional de su sistema operativo.
Resolución de la configuración regional
La configuración regional de la interfaz de usuario se resuelve a partir de estas fuentes, de mayor a menor prioridad:
- Indicador global
-L/--ui-lang <code>(por ejemplo,-L pt-BR). - Variable de entorno
AI_I18N_LANG(por ejemplo,export AI_I18N_LANG=es). - La clave de configuración
uiLanguageenai-i18n-tools.config.json(cadena BCP-47). - La locale del sistema operativo anfitrión (a través de
Intl.DateTimeFormat().resolvedOptions().locale).
Coincidencia y reserva
La configuración regional solicitada se compara exactamente con los idiomas de interfaz de usuario distribuidos o por la variación más cercana (por ejemplo, pt-PT se resuelve en pt-BR, y en-US se resuelve en en-GB); cuando nada coincide, recurre a la configuración regional de origen (en-GB). Cuando se solicita explícitamente un idioma de interfaz de usuario (a través del indicador, la variable de entorno o uiLanguage) pero no coincide ningún paquete distribuido, la CLI imprime una advertencia única de que se utilizará la configuración regional predeterminada; una configuración regional inferida solo del sistema operativo anfitrión nunca advierte.
Idiomas de la interfaz de usuario enviados
Inglés (Reino Unido, origen), alemán, español, francés, hindi, japonés, coreano, portugués (Brasil), chino (simplificado), chino (tradicional).
Panel de traducción
El Panel de traducción lee la configuración regional resuelta, la dirección del diseño y el paquete de traducción de GET /api/ui-i18n y los aplica al cargar (establece <html lang> / dir y localiza el marcado estático a través de los atributos data-i18n*).
Relacionado
AI_I18N_LANG— anulación de la variable de entornouiLanguage— anulación de la clave de configuración-L/--ui-lang— anulación de la bandera de la CLI (la más alta prioridad)