Feature: Integrierte Hilfe (F1) in der GUI #69

New Issue

2026-04-29T06:53:12+02:00

marcus commented

2026-04-29 06:53:12 +02:00

Beschreibung

Beim Drücken von F1 soll innerhalb der Anwendung eine kontextsensitive oder allgemeine Hilfe angezeigt werden – ohne externen Browser oder separate Datei öffnen zu müssen.

Gewünschtes Verhalten

F1 öffnet ein Hilfefenster oder einen Dialog direkt in der Anwendung
Inhalt: Bedienungsanleitung, Erklärung der wichtigsten Konzepte (Quellordner, Zielordner, Provider, Status-Icons usw.)
Optional: Kontextsensitiv – je nach aktivem Tab zeigt F1 die Hilfe für genau diesen Bereich

Technische Optionen (zur Entscheidung)

Option	Beschreibung	Aufwand
JavaFX WebView mit lokaler HTML	Rendert eine gebundelte HTML-Hilfe; unterstützt Formatierung, Links und Bilder	Mittel
Einfaches Textfenster	`TextArea` oder `Label` in einem `Dialog`; schnell zu bauen, kein HTML-Authoring	Gering
Externe Datei im Browser	Öffnet `gui-bedienanleitung.md` o. ä. im Systembrowser	Sehr gering

Empfehlung: Zunächst einfache Lösung (lokale HTML via WebView oder externe Datei im Browser) – kein Aufwand für Parallelformate.

Architektur-Hinweis

Reines GUI-Feature im Modul adapter-in-gui
Kein neuer Port oder Application-Use-Case erforderlich
Tastaturkürzel F1 muss auf allen Tabs aktiv sein → globaler KeyEvent-Handler auf der Scene

Abhängigkeiten

Issue #66 (Tooltips) – ergänzt die Hilfe auf Feldebene; beide Issues zusammen bilden das Usability-Paket

## Beschreibung Beim Drücken von `F1` soll innerhalb der Anwendung eine kontextsensitive oder allgemeine Hilfe angezeigt werden – ohne externen Browser oder separate Datei öffnen zu müssen. ## Gewünschtes Verhalten - `F1` öffnet ein Hilfefenster oder einen Dialog direkt in der Anwendung - Inhalt: Bedienungsanleitung, Erklärung der wichtigsten Konzepte (Quellordner, Zielordner, Provider, Status-Icons usw.) - Optional: Kontextsensitiv – je nach aktivem Tab zeigt `F1` die Hilfe für genau diesen Bereich ## Technische Optionen (zur Entscheidung) | Option | Beschreibung | Aufwand | |---|---|---| | **JavaFX WebView mit lokaler HTML** | Rendert eine gebundelte HTML-Hilfe; unterstützt Formatierung, Links und Bilder | Mittel | | **Einfaches Textfenster** | `TextArea` oder `Label` in einem `Dialog`; schnell zu bauen, kein HTML-Authoring | Gering | | **Externe Datei im Browser** | Öffnet `gui-bedienanleitung.md` o. ä. im Systembrowser | Sehr gering | Empfehlung: Zunächst einfache Lösung (lokale HTML via WebView oder externe Datei im Browser) – kein Aufwand für Parallelformate. ## Architektur-Hinweis - Reines GUI-Feature im Modul `adapter-in-gui` - Kein neuer Port oder Application-Use-Case erforderlich - Tastaturkürzel `F1` muss auf allen Tabs aktiv sein → globaler `KeyEvent`-Handler auf der `Scene` ## Abhängigkeiten - Issue #66 (Tooltips) – ergänzt die Hilfe auf Feldebene; beide Issues zusammen bilden das Usability-Paket

marcus referenced this issue

2026-04-29 06:55:10 +02:00

Feature: Tooltips an Buttons, Feldern und Status-Icons #66

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: marcus/pdf-umbenenner#69