mdeck 3.3.0 → 3.5.0

package/assets/extensions/themes/work/styles.css

@@ -0,0 +1,512 @@
+/* Work — an everyday company template.
+   What a good office template does, and nothing more: an accent band along
+   the top of every slide, the logo (or the organisation's name) at the top
+   left of the title slide, every heading in the same place at the top with
+   the content below it, section dividers with a large number in the
+   accent, and a quiet footer with a hairline, the author and the page
+   number. IBM Plex
+   Sans throughout, square bullets, striped tables. Any palette turns it
+   into a company's own template; all colours are the palette's. */
+
+/* ─────────────────────────────────────────────
+   THE BAND — along the top of every slide
+   ───────────────────────────────────────────── */
+.slide::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: var(--band);
+  background: var(--accent);
+  z-index: 3;
+  pointer-events: none;
+}
+
+/* ─────────────────────────────────────────────
+   HEADER / FOOTER
+   ───────────────────────────────────────────── */
+.slide-header {
+  position: relative;
+  z-index: 2;
+  min-height: 40px;
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 500;
+  letter-spacing: 0.02em;
+  color: var(--muted);
+}
+.slide-header .brand {
+  font-weight: 600;
+  font-size: 26px;
+  letter-spacing: 0;
+  color: var(--ink);
+}
+/* A logo stands where the name would, at the top left, and replaces it. */
+.slide-header:has(.slide-logo) .brand { visibility: hidden; width: 0; }
+.slide-logo {
+  position: absolute;
+  top: var(--pad-y);
+  left: var(--pad-x);
+  height: 72px;
+  width: auto;
+  max-width: 360px;
+  object-fit: contain;
+  object-position: left center;
+  filter: var(--logo-filter, none);
+  transform: translateY(calc(20px - 50%));
+}
+
+.slide-footer {
+  position: relative;
+  z-index: 2;
+  font-family: var(--font-body);
+  font-size: var(--fs-small);
+  color: var(--muted);
+  border-top: 1px solid var(--rule);
+  padding-top: 18px;
+  margin-top: 24px;
+}
+.slide-footer > span:last-child:not(:first-child) {
+  font-variant-numeric: tabular-nums;
+  font-weight: 600;
+  color: var(--ink);
+}
+
+/* ─────────────────────────────────────────────
+   TYPOGRAPHY
+   ───────────────────────────────────────────── */
+.eyebrow {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 600;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--accent);
+  margin: 0;
+}
+.display {
+  font-family: var(--font-display);
+  font-size: var(--fs-display);
+  font-weight: 600;
+  line-height: 1.04;
+  letter-spacing: -0.025em;
+  color: var(--ink);
+  margin: 0;
+  text-wrap: balance;
+}
+.title {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 600;
+  line-height: 1.12;
+  letter-spacing: -0.015em;
+  color: var(--ink);
+  margin: 0;
+  text-wrap: balance;
+}
+.subtitle {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  line-height: 1.3;
+  color: var(--ink-soft);
+  margin: 0;
+  text-wrap: pretty;
+}
+.body-text {
+  font-family: var(--font-body);
+  font-size: var(--fs-body);
+  line-height: 1.5;
+  color: var(--ink-soft);
+  margin: 0;
+  text-wrap: pretty;
+}
+.meta { font-family: var(--font-body); font-size: var(--fs-small); color: var(--muted); }
+
+em { font-style: normal; font-weight: 600; color: var(--accent); }
+strong { font-weight: 600; color: var(--ink); }
+
+/* ─────────────────────────────────────────────
+   CONTENT SLIDE — the heading at the top, the content below it
+   ───────────────────────────────────────────── */
+.slide:not(.slide--title, .slide--chapter, .slide--focus, .slide--full-bleed-image) > .slide-body {
+  justify-content: flex-start;
+  padding-top: 20px;
+}
+.slide-body h1 {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 600;
+  line-height: 1.12;
+  letter-spacing: -0.015em;
+  color: var(--ink);
+  margin: 0 0 var(--gap-title) 0;
+  max-width: 1500px;
+  text-wrap: balance;
+}
+.slide-body h2 {
+  font-family: var(--font-display);
+  font-size: var(--fs-sub);
+  font-weight: 600;
+  line-height: 1.2;
+  color: var(--ink);
+  margin: 0 0 var(--gap-item) 0;
+}
+.slide-body h3 {
+  font-family: var(--font-display);
+  font-size: var(--fs-body);
+  font-weight: 600;
+  color: var(--ink);
+  margin: 0 0 10px 0;
+}
+.slide-body p {
+  font-family: var(--font-body);
+  font-size: var(--fs-body);
+  line-height: 1.5;
+  color: var(--ink-soft);
+  margin: 0 0 var(--gap-item) 0;
+  max-width: 1500px;
+  text-wrap: pretty;
+}
+.slide-body :not(pre) > code {
+  font-family: var(--font-mono);
+  font-size: 0.88em;
+  padding: 0.05em 0.3em;
+  background: var(--surface);
+  border-radius: 3px;
+  color: var(--ink);
+}
+
+/* ─────────────────────────────────────────────
+   LISTS — square bullets, numbers in the accent
+   ───────────────────────────────────────────── */
+.slide-body ul > li { line-height: 1.4; padding-left: 40px; }
+.slide-body ul > li::before {
+  content: '';
+  position: absolute;
+  left: 2px;
+  top: calc(0.7em - 6px);
+  width: 12px;
+  height: 12px;
+  background: var(--accent);
+}
+/* A point inside a point: a dash. */
+.slide-body li ul > li { padding-left: 34px; }
+.slide-body li ul > li::before {
+  top: calc(0.7em - 1.5px);
+  width: 16px;
+  height: 3px;
+  background: var(--muted);
+}
+.slide-body ol > li { line-height: 1.4; padding-left: 52px; }
+.slide-body ol > li::before {
+  content: counter(slide-ol) '.';
+  position: absolute;
+  left: 0;
+  top: 0;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+  color: var(--accent);
+}
+
+/* ─────────────────────────────────────────────
+   LAYOUT: TITLE — the title at the lower left, under a short rule
+   ───────────────────────────────────────────── */
+/* A broader band on the title slide and the section dividers. */
+:is(.slide--title, .slide--chapter)::before { height: calc(var(--band) * 2); }
+.slide--title .slide-body {
+  justify-content: flex-end;
+  align-items: flex-start;
+  padding-bottom: 24px;
+}
+.slide--title .title-text { display: flex; flex-direction: column; align-items: flex-start; max-width: 1400px; }
+.slide--title .title-text::before {
+  content: '';
+  width: 120px;
+  height: 8px;
+  background: var(--accent);
+  margin-bottom: 48px;
+}
+/* The title is an h1: as large as .display, not a content heading. */
+.slide--title .display { font-size: var(--fs-display); margin: 0; }
+.slide--title .subtitle { margin-top: 28px; max-width: 1200px; }
+
+/* With a picture: the picture fills the right of the slide, edge to edge. */
+.slide--title.has-image .title-text { max-width: 54%; }
+.slide--title.has-image .display { font-size: calc(var(--fs-display) * 0.72); }
+.slide--title.has-image .title-image {
+  position: absolute;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  width: 40%;
+  height: 100%;
+  max-height: none;
+  object-fit: cover;
+  z-index: 1;
+}
+.slide--title.has-image .slide-header > span:last-child:not(.brand) { visibility: hidden; }
+/* The footer's hairline stops short of the picture (40% of 1920px, and a gap). */
+:is(.slide--title, .slide--chapter).has-image .slide-footer { margin-right: 712px; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: CHAPTER — a section divider: the number in the accent, a broader band
+   ───────────────────────────────────────────── */
+.slide--chapter .slide-body { justify-content: flex-end; align-items: flex-start; padding-bottom: 32px; }
+.chapter-num {
+  font-family: var(--font-display);
+  font-size: 200px;
+  font-weight: 300;
+  line-height: 0.9;
+  letter-spacing: -0.04em;
+  font-variant-numeric: tabular-nums;
+  color: var(--accent);
+  margin: 0 0 40px -6px;
+}
+.chapter-meta {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 600;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--muted);
+  margin: 0 0 16px 0;
+}
+.slide--chapter .chapter-title {
+  font-family: var(--font-display);
+  font-size: var(--fs-title);
+  font-weight: 600;
+  line-height: 1.04;
+  letter-spacing: -0.025em;
+  color: var(--ink);
+  margin: 0 0 28px 0;
+  max-width: 1400px;
+  text-wrap: balance;
+}
+.slide--chapter .chapter-desc {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  line-height: 1.35;
+  color: var(--ink-soft);
+  max-width: 1100px;
+  margin: 0;
+}
+/* With a picture: the picture fills the right of the slide, edge to edge. */
+.slide--chapter.has-image .chapter-content { max-width: 52%; }
+.slide--chapter.has-image .chapter-title { font-size: calc(var(--fs-title) * 0.78); }
+.slide--chapter.has-image .chapter-image {
+  position: absolute;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  width: 40%;
+  height: 100%;
+  max-height: none;
+  object-fit: cover;
+  z-index: 1;
+}
+.slide--chapter.has-image .slide-header > span:last-child:not(.brand) { visibility: hidden; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: FOCUS — the key message, flush left beside an accent bar
+   ───────────────────────────────────────────── */
+.slide--focus .slide-body { justify-content: center; align-items: flex-start; }
+.focus-eyebrow {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 600;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--accent);
+  margin: 0 0 32px 58px;
+}
+.focus-content {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  border-left: 10px solid var(--accent);
+  padding: 6px 0 10px 48px;
+}
+.focus-statement,
+.slide--focus .focus-content h1,
+.slide--focus .focus-content p {
+  font-family: var(--font-display);
+  font-size: var(--fs-focus);
+  font-weight: 600;
+  line-height: 1.15;
+  letter-spacing: -0.02em;
+  color: var(--ink);
+  max-width: 1450px;
+  margin: 0;
+  text-wrap: balance;
+}
+.focus-attribution {
+  font-family: var(--font-body);
+  font-size: var(--fs-body);
+  color: var(--muted);
+  margin: 32px 0 0 58px;
+}
+
+/* ─────────────────────────────────────────────
+   LAYOUT: IMAGE + TEXT
+   ───────────────────────────────────────────── */
+.slide--image-text .slide-body { gap: 80px; }
+.image-pane {
+  flex: 1.05;
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--surface);
+  overflow: hidden;
+  position: relative;
+  border-radius: 4px;
+}
+.image-placeholder {
+  width: 100%;
+  height: 100%;
+  background: repeating-linear-gradient(135deg, var(--surface) 0 22px, var(--bg) 22px 44px);
+}
+.image-placeholder span {
+  font-family: var(--font-mono);
+  font-size: 20px;
+  color: var(--muted);
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  background: var(--bg);
+  padding: 12px 18px;
+  border: 1px solid var(--rule);
+}
+.text-pane .title { font-size: var(--fs-h); }
+.text-pane .body-text + .body-text { margin-top: 8px; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: SPLIT — two columns with a hairline between them
+   ───────────────────────────────────────────── */
+.split-columns { gap: 0; }
+.slide--split :is(.split-left, .split-right) { padding: 0 56px; }
+.slide--split .split-left { padding-left: 0; border-right: 1px solid var(--rule); }
+.slide--split .split-right { padding-right: 0; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: FULL-BLEED IMAGE — the title on a label at the lower left
+   ───────────────────────────────────────────── */
+.slide--full-bleed-image .slide-body { align-items: flex-start; }
+.slide--full-bleed-image.has-overlay .slide-bg::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(to top, color-mix(in oklab, var(--ink) 30%, transparent), transparent 50%);
+}
+.slide--full-bleed-image .overlay-title {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 600;
+  line-height: 1.12;
+  letter-spacing: -0.015em;
+  color: var(--ink);
+  background: var(--bg);
+  border-left: 10px solid var(--accent);
+  padding: 28px 44px 32px 40px;
+  margin: 0;
+  max-width: 1300px;
+  text-wrap: balance;
+}
+
+/* ─────────────────────────────────────────────
+   TABLES — a ruled header, striped rows
+   ───────────────────────────────────────────── */
+.slide-body table { font-size: calc(var(--fs-body) * 0.9); font-variant-numeric: tabular-nums; }
+.slide-body th {
+  font-weight: 600;
+  color: var(--ink);
+  border-bottom: 2px solid var(--accent);
+}
+.slide-body td { border-bottom: 0; }
+.slide-body tbody tr:nth-child(odd) td { background: var(--surface); }
+
+/* ─────────────────────────────────────────────
+   CALLOUTS — a surface with a coloured bar
+   ───────────────────────────────────────────── */
+.slide-body .callout {
+  --bar: var(--accent);
+  background: var(--surface);
+  border: 0;
+  border-left: 8px solid var(--bar);
+  border-radius: 0 4px 4px 0;
+  padding: 22px 32px 24px;
+  margin: 14px 0 0;
+  max-width: 1500px;
+}
+.slide-body .callout-title {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  margin: 0 0 8px 0;
+}
+.slide-body .callout p { padding-left: 0; margin: 0; color: var(--ink); }
+.slide-body .callout-note { --bar: var(--callout-note); }
+.slide-body .callout-tip { --bar: var(--callout-tip); }
+.slide-body .callout-important { --bar: var(--callout-important); }
+.slide-body .callout-warning { --bar: var(--callout-warning); }
+.slide-body .callout-caution { --bar: var(--callout-caution); }
+.slide-body .callout-definition { --bar: var(--accent-2); }
+
+/* ─────────────────────────────────────────────
+   CODE
+   ───────────────────────────────────────────── */
+.code-block {
+  --code-bg: var(--surface);
+  --code-radius: 4px;
+  --code-size: 25px;
+  background: var(--code-bg);
+  border-radius: var(--code-radius);
+  border: 1px solid var(--rule);
+  padding: 28px 36px;
+  margin: 0;
+  overflow: hidden;
+  font-family: var(--font-mono);
+  font-size: var(--code-size);
+  line-height: 1.55;
+}
+.code-block code { font-family: inherit; font-size: inherit; background: none; padding: 0; }
+.slide-body .code-block-wrapper { margin: 24px 0; }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — a large quotation mark in the accent, hanging beside
+   the quote
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  position: relative;
+  margin: 0 0 var(--gap-item);
+  padding: 0 0 0 64px;
+  border: 0;
+  max-width: 1300px;
+  font-size: calc(var(--fs-body) * 1.1);
+  font-weight: 500;
+  line-height: 1.4;
+  color: var(--ink);
+}
+.slide-body blockquote::before {
+  content: '\201C';
+  position: absolute;
+  left: 0;
+  top: -0.12em;
+  font-family: var(--font-display);
+  font-size: 104px;
+  font-weight: 600;
+  line-height: 1;
+  color: var(--accent);
+}
+
+/* ─────────────────────────────────────────────
+   FOOTNOTES, MATH, AUDIENCE QUESTIONS
+   ───────────────────────────────────────────── */
+.slide-footnotes, .slide-citations { font-family: var(--font-body); }
+.slide .katex-display { font-size: var(--fs-sub); margin: 32px 0; overflow-x: auto; overflow-y: hidden; text-align: left; }
+.slide .poll-track, .slide .scale-track { border-radius: 2px; background: var(--surface); }
+.slide .poll-fill, .slide .scale-fill { border-radius: 2px; background: var(--accent); }
+.slide .question-cards li { border-radius: 4px; border-left: 6px solid var(--accent); background: var(--surface); }

package/docs/reference/authoring.md

@@ -41,7 +41,7 @@ Each `---` line starts a new slide. Frontmatter is only needed when you want a s
 | Field | Default | Description |
 |---|---|---|
 | `theme` | `neue` | Theme name |
-| `palette` | _(theme default)_ | Colour palette: `swiss`, `nordic`, `neon`, `lagoon`, `paper`, one installed from the theme repository, or one of your own |
+| `palette` | _(theme default)_ | Colour palette: `swiss`, `nordic`, `cobalt`, `greyscale`, `lagoon`, `paper`, one installed from the theme repository, or one of your own |
 | `appearance` | _(theme default)_ | `light` or `dark`: which variant of the palette the slides use |
 | `meta.title` | — | Deck title (shown in footer) |
 | `meta.author` | — | Author name (shown in footer) |
@@ -108,11 +108,13 @@ view is reachable in any build through `?view=reader`.
 | Key | Description |
 |---|---|
 | `neue` | Swiss style: Inter Tight and Inter, large flush-left type, a rule across the top, square accent markers, red on white |
-| `aurora` | Northern lights: Plus Jakarta Sans, curtains of light in the palette's accents, night-sky chapter slides, frosted glass |
 | `minimal` | Nothing but the content: the system's own fonts (no web fonts, works offline), medium weights, space instead of rules and boxes |
 | `academic` | A lecture: Source Sans and Source Serif, compact type with the heading fixed at the top and the content centred below, theorem and definition blocks, booktabs tables, a footnote rule |
+| `plain` | Black on white and lots of room: Inter, the heading in a column of its own beside the content, the accent only in small places |
+| `work` | An everyday company template: IBM Plex Sans, an accent band along the top, the logo top left, headings in a fixed place, numbered section dividers, a footer with the page number |
+| `glass` | Liquid glass, dark by default: Geist, soft pools of light behind every slide, titles on a frosted pane, glass beads for list markers |
 
-More themes (duet, editorial, fhnw, terminal, sketch) are in the theme
+More themes (aurora, duet, editorial, fhnw, terminal, sketch and others) are in the theme
 repository: `mdeck themes search` lists them, and
 `mdeck themes install <theme> <deck>.md` puts one beside the deck.
 
@@ -128,12 +130,13 @@ Each palette has a light and a dark variant; `appearance:` picks one.
 | Key | Light | Dark |
 |---|---|---|
 | `swiss` | White, black, signal red (neue's default) | Black, white, red |
-| `nordic` | Ice grey, navy, steel blue (academic's default) | Polar night, ice blue |
-| `neon` | White, violet, magenta (aurora's default) | Black, neon violet and pink |
+| `nordic` | Ice grey, navy, steel blue (academic's and glass's default) | Polar night, ice blue |
+| `cobalt` | Ultramarine on white, vivid orange (work's default) | Midnight blue, bright blue and orange |
+| `greyscale` | Black, white and greys only (plain's default) | The same, inverted |
 | `lagoon` | Teal on warm stone | Bright teal on teal-black |
 | `paper` | Off-white, near-black, orange (minimal's default) | Charcoal, soft orange |
 
-More palettes (cobalt, terra, phosphor, pastel, forest, among others)
+More palettes (neon, terra, phosphor, pastel, forest, among others)
 are in the theme repository; install them with `mdeck palettes install <palette> <deck>.md`.
 
 ---
@@ -592,6 +595,20 @@ labels:
 | `follow.tryHere` | Try following here | Mitverfolgen hier ausprobieren |
 | `question.empty` | Answers appear here. | Hier erscheinen die Antworten. |
 | `scale.average` | Average {n} | Durchschnitt {n} |
+| `poll.answeredOf` | {n} of {of} answered | {n} von {of} haben geantwortet |
+| `poll.closed` | Closed | Geschlossen |
+| `poll.several` | Several answers possible. | Mehrere Antworten möglich. |
+| `poll.pickSeveral` | Tap all that apply. | Alle zutreffenden antippen. |
+| `poll.thanksSeveral` | Thanks! You chose {choice}. Tap to change. | Danke! Gewählt: {choice}. Zum Ändern antippen. |
+| `respond.closed` | Closed: no more answers. | Geschlossen: keine weiteren Antworten. |
+| `respond.right` | Right! | Richtig! |
+| `respond.wrong` | Not quite. The right answer: {answer} | Leider nicht. Richtig ist: {answer} |
+| `respond.solution` | The right answer: {answer} | Richtig ist: {answer} |
+| `numeric.placeholder` | A number | Eine Zahl |
+| `numeric.invalid` | Enter a number, such as 0.5 or 1/2. | Eine Zahl eingeben, z. B. 0,5 oder 1/2. |
+| `numeric.sent` | Sent: {value}. Send another to change. | Gesendet: {value}. Zum Ändern eine andere senden. |
+| `numeric.other` | Other | Andere |
+| `numeric.right` | {n} right | {n} richtig |
 
 ---
 
@@ -742,24 +759,47 @@ For `play="auto"` the video pauses and resets to the beginning when you navigate
 | Attribute | Default | Description |
 |---|---|---|
 | `room` | `poll` | Name of the room that collects the answers; unique per poll in a deck. Letters, digits, `.`, `-`, `_` |
-| `options` | — | Answers separated by `\|` |
-| `question` | — | Question text; phones fall back to the slide heading |
+| `options` | — | Answers separated by `\|`. Markdown and `$…$` maths, as on a slide (see below). Or a list inside the tag |
+| `question` | — | Question text, Markdown and maths like `options`; phones fall back to the slide heading |
 | `qr` | `true` | `false` leaves out the QR code (shown earlier with `<qrcode join />`) |
-| `answer` | — | The right answer (several separated by `\|`): a button with a tick outlines its label, bar and count in green, also in the audience window and on paired devices. `--poll-correct` sets the colour |
+| `answer` | — | The right answer (several separated by `\|`): a button with a tick outlines its label, bar and count in green, also in the audience window and on paired devices, and each phone says whether its vote was right. `--poll-correct` sets the colour |
+| `multiple` | — | Each phone may pick several options; the slide and the phones say so. A vote is then the list of options picked, and is right when it is exactly the `answer` options |
+| `buttons` | — | `letters` puts A, B, C … before the options, and the phones show only those; `numbers` does the same with 1, 2, 3 …. For options better read on the slide, such as pictures (`options="![](a.svg)\|![](b.svg)"`) |
 | `results` | — | `hidden` starts with the results hidden, e.g. for peer instruction. A button with an eye shows or hides them (bars and counts) at any time, also in the audience window and on paired devices. Hidden, the audience window shows no bars; the presenter's own screens show them faint |
 
-Three more activities take the same `room`, `question` and `qr`:
+Four more activities take the same `room`, `question` and `qr`:
 
 | Tag | Attributes | Phones | Slide |
 |---|---|---|---|
 | `<scale>` | `min` (1), `max` (5), `low`, `high` | One button per number, `low`/`high` as labels | Count per number and the average; latest answer per device |
+| `<numeric>` | `answer`, `tolerance` (0), `limit` (6), `placeholder`, `results` | A number field: `0.5`, `0,5`, `1/2`, `1e-3`; latest answer per device | The most frequent answers as bars, the rest as Other; with `answer`, the tick marks the right ones, counts them and tells each phone |
 | `<wordcloud>` | `placeholder`, `limit` (60), `height` (520) | Text field, up to 40 characters, repeatable | A packed word cloud (d3-cloud): size by frequency, some words upright, case-insensitive |
 | `<question>` | `placeholder`, `limit` (8) | Text field, up to 200 characters, repeatable | The newest answers as cards |
 
 `<qrcode follow />` shows the link for following the slides on phones and laptops (`?view=follow`), with `mdeck run --network` or a hosted deck with a `server` setting; the phones' answer page links to it as well. `<qrcode join />` shows the deck's join code large with its link (`size`, default 420), for a slide that invites everyone once; activities after it can use `qr="false"`. QR codes (`<qrcode>`, activities) are SVG in the slide's `--ink` on a transparent background; `--qr-ink` and `--qr-bg` override the colours.
 
+Options and the question may use Markdown and maths, e.g. `options="$2x$|$x^2$|$\frac{x^3}{3}$"`. A `|` inside a formula, `code`, a link or a picture belongs to it (`$|x|$` is one option), and `\|` is a bar in plain text.
+
+For options that are more than a word, write them as a list inside the tag instead of `options`, one item each; `[x]` marks a right answer, in place of `answer`:
+
+```markdown
+<poll room="derivative" question="What is $\frac{d}{dx}\, x^2$?">
+
+- [x] $2x$
+- [ ] $x^2$
+- [ ] $\frac{x^3}{3}$
+
+</poll>
+```
+
+Each item is an option as written, with no `|` to split and nothing to escape; an item over several lines is one option. Plain `-` or `1.` items work too, with `answer` or without a right answer. The tag must hold nothing but the list; otherwise it is left as it is. The slide draws maths with KaTeX, the phones as MathML; votes and `answer` use the text as written. The other activities' `question`, and the scale's `low` and `high`, take Markdown and maths too.
+
 The slide shows live bars, the number of answers, a QR code and a short link. Phones never load the deck: they open the server's own answer page at `<server>/<code>`, where the six-digit session code is the same for every poll in the deck. The presenter's screen (the presenter view or a full deck window, never an embedded preview) announces the poll on the current slide with what the phones should show and the deck's look; the server only accepts that from the presenter. Between polls the phones wait. Each device's latest vote counts. The presenter can reset the room (hover over the results).
 
+Every activity has a lock button that closes it: answers after that do not count, and the phones say it is closed until it opens again. Polls and `<numeric>` also have the eye that hides or shows the results. Below the results, polls, scales and `<numeric>` count “12 of 31 answered” while phones are connected (people following the slides count as phones). The lock, the eye and the tick reach every screen of the talk, also after a reload: they are kept in the activity room's state on the server, which only the presenter may set, and phones read it there. Reset clears the answers and opens the activity again.
+
+While `mdeck run` runs, the answers are kept beside the deck in `<slides>.results.json`: per activity room, each answer with its time, the phones numbered per room (their ids are not kept), and, once an activity was closed, only the answers that counted. Reset takes a room out of the file; a new, empty server leaves the file alone. Builds, `mdeck send` and `mdeck pdf` show the kept answers where no room server answers (`--no-results` leaves them out), and `mdeck results [slides.md] [-o file.csv]` prints them as CSV: `room,phone,at,answer`, several picks joined by `|`.
+
 `--no-polls` leaves slides with an activity or a join code (`<qrcode join />`) out of `mdeck send`, `mdeck build --reader` and `mdeck pdf`; without it they show as a record of the talk. Saved drawings follow the remaining slides.
 
 Rooms run inside `mdeck run` (add `--network` so phones can reach it) or on a server started with `mdeck server`, set in the deck:

package/docs/reference/palettes.md

@@ -22,15 +22,16 @@ The presenter view and the reader view switch palette and light or dark without
 |---|---|---|
 | `swiss` | white, black and signal red | black, white and red |
 | `nordic` | ice grey, deep navy and a cool steel blue | polar night with ice blue |
-| `neon` | white with violet and magenta | black with neon violet and pink |
+| `cobalt` | strong ultramarine on white, vivid orange | midnight blue, bright blue and orange |
+| `greyscale` | black, white and greys only, code and callouts too | the same, inverted |
 | `lagoon` | teal on warm stone, orange second accent | deep teal-black, bright teal |
 | `paper` | off-white paper and near-black ink with one orange accent | charcoal with a softer orange |
 
 `mdeck list palettes` lists them, with any of your own.
 
-Each theme names a default: neue uses `swiss`, academic `nordic`, aurora `neon`.
+Each theme names a default: neue uses `swiss`, academic and glass `nordic`, minimal `paper`, plain `greyscale`, work `cobalt`.
 
-More palettes are in the [theme repository](https://github.com/tilman-schieber/mdeck-themes). The palettes cobalt, terra, phosphor, pastel and forest, built in before mdeck 3.0, are there; installing the theme duet, editorial, terminal or sketch brings its palette along. Graphite and ember were removed because the built-in nordic and paper look almost the same; a deck that names them is told which to use. Install one with `mdeck palettes install <palette> my-talk.md`.
+More palettes are in the [theme repository](https://github.com/tilman-schieber/mdeck-themes). The palettes that used to come with mdeck are there: terra, phosphor, pastel, forest and neon; installing the theme editorial, terminal, sketch or aurora brings its palette along. Graphite and ember were removed because the built-in nordic and paper look almost the same; a deck that names them is told which to use. Install one with `mdeck palettes install <palette> my-talk.md`.
 
 ## Colours
 

package/docs/reference/themes.md

@@ -17,16 +17,18 @@ theme: neue
 | Theme | Look | Default palette |
 |---|---|---|
 | `neue` | Swiss style: large flush-left type, rules, red on white | `swiss` |
-| `aurora` | Northern lights: curtains of light, night-sky chapters, frosted glass | `neon` |
 | `minimal` | Nothing but the content: system fonts, calm type, no decoration; works offline | `paper` |
 | `academic` | A lecture: compact type, the heading fixed at the top and the content centred below, theorem and definition blocks, booktabs tables, a footnote rule | `nordic` |
+| `plain` | Black on white and lots of room: the heading in a column beside the content, the accent only in small places | `greyscale` |
+| `work` | An everyday company template: accent band, logo top left, headings in a fixed place, numbered section dividers, a footer | `cobalt` |
+| `glass` | Liquid glass, dark by default: pools of light, frosted titles, glass list markers | `nordic` |
 
 `mdeck list my-talk.md` lists them with their descriptions.
 
 More themes are in the [theme repository](https://github.com/tilman-schieber/mdeck-themes):
 `mdeck themes search` lists them, and `mdeck themes install <theme> my-talk.md`
-puts one beside the deck, with its default palette. The themes duet, editorial,
-fhnw, terminal and sketch, built in before mdeck 3.0, are there.
+puts one beside the deck, with its default palette. The themes that used to come
+with mdeck are there: aurora, duet, editorial, fhnw, terminal and sketch.
 
 ## Theme structure