fix sonar findings and translation structure
This commit is contained in:
@@ -26,9 +26,13 @@ Die App richtet sich an Grundschulkinder und Menschen ohne technische Vorkenntni
|
||||
|
||||
## Texte und Übersetzungen
|
||||
|
||||
- Alle eigenen Bedienungstexte liegen zentral in der Klasse `WegwichtelTextsDe`
|
||||
- Alle eigenen Bedienungstexte liegen zentral in der Klasse `WegwichtelTexts`
|
||||
in `public/js/texts-de.js`. Keine neuen sichtbaren Texte direkt in HTML oder
|
||||
Funktionscode schreiben.
|
||||
- Das HTML enthält daraus erzeugte deutsche Standardtexte, damit Beschriftungen
|
||||
vor dem Laden der Skripte vorhanden sind. Nach Änderungen am Textkatalog
|
||||
`node scripts/localize-html.js` ausführen und `public/index.html` mit ablegen.
|
||||
Diese erzeugten Texte nicht von Hand ändern; die i18n-Attribute bleiben erhalten.
|
||||
- JavaScript bezieht Texte über `Wegwichtel.I18n.t(textKey, variables)`.
|
||||
HTML verwendet `data-i18n` bzw. `data-i18n-aria-label`, `data-i18n-title`,
|
||||
`data-i18n-placeholder` und `data-i18n-alt`.
|
||||
@@ -37,6 +41,14 @@ Die App richtet sich an Grundschulkinder und Menschen ohne technische Vorkenntni
|
||||
- Nutzerinhalte wie Streckennamen, Beschreibungen und Aufnahmen nicht automatisch
|
||||
übersetzen oder verändern. Interne Fehlerdiagnosen dürfen technisch bleiben;
|
||||
die sichtbare Meldung muss verständlich sein.
|
||||
- Zusätzliche Sprachen über `I18n.register` ergänzen. Fehlende Übersetzungen
|
||||
fallen auf Deutsch zurück. Sprachwechsel aktualisieren feste Beschriftungen;
|
||||
- Sprachdateien heißen `public/js/texts-<Sprache>.js` und verwenden dieselbe
|
||||
generische Klasse `WegwichtelTexts`. Sie registrieren sich in `TextCatalogs`.
|
||||
Die App lädt Deutsch und Englisch und wählt anhand von `navigator.languages`
|
||||
bzw. `navigator.language`. Fehlende Übersetzungen fallen auf den ersten
|
||||
geladenen Katalog zurück (in der App Deutsch).
|
||||
- Verwende kurze, stabile englische Funktionsschlüssel wie `app.no-route` oder
|
||||
`bootstrap-loader.error.start-error`. Schlüssel nicht aus dem deutschen Text
|
||||
ableiten. Startmeldungen in `bootstrap-loader.steps` nach Schritt gruppieren.
|
||||
- Deutsch und Englisch enthalten dieselben Schlüssel, Platzhalter und Pluralformen.
|
||||
Texte in beiden Sprachen einfach und sinngemäß schreiben. Sprachwechsel aktualisieren feste Beschriftungen;
|
||||
bereits erzeugte dynamische Ansichten bei Bedarf neu rendern.
|
||||
|
||||
Reference in New Issue
Block a user