HitKeep i18n
Verwende diesen Skill, wenn sichtbarer Dashboard-Text oder sprachabhängige Formatierungen in HitKeep geändert werden.
Das Dashboard von HitKeep verwendet Transloco-JSON-Dateien für UI-Texte und @jsverse/transloco-locale sowie Browser-Intl-APIs für sprachabhängige Formatierung. PrimeNG-Labels werden von der aktiven Transloco-Sprache synchronisiert.
Öffentliche Oberfläche
Die Übersetzungsdateien des Dashboards befinden sich in:
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
Das Dashboard bietet derzeit diese Sprachkennungen an:
en, de, es, fr, it, nl, pt
Die Formatierungs-Locale-Zuordnungen sind in frontend/dashboard/src/app/app.config.ts konfiguriert:
en -> en-US
de -> de-DE
es -> es-ES
fr -> fr-FR
it -> it-IT
nl -> nl-NL
pt -> pt-BR
Leite keine neue unterstützte Sprache allein aus einem Angular-Locale-Helper ab. Füge eine neue Dashboard-Sprache nur dann hinzu oder ändere sie, wenn die Transloco-Konfiguration, die Locale-JSON-Datei, die Formatierungszuordnung und die Produktdokumentation übereinstimmen.
Arbeitsablauf
- Suche nach dem vorhandenen Feature-Schlüssel, bevor du einen neuen Schlüssel erstellst.
- Setze sichtbaren Angular-Template-Text hinter
TranslocoPipe. - Verwende
TranslocoServicefür berechnete Labels in TypeScript. - Füge denselben Schlüsselpfad zu allen sieben Locale-JSON-Dateien hinzu.
- Halte Schlüsselnamen semantisch und nach Feature gruppiert.
- Behalte Interpolationsvariablen exakt bei. Übersetze keine Variablennamen und ändere keine Platzhalter-Syntax.
- Für berechnete Optionslabels hänge von der aktiven Sprache ab, damit Labels nach Sprachwechseln neu berechnet werden.
- Für Daten, Zahlen, Prozentangaben und Dauern bevorzuge die vorhandenen Locale-Dienste oder Hilfsfunktionen anstelle manueller Zeichenkettenformatierung.
- Lasse PrimeNG-Locale-Text durch den vorhandenen Synchronisationsdienst fließen, anstatt Komponentenlabels fest zu codieren.
- Halte Labels kurz genug für Schaltflächen, Tabs, Chips, Tabellenspalten und mobile Layouts.
Nützliche Orte zur Ansicht:
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
Übersetzungsqualität
Übersetze die Produkt-UI, nicht einzelne englische Wörter.
- Deutsch: Verwende natürliches Produktdeutsch und korrekte Zeichen wie
Ä,Ö,Ü,ä,ö,üundß. - Spanisch: Verwende Akzente,
ñund Anfangssatzzeichen, wo erforderlich, z. B.¿Seguro?. - Französisch: Verwende Akzente und Apostrophe natürlich, z. B.
paramètres,sécuritéundl'adresse e-mail. - Italienisch: Verwende Akzente wo erforderlich, besonders bei Wörtern mit Endbetonung wie
attività,città,perché,puòundè. - Niederländisch: Halte die Dashboard-Terminologie natürlich und prägnant. Verwende vorhandene Begriffe für Site, Team, Goal, Funnel, Share Link und API Client.
- Portugiesisch: Verwende den vorhandenen brasilianischen Formatierungskontext (
pt-BR), es sei denn, das Produkt ändert explizit das Locale-Ziel. Verwende natürliches Portugiesisch mit korrekten Akzenten.
Halte die Analyseterminologie über alle Sprachen hinweg konsistent. Wenn das Repository bereits einen Begriff für „Site”, „Team”, „Event”, „Goal”, „Funnel”, „Share Link”, „API Client”, „QR Campaign” oder „Opportunity” verwendet, verwende ihn erneut.
Prüfungen
Führe den Locale-Check nach Übersetzungsänderungen aus:
cd frontend/dashboard && npm run i18n:check
Wenn ein Schlüsselstruktur-Abweichung vermutet wird, führe das Sync-Skript aus und überprüfe die resultierenden Änderungen, bevor du sie übernimmst:
cd frontend/dashboard && node scripts/sync-i18n-locales.mjs
Führe Formatierungsprüfungen für Dashboard-Dateien aus:
cd frontend/dashboard && npm run fmt:check
Für UI-Verhalten, das von Sprachwechseln abhängt, füge gezielte Tests nahe der Komponente oder des Dienstes hinzu, der das Verhalten besitzt, oder aktualisiere sie.
Ausgabe für Reviews
Wenn du eine i18n-Änderung meldest, füge folgendes ein:
Geänderte Schlüssel:
- <Schlüsselpfad>
Aktualisierte Locales:
- en, de, es, fr, it, nl, pt
Prüfungen:
- <Befehl und Ergebnis>
Hinweise:
- <Layout-, Wortlaut- oder Review-Anmerkungen>
Behaupte nicht, dass eine Übersetzung von einem Muttersprachler überprüft wurde, es sei denn, das ist tatsächlich geschehen.