LV DICTIONARY DEUTSCH - DEUTSCH
============================================

INSTALLATION
------------
Kein Setup nötig. Den ganzen Ordner "LVDic-Deu-Deu" an einen
beliebigen Ort auf dem Computer kopieren (z. B. auf den Desktop oder in
"Eigene Dokumente"). Die Datei "index.html" per Doppelklick öffnen -
sie startet im Standardbrowser (empfohlen: Microsoft Edge). Es ist KEINE
Internetverbindung nötig, die Anwendung funktioniert vollständig offline.
Der Ordner ist knapp 60 MB gross (wegen der grossen Wortschatzdatenbank
inkl. Grammatik-, Synonym-, Redewendungs- und Herkunftsangaben) - das
ist normal, es findet aber trotzdem kein Internetzugriff statt.

BEDIENUNG MIT Screenreader
--------------------------
1. Nach dem Öffnen landet der Cursor automatisch im Eingabefeld "Wort
   eingeben". Direkt darunter befindet sich die Box "Zugriffstasten".
2. Während der Eingabe erscheinen automatisch passende Vorschläge aus
   dem Wörterbuch in einer Liste unterhalb des Eingabefeldes (mit den
   Pfeiltasten hoch/runter auswählbar, mit Eingabetaste übernehmbar,
   mit Escape wieder schliessbar).
3. Wort eintippen und Eingabetaste drücken (oder zur Schaltfläche
   "Nachschlagen" tabben und mit Leertaste/Enter bestätigen).
4. Der Screenreader liest automatisch das Ergebnis vor (Live-Region).
5. Der Fokus springt automatisch auf die Ergebnis-Überschrift, damit man
   mit den Pfeiltasten oder den Tasten an de Braillezeile direkt weiterlesen kann. Die Box
   "Zugriffstasten" rutscht nach der ersten Suche automatisch ganz an
   das Ende der Seite, unter die Ergebnis-Box. Sie ist jederzeit mit Alt+z erreichbar.
6. Die Navigation kann entweder über die Zugriffstasten erfolgen, oder über die 
   Schnellnavigationstasten des Screenreaders, wie z.B. h für Überschriften.
7. Wurde ein Wort vermutlich falsch geschrieben (z. B. "Schneke" statt
   "Schnecke"), erscheint der Hinweis "Hast du das Wort vielleicht falsch
   geschrieben? Hier sind mögliche Treffer zu deiner Eingabe:" gefolgt
   von anklickbaren Vorschlägen.

REIHENFOLGE DER ERGEBNISBEREICHE
-----------------------------------
Nach jeder Suche werden folgende Bereiche in dieser Reihenfolge
angezeigt:
  1. Grammatik        - Wortart, ggf. Geschlecht/Artikel, Mehrzahl und
                        Trennung (Silbentrennung) des Wortes, sowie ein
                        Lautsprecher-Button zum Vorlesen des Wortes
  2. Bedeutung        - alle im Wörterbuch hinterlegten Bedeutungen
  3. Synonyme         - bedeutungsgleiche/-ähnliche Wörter (falls
                        vorhanden)
  4. Herkunft         - Herkunft/Etymologie des Wortes (falls bekannt)
  5. Redewendungen    - gängige Redewendungen mit diesem Wort (falls
                        vorhanden)

ZUGRIFFSTASTEN (ACCEss KEYS)
------------------------------
Zusätzlich zur normalen Tab-Navigation stehen folgende Tastenkürzel
zur Verfügung (im Browser als Standard-"accesskey", unter Windows in
Edge/Chrome per Alt+Taste auslösbar; sie sind auch direkt auf der
Startseite unter "Zugriffstasten" aufgelistet):

  Alt + t   ins Texteingabefeld springen
  Alt + g   zur Grammatik des zuletzt gesuchten Wortes springen
                (enthält jetzt auch die Trennung/Silbentrennung)
  Alt + b   zur Bedeutung des zuletzt gesuchten Wortes springen
  Alt + s   zu den Synonymen des zuletzt gesuchten Wortes springen
  Alt + h   zur Herkunft des Wortes springen
  Alt + r   zu den Redewendungen des zuletzt gesuchten Wortes springen
  Alt + z   zur Hilfe für die Zugriffstasten springen

(Alt+g/b/s/h/r funktionieren erst, nachdem mindestens einmal ein Wort
nachgeschlagen wurde, da die entsprechenden Bereiche erst dann auf der
Seite erscheinen.)

AUssPRACHE-FUNKTION
----------------------
Im Bereich "Grammatik" befindet sich ein Lautsprecher-Button ("Aussprache
anhören"). Er nutzt die Sprachsynthese-Funktion des Browsers/Windows
(Web Speech API) und liest das gesuchte Wort in einer installierten
deutschen Stimme vor - bevorzugt eine mit Sprachcode "de-DE". Diese
Funktion arbeitet vollständig offline mit den auf dem jeweiligen
Windows-Computer bereits installierten Sprachausgaben; Verfügbarkeit
und Natürlichkeit der Stimme hängen vom Computer ab (unter Windows
lassen sich unter "Einstellungen -> Zeit und Sprache -> Sprache &
Region -> Sprachpaket" bzw. "Sprachausgabe" zusätzliche, natürlicher
klingende deutsche Stimmen nachinstallieren). Ist auf dem Gerät keine
deutsche Stimme installiert, wird ersatzweise die Standardstimme des
Systems verwendet.

AUTOVERVOLLSTÄNDIGUNG UND TIPPFEHLER-VORSCHLÄGE
----------------------------------------------------
- Während der Eingabe zeigt das Wörterbuch bis zu 10 passende Wörter
  aus der gesamten Datenbank (ca. 175'800 Einträge) an.
- Wird nach dem Absenden kein Eintrag zum eingegebenen Wort gefunden,
  sucht das Programm automatisch nach ähnlich geschriebenen Wörtern
  (z. B. "Schneke" -> "Schnecke") und schlägt diese als anklickbare
  Schaltfläche vor.

DATENGRUNDLAGE
----------------
- BEDEUTUNGEN, GRAMMATIK (WORTART/GESCHLECHT/MEHRZAHL/TRENNUNG) UND
  HERKUNFT: Das Wörterbuch basiert auf einem echten Datenexport des
  deutschen Wiktionary (Snapshot vom 01.08.2026, Lizenz CC BY-SA 4.0,
  Quelle: bereitgestellter StarDict-Export "de-de", Projekt
  https://github.com/xxyzz/wiktionary_stardict). Enthalten sind rund
  175'800 Einträge mit jeweils allen im Wiktionary verzeichneten
  Bedeutungen, der Wortart, - soweit vorhanden - dem grammatischen
  Geschlecht (mit automatisch daraus abgeleitetem Artikel der/die/das)
  und der Mehrzahlform, der von Wiktionary redaktionell gepflegten
  Trennung (z. B. "Bar-ri-e-re-frei-heit", jetzt Teil des Bereichs
  "Grammatik") sowie, soweit vorhanden, Angaben zur Herkunft/Etymologie.
- SYNONYME UND REDEWENDUNGEN: Die Synonyme stammen in erster Linie aus
  OpenThesaurus (freies deutsches Synonymwörterbuch,
  https://www.openthesaurus.de, Lizenz LGPL 2.1 oder CC BY-SA 4.0,
  wahlweise); wo OpenThesaurus keine Synonyme liefert, wird auf den
  Wiktionary-Datenexport zurückgegriffen. Sie werden als eine einzige,
  kommagetrennte Aufzählung angezeigt (nicht als Liste mit Aufzählungs-
  zeichen); die Reihenfolge folgt dabei den Bedeutungsgruppen aus
  OpenThesaurus, sodass sinnverwandte Synonyme möglichst nebeneinander
  stehen, statt rein alphabetisch sortiert zu sein. Die Redewendungen
  stammen ebenfalls aus OpenThesaurus: erfasst werden sowohl Wendungen,
  in denen das gesuchte Wort wörtlich vorkommt (z. B. "(jemanden) zur
  Schnecke machen" beim Stichwort "Schnecke"), als auch mehrwortige
  Wendungen aus derselben Bedeutungsgruppe (Synset) und eigens als
  "Redensart" oder "Sprichwort" gekennzeichnete Einträge. Insgesamt
  sind so für rund 77'600 Wörter Synonyme und für rund 56'000 Wörter
  Redewendungen hinterlegt. Sind zu einem Wort mehr als 10 Redewendungen
  vorhanden, werden nur die ersten 10 angezeigt, zusammen mit einem
  Hinweis auf die Gesamtzahl - da die Datengrundlage keine Angaben zur
  tatsächlichen Gebrauchshäufigkeit einzelner Redewendungen enthält,
  ist dies eine reine Anzeigebegrenzung und keine echte Häufigkeits-
  Rangliste. In diesem Fall erscheint zusätzlich der Link "Alle
  Redewendungen anzeigen", der die vollständige Liste in einem eigenen
  (modalen) Fenster öffnet - bedienbar wie das Fenster "Über dieses
  Wörterbuch" (Escape oder Button "Schliessen" zum Beenden, Fokus kehrt
  danach zum Link zurück).
- FALLBACK-TRENNUNG: Für die wenigen Wörter ohne im Wiktionary
  hinterlegte Trennung (und für ganz neue/unbekannte Wörter, die
  gar nicht im Wörterbuch stehen) wird automatisch mit den
  Trennmustern/der Wortliste aus dem LibreOffice/OpenOffice-
  Wörterbuchpaket "hyph_de_DE" nachgerechnet (Liang-Algorithmus,
  Tradition der dehyphn/dehyph-Trennmuster, LGPL/LPPL-lizenziert).
- Für ein paar wenige Begriffe (z. B. Schweizer Schreibweisen ohne "ss"
  wie "Strasse", oder "Screenreader"), die im Wiktionary-Export nicht
  auffindbar waren, wurde eine kurze eigene Definition beibehalten
  (ohne Grammatik-/Herkunfts-/Synonymangaben).
- AUssPRACHE: Nutzt die vom Windows-Betriebssystem bzw. Browser
  bereitgestellte Sprachsynthese (siehe oben), keine externen Dienste.

"ÜBER DIESES WÖRTERBUCH"-FENSTER
-----------------------------------
Am Ende der Seite befindet sich die Schaltfläche "Über dieses
Wörterbuch". Sie öffnet ein eigenes (modales) Fenster mit folgenden
Abschnitten:
  - Einleitender Text zur Anwendung (KI-Einsatz bei der Entwicklung,
    Barrierefreiheit, Offlinefähigkeit, Plattformunabhängigkeit)
  - "Kostenlose Weitergabe"
  - "Fragen oder Anregungen?" - Kontaktangabe (Julian Iriogbe,
    reha@iriogbe.ch)
  - "Datenschutz"
  - "Freie Quellen und Lizenzen" - Datengrundlage, Lizenzhinweise sowie
    ein Ausschluss der Gewähr für Richtigkeit und der Haftung
  - Stand (Datum der zugrunde liegenden Version)
Das Fenster lässt sich mit der Escape-Taste oder dem Button
"Schliessen" wieder schliessen; der Fokus kehrt danach automatisch zur
Schaltfläche "Über dieses Wörterbuch" zurück. Innerhalb des Fensters
bleibt der Tastaturfokus beim Tabben auf die Fensterinhalte beschränkt
(Fokus-Falle), wie es für barrierefreie Dialoge üblich ist.

Bemerkungen zu den Daten: Die Synonyme stammen aus dem
Wiktionary-Datenexport, ergänzt durch OpenThesaurus. Die Redewendungen
stammen aus OpenThesaurus (siehe DATENGRUNDLAGE oben). Diese Hinweise
stehen ebenfalls im "Über dieses Wörterbuch"-Fenster.

ERWEITERBARKEIT
-----------------
Sollten einzelne Wörter fehlen oder Ergänzungen gewünscht sein, kann
die Datei "data/definitions.js" von Hand angepasst werden (Format:
"Wort": {"b": ["Bedeutung 1"], "t": "Sil-ben-tren-nung" (wird als
"Trennung" in der Grammatik angezeigt), "w": "Substantiv", "g": "n",
"p": "Mehrzahl-Form", "h": "Herkunftstext", "s": ["Synonym 1"],
"r": ["Redewendung 1", "Redewendung 2"]}).
Wird ein neues Wort hinzugefügt, sollte es aus Konsistenzgründen auch
in "data/wordlist.js" ergänzt werden (Format: ["wort_klein", "Wort"],
alphabetisch nach dem ersten Listenelement sortiert), damit es auch in
der Autovervollständigung erscheint.

LIZENZHINWEISE
----------------
- Wiktionary-Inhalte: Wikimedia/Wiktionary, Lizenz CC BY-SA 4.0.
  Export-Tool: https://github.com/xxyzz/wiktionary_stardict
- OpenThesaurus-Inhalte (Synonyme, Redewendungen):
  https://www.openthesaurus.de, Lizenz LGPL 2.1 oder CC BY-SA 4.0
  (wahlweise).
- Trennmuster hyph_de_DE: LibreOffice/OpenOffice-Wörterbuchpaket,
  LGPL 2+ / LPPL (siehe https://github.com/LibreOffice/dictionaries).
