Communitygithub.com

HitKeep i18n

HitKeep est un outil d'analyse respectueux de la vie privée pour les humains et les agents IA, auto-hébergé ou dans des régions cloud gérées aux États-Unis/UE.

Qu'est-ce que HitKeep i18n ?

Cette compétence est conçue pour aider les développeurs et les agents IA à gérer l'internationalisation (i18n) du tableau de bord HitKeep. Elle prend en charge sept langues actuelles (en, de, es, fr, it, nl, pt) et s'appuie sur Transloco pour les textes d'interface, `@jsverse/transloco-locale` et les API `Intl` pour le formatage localisé, et PrimeNG pour les composants synchronisés avec la langue active. La compétence guide l'utilisateur à travers un workflow structuré : recherche de clés existantes, ajout de nouvelles clés à tous les fichiers JSON, utilisation de `TranslocoPipe` et `TranslocoService`, et maintien de la cohérence des variables d'interpolation. Elle impose des barres de qualité de traduction spécifiques par langue (par exemple, majuscules allemandes, accents français) et des vérifications automatisées via `i18n:check` et `sync-i18n-locales`. Cela garantit que les modifications de texte sont cohérentes, formatées correctement et ne cassent pas les fonctionnalités locales.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add PascaleBeier/hitkeep

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.json
  • frontend/dashboard/public/i18n/de.json
  • frontend/dashboard/public/i18n/es.json
  • frontend/dashboard/public/i18n/fr.json
  • frontend/dashboard/public/i18n/it.json
  • frontend/dashboard/public/i18n/nl.json
  • frontend/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

  1. Recherchez la clé de fonctionnalité existante avant d'en créer une nouvelle.
  2. Mettez le texte des modèles Angular visible par l'utilisateur derrière TranslocoPipe.
  3. Utilisez TranslocoService pour les libellés calculés en TypeScript.
  4. Ajoutez le même chemin de clé à tous les sept fichiers JSON de locale.
  5. Gardez les noms de clés sémantiques et regroupés par fonctionnalité.
  6. 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.
  7. 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.
  8. 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.
  9. Laissez le texte de locale PrimeNG transiter par le service de synchronisation existant au lieu de coder en dur les libellés des composants.
  10. 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.ts
  • frontend/dashboard/src/app/transloco-loader.ts
  • frontend/dashboard/src/app/core/i18n/
  • frontend/dashboard/scripts/check-i18n-locales.mjs
  • frontend/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é et l'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.

Skills associés