Que fait HitKeep i18n ?
Utilisez cette compétence lorsque vous modifiez le texte visible par l'utilisateur du tableau de bord ou le formatage localisé dans HitKeep.
Le tableau de bord de HitKeep utilise des fichiers JSON Transloco pour le texte de l'interface utilisateur et @jsverse/transloco-locale ainsi que les API Intl du navigateur pour le formatage localisé. Les libellés PrimeNG sont synchronisés à partir de la langue Transloco active.
Surface publique
Les fichiers de traduction du tableau de bord se trouvent dans :
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
Le tableau de bord expose actuellement ces identifiants de langue :
en, de, es, fr, it, nl, pt
Les correspondances de formatage localisées sont configurées dans 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
N'inférez pas une nouvelle langue prise en charge uniquement à partir d'un utilitaire de locale Angular. Ajoutez ou modifiez une langue prise en charge du tableau de bord uniquement lorsque la configuration Transloco, le fichier JSON de locale, la correspondance de formatage et la documentation produit sont tous en accord.
Flux de travail
- Recherchez la clé de fonctionnalité existante avant d'en créer une nouvelle.
- Mettez le texte des modèles Angular visible par l'utilisateur derrière
TranslocoPipe. - Utilisez
TranslocoServicepour les libellés calculés en TypeScript. - Ajoutez le même chemin de clé à tous les sept fichiers JSON de locale.
- Gardez les noms de clés sémantiques et regroupés par fonctionnalité.
- Préservez exactement les variables d'interpolation. Ne traduisez pas les noms de variables et ne modifiez pas la syntaxe des espaces réservés.
- Pour les libellés d'options calculés, dépendez de la langue active afin que les libellés se recalculent après les changements de langue.
- Pour les dates, nombres, pourcentages et durées, préférez les services ou utilitaires de locale existants plutôt que le formatage manuel de chaînes.
- Laissez le texte de locale PrimeNG transiter par le service de synchronisation existant au lieu de coder en dur les libellés des composants.
- Gardez les libellés suffisamment courts pour les boutons, les onglets, les chips, les colonnes de tableaux et les dispositions mobiles.
Emplacements utiles à inspecter :
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
Barre de qualité de traduction
Traduisez l'interface produit, pas des mots anglais individuels.
- Allemand : utilisez un allemand produit naturel et les caractères corrects comme
Ä,Ö,Ü,ä,ö,üetß. - Espagnol : utilisez les accents, le
ñet la ponctuation d'ouverture si nécessaire, par exemple¿Seguro?. - Français : utilisez les accents et les apostrophes naturellement, par exemple
paramètres,sécuritéetl'adresse e-mail. - Italien : utilisez les accents si nécessaire, en particulier pour les mots à accent final comme
attività,città,perché,puòetè. - Néerlandais : gardez la terminologie du tableau de bord naturelle et concise. Réutilisez les termes existants pour site, équipe, objectif, entonnoir, lien de partage et client API.
- Portugais : utilisez le contexte de formatage portugais brésilien existant (
pt-BR) sauf si le produit change explicitement la cible de locale. Utilisez un portugais naturel avec les accents corrects.
Gardez la terminologie analytique cohérente dans toutes les langues. Si le dépôt utilise déjà un terme pour « site », « équipe », « événement », « objectif », « entonnoir », « lien de partage », « client API », « campagne QR » ou « Opportunité », réutilisez-le.
Vérifications
Exécutez la vérification de locale après les modifications de traduction :
cd frontend/dashboard && npm run i18n:check
Si une dérive de forme de clé est suspectée, exécutez le script de synchronisation et examinez les modifications résultantes avant de les conserver :
cd frontend/dashboard && node scripts/sync-i18n-locales.mjs
Exécutez les vérifications de formatage pour les fichiers du tableau de bord :
cd frontend/dashboard && npm run fmt:check
Pour le comportement de l'interface utilisateur qui dépend du changement de langue, ajoutez ou mettez à jour des tests ciblés près du composant ou du service propriétaire du comportement.
Sortie pour les révisions
Lorsque vous signalez une modification i18n, incluez :
Clés modifiées :
- <chemin de clé>
Locales mises à jour :
- en, de, es, fr, it, nl, pt
Vérifications :
- <commande et résultat>
Remarques :
- <notes de mise en page, formulation ou révision>
N'affirmez pas qu'une traduction a été révisée par un locuteur natif sauf si cela a effectivement eu lieu.