Ocideck/docs/SHORTCUTS.md
Brenno de Winter b719c43991 Add presentation timer / rehearsal mode to the presenter
The presenter view now doubles as a rehearsal clock that measures without
coaching: a countdown against a target time, the time spent on the current
slide, and an end-of-run summary (total vs. target and per-slide times, with
copy-to-clipboard). Timing lives in a plain, unit-tested RehearsalController fed
via an idempotent observe() on every build, so it captures every navigation
path. The default target is stored in AppSettings; live adjustment is the K key
(typed as MMSS). All rehearsal state is session-only -- nothing is written to
disk or into the .md file.

- New: models/rehearsal.dart, services/rehearsal_controller.dart,
  widgets/presentation/rehearsal_summary.dart, plus a controller unit test.
- Presenter: countdown + per-slide timer in the clock bar, K to set the target,
  R resets the run, end-of-run summary dialog, and help/cheatsheet entries.
- Settings: presentationTargetSeconds (default target) with a dropdown in the
  General tab, threaded into FullscreenPresenter.present().
- l10n: new Dutch source strings translated in all seven languages.
- Docs: README, CHANGELOG, USER_GUIDE, SHORTCUTS, ARCHITECTURE.

Also bundles a pre-existing in-progress change already in the working tree: wire
the existing ThemeProfile.tableHeaderBackgroundColor into table rendering
(preview, HTML export, file_service) and the settings dialog, plus its
translations.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 07:03:08 +02:00

63 lines
2.1 KiB
Markdown

# OciDeck — Keyboard shortcuts
`Ctrl` is shown for Windows/Linux; use `Cmd` (⌘) on macOS.
## Editor (app-wide)
| Shortcut | Action |
| --- | --- |
| `Ctrl/Cmd + O` | Open a presentation |
| `Ctrl/Cmd + S` | Save the active deck |
| `Ctrl/Cmd + Z` | Undo |
| `Ctrl/Cmd + Shift + Z` | Redo |
| `Ctrl + Y` | Redo (alternative) |
| `Ctrl/Cmd + H` | Find & replace |
| `Ctrl/Cmd + V` (in a table cell) | Paste a spreadsheet/CSV/markdown selection as a table (also `Shift + Insert`) |
| `Tab` to the panel divider, then `←` / `→` | Resize the slide panel |
In the **add-slide dialog**, `Tab` moves between the type cards, `Enter` picks
the focused one, and `Esc` cancels.
## Fullscreen presenter
Navigation:
| Shortcut | Action |
| --- | --- |
| `→` · `Space` · `Page Down` · click | Next slide |
| `←` · `Page Up` | Previous slide |
| `Enter` | Next slide (or jump, if a number was typed) |
| digits, then `Enter` | Jump to that slide number |
| `Home` · `End` | First · last slide |
| `G` | Slide-grid overview (arrows + `Enter` to jump) |
View & timing:
| Shortcut | Action |
| --- | --- |
| `P` | Toggle presenter view (notes, clock, countdown, per-slide timer, next slide) |
| `S` | Move the presentation to another screen |
| `B` · `W` | Black · white screen |
| `K` | Set the target time / countdown (type `MMSS`, `Enter` to confirm, `0` = off) |
| `R` | Reset the time & rehearsal run (elapsed and per-slide timings; the target stays) |
| `A` | Auto-advance on/off |
| `L` | Loop (restart after the last slide) on/off |
| `M` | Advance automatically after a slide's audio finishes |
| `H` · `?` | Show the in-app shortcut cheatsheet |
Annotation tools:
| Shortcut | Action |
| --- | --- |
| `D` | Pen |
| `T` | Highlighter |
| `E` | Eraser |
| `X` | Laser pointer |
| `C` | Clear the current slide's annotations |
`Esc` is layered: it first puts away the active annotation tool, then clears a
typed slide number, then removes a black/white screen, and finally exits the
presentation.
> In **dual-screen** mode the keyboard stays with the laptop (presenter) window;
> clicks on the beamer also advance the slide.