HitKeep i18n
Usa esta habilidad cuando estés cambiando texto del panel de control visible para el usuario o formatos localizados en HitKeep.
El panel de control de HitKeep utiliza archivos JSON de Transloco para el texto de la interfaz de usuario y @jsverse/transloco-locale más las APIs Intl del navegador para formatos sensibles a la configuración regional. Las etiquetas de PrimeNG se sincronizan desde el idioma activo de Transloco.
Superficie Pública
Los archivos de traducción del panel están en:
frontend/dashboard/public/i18n/en.jsonfrontend/dashboard/public/i18n/de.jsonfrontend/dashboard/public/i18n/es.jsonfrontend/dashboard/public/i18n/fr.jsonfrontend/dashboard/public/i18n/it.jsonfrontend/dashboard/public/i18n/nl.jsonfrontend/dashboard/public/i18n/pt.json
El panel actualmente expone estos identificadores de idioma:
en, de, es, fr, it, nl, pt
Las asignaciones de configuración regional para formateo están configuradas en frontend/dashboard/src/app/app.config.ts:
en -> en-US
de -> de-DE
es -> es-ES
fr -> fr-FR
it -> it-IT
nl -> nl-NL
pt -> pt-BR
No inferir un nuevo idioma soportado únicamente a partir de un helper de configuración regional de Angular. Agregar o cambiar un idioma soportado del panel solo cuando la configuración de Transloco, el archivo JSON de configuración regional, la asignación de formato y la documentación del producto estén todos de acuerdo.
Flujo de trabajo
- Buscar la clave de funcionalidad existente antes de crear una nueva.
- Poner el texto de la plantilla Angular visible para el usuario detrás de
TranslocoPipe. - Usar
TranslocoServicepara etiquetas calculadas en TypeScript. - Agregar la misma ruta de clave a los siete archivos JSON de configuración regional.
- Mantener los nombres de clave semánticos y agrupados por funcionalidad.
- Preservar las variables de interpolación exactamente. No traducir nombres de variables ni cambiar la sintaxis de los marcadores de posición.
- Para etiquetas de opciones calculadas, depender del idioma activo para que las etiquetas se recalculen después de cambios de idioma.
- Para fechas, números, porcentajes y duraciones, preferir los servicios o helpers de configuración regional existentes en lugar de formatear cadenas manualmente.
- Dejar que el texto de configuración regional de PrimeNG fluya a través del servicio de sincronización existente en lugar de codificar etiquetas de componentes.
- Mantener las etiquetas lo suficientemente cortas para botones, pestañas, chips, columnas de tabla y diseños móviles.
Lugares útiles para inspeccionar:
frontend/dashboard/src/app/app.config.tsfrontend/dashboard/src/app/transloco-loader.tsfrontend/dashboard/src/app/core/i18n/frontend/dashboard/scripts/check-i18n-locales.mjsfrontend/dashboard/scripts/sync-i18n-locales.mjs
Nivel de calidad de traducción
Traducir el producto de la interfaz de usuario, no palabras individuales en inglés.
- Alemán: usar alemán de producto natural y caracteres correctos como
Ä,Ö,Ü,ä,ö,üyß. - Español: usar acentos,
ñy puntuación de apertura cuando sea necesario, por ejemplo¿Seguro?. - Francés: usar acentos y apóstrofos de forma natural, por ejemplo
paramètres,sécuritéyl'adresse e-mail. - Italiano: usar acentos cuando sea necesario, especialmente palabras con acento final como
attività,città,perché,puòyè. - Neerlandés: mantener la terminología del panel natural y concisa. Reutilizar términos existentes para sitio, equipo, objetivo, embudo, enlace compartido y cliente de API.
- Portugués: usar el contexto de formato de portugués brasileño existente (
pt-BR) a menos que el producto cambie explícitamente el objetivo de configuración regional. Usar portugués natural con acentos correctos.
Mantener la terminología de analítica consistente en todos los idiomas. Si el repositorio ya usa un término para "sitio", "equipo", "evento", "objetivo", "embudo", "enlace compartido", "cliente de API", "campaña QR" u "Oportunidad", reutilizarlo.
Verificaciones
Ejecutar la verificación de configuración regional después de cambios de traducción:
cd frontend/dashboard && npm run i18n:check
Si se sospecha una desviación en la forma de las claves, ejecutar el script de sincronización y revisar los cambios resultantes antes de conservarlos:
cd frontend/dashboard && node scripts/sync-i18n-locales.mjs
Ejecutar verificaciones de formato para los archivos del panel:
cd frontend/dashboard && npm run fmt:check
Para el comportamiento de la interfaz de usuario que depende del cambio de idioma, agregar o actualizar pruebas específicas cerca del componente o servicio que posee el comportamiento.
Salida para revisiones
Al informar un cambio de i18n, incluir:
Claves cambiadas:
- <ruta de clave>
Configuraciones regionales actualizadas:
- en, de, es, fr, it, nl, pt
Verificaciones:
- <comando y resultado>
Advertencias:
- <notas de diseño, redacción o revisión>
No afirmar que una traducción fue revisada por un hablante nativo a menos que eso realmente haya ocurrido.