68725341a7
Image library: - "Clean up duplicates" finds byte-identical images by md5, keeps one file per group (preferring the most-used, then the oldest), merges the tags/descriptions and captions of the copies, repoints slides in open decks and in .md presentations on disk, and deletes the copies after a confirmation that lists every group. - A header toggle filters to images without tags/description, so it is easy to see which ones still need attention. - The delete warning now also lists presentations on disk that still reference the image (marked "not open"), next to the open decks. Editor and accessibility (already in tree): - Interface text scaling up to 200%, keyboard-operable panel divider, keyboard-first add-slide dialog, and screen-reader improvements. - Paste a spreadsheet/CSV/markdown selection into a table cell to fill the whole grid. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
175 lines
8.5 KiB
Markdown
175 lines
8.5 KiB
Markdown
# OciDeck — User Guide
|
||
|
||
OciDeck builds [Marp](https://marp.app/) presentations through a structured,
|
||
slide-by-slide editor. You compose typed slides, preview them live, present them
|
||
(on one or two screens), and export to Markdown, PDF, PPTX, or a self-contained
|
||
HTML file. Files stay standard Marp Markdown, so a deck remains usable in other
|
||
Marp tools.
|
||
|
||
## Creating and opening decks
|
||
|
||
- **New / Open**: use the welcome screen or `Ctrl/Cmd + O`. Multiple decks open in
|
||
**tabs**.
|
||
- **Save**: `Ctrl/Cmd + S`. Saving lays out a tidy project folder next to your
|
||
`.md` (`images/`, `data/`, `logos/`, `themes/`) and copies assets in. See
|
||
[`FILE_FORMAT.md`](FILE_FORMAT.md).
|
||
- **Crash recovery**: unsaved work is snapshotted automatically and offered back
|
||
after an unexpected exit.
|
||
|
||
## Slide types
|
||
|
||
Add a slide and pick a type: **title**, **section** divider, **bullets**, **two
|
||
bullet columns**, **bullets + image**, **two images**, **large image**, **video**,
|
||
**audio**, **quote**, **table**, **source code**, **chart** (bar, line, pie, or
|
||
spider/radar), and **free Markdown**. Each card in the chooser shows a miniature
|
||
wireframe of the layout, and the dialog works entirely with the keyboard
|
||
(`Tab`/`Enter` to choose, `Esc` to cancel). Each type has a dedicated editor on
|
||
the left and a live preview on the right.
|
||
|
||
Text fields support inline Markdown (`**bold**`, `*italic*`, `` `code` ``,
|
||
`[links](…)`). Free-Markdown slides also render fenced code with syntax
|
||
highlighting and `$…$` / `$$…$$` LaTeX math.
|
||
|
||
### Source-code slides
|
||
|
||
Choose a programming language for syntax highlighting (or "plain text") and paste
|
||
your code. It renders as a "code sheet" whose background, text colour and
|
||
**monospace font** come from the active **style profile** (e.g. Courier). Turn
|
||
**syntax colouring** off to show the whole block in a single colour — e.g. bright
|
||
green on black for a classic CRT-terminal look. The text is sized to fill the
|
||
panel — larger when there's room, smaller for long fragments. Stored as a fenced
|
||
code block in the Markdown.
|
||
|
||
### Tables
|
||
|
||
The first row is the header. Press `Enter` inside a cell for a new line within
|
||
that cell. To bring in existing data, **paste a table into any cell** with
|
||
`Ctrl/Cmd+V` (or `Shift+Insert`): a selection copied from a spreadsheet (Excel,
|
||
Numbers, LibreOffice Calc, Google Sheets), CSV text (comma- or
|
||
semicolon-separated), or a markdown table fills the grid from that cell onward,
|
||
adding rows and columns as needed. Ordinary text — even a sentence with a comma
|
||
in it — still pastes into just the one cell.
|
||
|
||
### Charts
|
||
|
||
Pick a type (**bar**, **line**, **pie**, or **spider/radar**) and a title, then
|
||
enter data in the grid: the first column is the labels, each further column is a
|
||
named series. Use **Row** and **Series** to add data; the small ✕ removes a
|
||
row/column. Each series and (for pie/radar) each label can be given its own colour.
|
||
|
||
- **CSV import** — click **CSV importeren**. You can either keep the data **in the
|
||
slide** (inline) or store it **as a CSV file**. A linked CSV lives in the deck's
|
||
`data/` directory and stays the source of truth (edit it in a spreadsheet); the
|
||
grid then shows it read-only until you **Ontkoppelen** (unlink).
|
||
- **Min/max** (optional, bar/line/radar) — on bar and line charts these draw
|
||
horizontal **reference lines**; on a spider/radar chart they fix the **scale**
|
||
(centre to outer ring), shown as evenly spaced values in a small legend beside
|
||
the chart. Leave them empty to scale automatically.
|
||
- **Reading values** — hovering a legend entry highlights its series (or pie
|
||
slice). On a line chart the tooltip belongs to the dot under the cursor and
|
||
shows every overlapping dot at once; on a spider/radar chart hovering a point
|
||
shows its value in a tooltip too. For screen readers every chart also carries
|
||
a text alternative with its type, title, and the values per series.
|
||
- Charts render in the preview, presenter, PDF, and PPTX, and as inline SVG in the
|
||
HTML export.
|
||
|
||
## Image library
|
||
|
||
Image fields open a library that shows every image found in the deck's
|
||
directories, with a grid and a coverflow view, search, and a preview pane. Per
|
||
image you can store a **caption** (source/credit line, shown on the slide) and a
|
||
searchable **description** — in practice your tags. The search box matches file
|
||
names and descriptions.
|
||
|
||
- **Filter untagged images** — the label toggle next to the search box shows
|
||
only images that have no description/tags yet, so you can see at a glance
|
||
which ones still need attention.
|
||
- **Clean up duplicates** — the button in the footer finds byte-identical
|
||
images by md5 checksum. Per group one file is kept (preferring the one used
|
||
in slides, then the oldest), tags and captions of the copies are merged onto
|
||
it, slides that referenced a copy are repointed to the kept file, and the
|
||
copies are deleted — after a confirmation that lists exactly what will
|
||
happen. References are updated in the open decks *and* in `.md`
|
||
presentations found on disk in the search directories, so presentations
|
||
that are not currently open keep working too.
|
||
- **Deleting an image** warns when it is still in use — in open decks (per
|
||
slide) and in presentations on disk that are not currently open (per file,
|
||
marked "not open").
|
||
|
||
## Per-slide options
|
||
|
||
Below each editor you can set:
|
||
|
||
- **Auto-advance** after N seconds.
|
||
- **TLP of this slide** — a Traffic Light Protocol level (see below).
|
||
- Show/hide the **logo** and **footer** on this slide.
|
||
- **Speaker notes**.
|
||
- An optional **audio** attachment.
|
||
|
||
## Traffic Light Protocol (TLP)
|
||
|
||
A deck has an overall TLP level (shown as a marking on the slides). Each slide can
|
||
*also* carry its own level. When you present or export, slides whose level is
|
||
**stricter** than the level chosen for the deck are **withheld** — so the same
|
||
deck can be shown safely to audiences with different clearances. Order, least to
|
||
most restrictive: none < CLEAR < GREEN < AMBER < AMBER+STRICT < RED.
|
||
|
||
## Presenting
|
||
|
||
Start the fullscreen presenter from the toolbar. See
|
||
[`SHORTCUTS.md`](SHORTCUTS.md) for the full key list; highlights: arrows to move,
|
||
`G` for the grid overview, `B`/`W` to blank, `P` for presenter view, `H` for the
|
||
in-app cheatsheet.
|
||
|
||
### Two screens (beamer + laptop)
|
||
|
||
When a second display is connected, OciDeck automatically shows the **slide on the
|
||
beamer** and the **presenter view on your laptop** (current slide, next slide,
|
||
notes, clock). Use an *extended* (not mirrored) display. Notes:
|
||
|
||
- The keyboard stays on the laptop; clicking the beamer also advances.
|
||
- On macOS the "external" screen is the one without the menu bar.
|
||
|
||
### Annotating while presenting
|
||
|
||
Draw on the slide live with **D** pen, **T** highlighter, **E** eraser, **X**
|
||
laser pointer, and **C** to clear; `Esc` puts the tool away. Drawings are a
|
||
separate layer (never written into the Marp Markdown), mirror live to the beamer,
|
||
and are saved in a `<name>.ink.json` sidecar so they persist with the deck.
|
||
|
||
## Exporting
|
||
|
||
Export to:
|
||
|
||
- **PDF** and **PPTX** (PPTX includes speaker notes) — rendered from the in-app
|
||
slide renderer.
|
||
- **Self-contained HTML** — one offline file; code highlighting, math, charts, and
|
||
mermaid diagrams render in the browser.
|
||
- **Portable package** (`.ocideck`) — a single zip with the Markdown and all
|
||
assets, to hand the whole deck to someone else.
|
||
|
||
## Accessibility
|
||
|
||
OciDeck aims for WCAG 2.1 in the editor:
|
||
|
||
- **Interface text size** — Settings → General → Accessibility offers 100–200%
|
||
text scaling for the whole editing environment, on top of what the operating
|
||
system asks for. Slides keep their fixed 16:9 design size, so what you see is
|
||
still exactly what you present and export.
|
||
- **Keyboard** — the panel divider between the slide list and the editor can be
|
||
focused with `Tab` and resized with `←`/`→`; the add-slide dialog is fully
|
||
keyboard-operable.
|
||
- **Screen readers** — slide thumbnails announce a concise label ("Slide 3/12:
|
||
title", including the skipped state), charts read out their data as a text
|
||
alternative, and the fullscreen presenter announces every slide change.
|
||
|
||
## Theming and language
|
||
|
||
- **Style profiles** control deck colours (including the source-code background,
|
||
text, font and an optional syntax-colouring toggle), fonts, logo, and footer.
|
||
Every colour can be picked from the presets or entered as a custom hex value. The
|
||
Colours and Logo tabs show which profile you're editing. The bundled Marp theme
|
||
is `assets/themes/ocideck.css`.
|
||
- **App appearance** (including a dark interface) is configurable in settings.
|
||
- The interface is available in Dutch, English, Italian, German, French, Spanish,
|
||
Frisian, and Papiamento.
|