mdeck 3.3.0 → 3.4.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 3.4.0 — 2026-10-08
+
+- What follows a list has room above it in every theme, so a sentence after a list no longer sits right against its last item.
+- Fixed: a bullet list inside a numbered list took numbers too, and in some themes the number sat on top of the bullet; it also pushed the numbering of the items after it. Every built-in theme now styles only a list's own items.
+- A list inside a list item has room above it, as much as between its own items and less than between the outer ones, instead of sitting right against its item. Themes with their own spacing for nested lists keep it.
+- Links and quotations look the part in every theme: links take the palette's accent colour instead of the browser's blue, and a `> quotation` is set in each theme's own way instead of as a bare indent: academic as an indented serif quotation, aurora with a quotation mark in its gradient, minimal and neue with a bar at its side (grey and red). A quotation's paragraphs now take the quotation's type, which themes that set every paragraph's font used to undo.
+- The sample deck, on which `mdeck design`, the theme gallery and the theme checks show every theme, now also has a link, a quotation, a bullet list inside a numbered list, citations with their references at the foot of the slide, and a reference list.
+- A poll's question and options may use Markdown and `$…$` maths, as on a slide: `options="$2x$|$x^2$|$\frac{x^3}{3}$"`. The slide draws them with KaTeX, the phones' answer page as MathML, which needs no fonts or scripts there; it keeps only text, emphasis and MathML from what the presenter's screen sends. A `|` inside a formula belongs to it (`$|x|$`), and `\|` is a bar in the text. Votes and `answer` still use the text as written. The same goes for the `question` of every activity (`<scale>`, `<question>`, `<wordcloud>`) and the scale's `low` and `high` labels. An answer page from an older `mdeck server` shows the source text.
+- Fixed: the phones' answer page showed the word “null” below the question when there was no link for following the slides.
+- 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. Together with the eye (`results="hidden"`) and the tick this makes a peer-instruction round: vote, close, show the bars, discuss, show the answer.
+- Showing a poll's right answer also tells each phone whether its vote was right, or what the right answer is. The lock, the eye and the tick are kept in the activity room's state on the server, so every screen of the talk and the phones follow them, also after a reload.
+- Polls, scales and numbers count “12 of 31 answered” while phones are connected.
+- `multiple` lets each phone pick several options of a poll; the slide and the phones say so. `buttons="letters"` (or `"numbers"`) puts A, B, C before the options on the slide and shows only those on the phones, for options that are pictures or long formulas.
+- New activity `<numeric>`: phones type a number (`0.5`, `0,5`, `1/2`), the slide shows the most frequent answers as bars. `answer` and `tolerance` mark the right ones and tell each phone whether it was right.
+- The answers of a talk are kept beside the deck in `<slides>.results.json` while `mdeck run` runs: anonymous, phones numbered per question. Builds, `mdeck send` and `mdeck pdf` show them as the record of the talk (`--no-results` leaves them out), and `mdeck results` prints them as CSV.
+- Fixed: a `>` or `<` in an activity's attributes (`question="Is $x > 0$?"`) cut its tag short, and the phones lost the options. Pictures in a tag's attributes, such as a poll's options, are now copied into folder builds.
+
 ## 3.3.0 — 2026-10-08
 
 - Citations and references: `bibliography: refs.bib` in the deck settings, then cite in Pandoc's syntax, `[@smith2020, p. 12]`, `[see @a; @b]`, `[-@a]` or `@smith2020` in a sentence. Each citation shows in the style's short form, each slide lists the full references of the works it cites above its footer (`show.citations: false` leaves them out), and `<bibliography />` lists them all on a slide (`part="1/2"` splits a long list). Reference files may be BibTeX (`.bib`), CSL-JSON (`.json`) or Hayagriva (`.yml`, Typst's format), several at once. `csl:` picks the style, `apa` by default, `vancouver`, `harvard1` or any `.csl` file; the style's words follow `lang`. `nocite:` lists works without citing them. Formatting happens at build time, so a deck carries only the finished text. Unknown keys are marked on the slide and reported by `mdeck check`.

package/assets/base.css

@@ -105,7 +105,10 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
 .split-right { flex: 1; min-width: 0; display: flex; flex-direction: column; justify-content: safe center; gap: var(--gap-item); }
 
 /* ── List containers ─────────────────────────────────────────────────────── */
+/* Lists have no margins of their own, and paragraphs only one below them, so
+   whatever follows a list needs room above it. */
 .slide-body :is(ul, ol) + :is(ul, ol) { margin-top: var(--gap-item); }
+.slide-body :is(ul, ol) + :not(ul, ol) { margin-top: var(--gap-item); }
 /* Markers (::before), padding, and font styling are visual — defined per theme */
 .slide-body ul {
   list-style: none;
@@ -115,7 +118,7 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
   flex-direction: column;
   gap: var(--gap-item);
 }
-.slide-body ul li { position: relative; }
+.slide-body ul > li { position: relative; }
 .slide-body ol {
   list-style: none;
   padding: 0;
@@ -125,7 +128,10 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
   flex-direction: column;
   gap: var(--gap-item);
 }
-.slide-body ol li { counter-increment: slide-ol; position: relative; }
+.slide-body ol > li { counter-increment: slide-ol; position: relative; }
+/* A list inside an item: closer to its item than items are to each other,
+   and as close inside. Themes with their own (same selector) win. */
+.slide-body li :is(ul, ol) { margin-top: calc(var(--gap-item) * 0.5); gap: calc(var(--gap-item) * 0.5); }
 
 /* ── Full-bleed image ────────────────────────────────────────────────────── */
 .slide--full-bleed-image { padding: 0; }
@@ -159,6 +165,21 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
 .slide-footnotes p { margin: 0; }
 .slide-footnotes .footnote-backref { display: none; }
 
+/* ── Links and quotations ───────────────────────────────────────────────── */
+/* Defaults in the palette's colours instead of the browser's blue and a bare
+   indent. :where keeps them weaker than any rule of the theme's own. */
+:where(.slide) a { color: var(--accent); text-underline-offset: 0.15em; text-decoration-thickness: 0.06em; }
+:where(.slide) blockquote {
+  margin: 0 0 var(--gap-item);
+  padding-left: 0.9em;
+  border-left: 4px solid var(--accent);
+  color: var(--ink-soft);
+}
+:where(.slide) blockquote > p:last-child { margin-bottom: 0; }
+/* The quote's paragraphs take its type: themes set the face and size of
+   every paragraph, which would undo a quote set in its own. */
+.slide-body blockquote > p { font: inherit; color: inherit; letter-spacing: inherit; }
+
 /* ── Code blocks ─────────────────────────────────────────────────────────── */
 .code-block { white-space: pre-wrap; overflow-x: hidden; }
 

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

@@ -180,12 +180,12 @@ strong { color: var(--ink); font-weight: 700; }
    the text size, so long lists stay compact
    ───────────────────────────────────────────── */
 .slide-body ul, .slide-body ol { max-width: 1560px; }
-.slide-body ul li,
-.slide-body ol li {
+.slide-body ul > li,
+.slide-body ol > li {
   line-height: 1.45;
   padding-left: 44px;
 }
-.slide-body ul li::before {
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 4px;
@@ -195,7 +195,7 @@ strong { color: var(--ink); font-weight: 700; }
   background: var(--accent);
   clip-path: polygon(0 0, 100% 50%, 0 100%);
 }
-.slide-body ol li::before {
+.slide-body ol > li::before {
   content: counter(slide-ol) '.';
   position: absolute;
   left: 0;
@@ -206,7 +206,7 @@ strong { color: var(--ink); font-weight: 700; }
 }
 /* Second level: an en dash, a little smaller */
 .slide-body li :is(ul, ol) { margin-top: 8px; gap: 6px; font-size: 0.88em; }
-.slide-body li ul li::before {
+.slide-body li ul > li::before {
   width: 0.5em;
   height: 2px;
   top: 0.72em;
@@ -644,3 +644,16 @@ strong { color: var(--ink); font-weight: 700; }
   overflow-y: hidden;
 }
 .slide .katex-display > .katex { font-size: 1.2em; }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — the quote environment of a printed text: set in from
+   both sides, in the serif, without ornament
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  margin: 0 0 var(--gap-item);
+  padding: 0 64px;
+  border: 0;
+  font-family: var(--font-serif);
+  font-style: italic;
+  color: var(--ink-soft);
+}

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

@@ -66,13 +66,13 @@ deck-stage[data-deck-static] .slide::before { animation: none; }
 /* Print and PDF: gradient text prints with a hairline box around it, and
    glows print as dark halos; solid colours instead. */
 @media print {
-  em, .slide-footer > span:last-child:not(:first-child), .chapter-num, .slide-body ol li::before {
+  em, .slide-footer > span:last-child:not(:first-child), .chapter-num, .slide-body ol > li::before {
     background: none !important;
     -webkit-text-fill-color: currentColor !important;
     color: var(--aurora-a) !important;
     filter: none !important;
   }
-  .slide-body ul li::before, .focus-eyebrow::before, .slide-header > span:last-child:not(:empty)::after { box-shadow: none !important; }
+  .slide-body ul > li::before, .focus-eyebrow::before, .slide-header > span:last-child:not(:empty)::after { box-shadow: none !important; }
   /* Frosted glass blurs what lies behind it, which prints as an image. */
   .slide *, .slide *::before { -webkit-backdrop-filter: none !important; backdrop-filter: none !important; }
 }
@@ -457,13 +457,13 @@ strong { color: var(--ink); font-weight: 700; }
 /* ─────────────────────────────────────────────
    LISTS — glowing dots, gradient numbers
    ───────────────────────────────────────────── */
-.slide-body ul li {
+.slide-body ul > li {
   font-weight: 400;
   line-height: 1.35;
   padding-left: 46px;
   position: relative;
 }
-.slide-body ul li::before {
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 0;
@@ -474,11 +474,11 @@ strong { color: var(--ink); font-weight: 700; }
   background: var(--aurora-gradient);
   box-shadow: 0 0 14px color-mix(in oklab, var(--aurora-a) 55%, transparent);
 }
-.slide-body ol li {
+.slide-body ol > li {
   padding-left: 60px;
   position: relative;
 }
-.slide-body ol li::before {
+.slide-body ol > li::before {
   content: counter(slide-ol);
   position: absolute;
   left: 0;
@@ -642,3 +642,29 @@ strong { color: var(--ink); font-weight: 700; }
   overflow-x: auto;
   overflow-y: hidden;
 }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — no pane, only a large quotation mark in the colours of
+   the lights beside the quote
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  position: relative;
+  margin: 0 0 var(--gap-item);
+  padding: 0 0 0 76px;
+  border: 0;
+  max-width: 1300px;
+  color: var(--ink);
+}
+.slide-body blockquote::before {
+  content: '\201C';
+  position: absolute;
+  left: 0;
+  top: -18px;
+  font-size: 120px;
+  font-weight: 800;
+  line-height: 1;
+  background: var(--aurora-gradient);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+}

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

@@ -215,8 +215,8 @@ strong { color: var(--ink); font-weight: 600; }
 /* ─────────────────────────────────────────────
    LISTS — a short dash, plain numbers
    ───────────────────────────────────────────── */
-.slide-body ul li { line-height: 1.4; padding-left: 40px; position: relative; }
-.slide-body ul li::before {
+.slide-body ul > li { line-height: 1.4; padding-left: 40px; position: relative; }
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 0;
@@ -225,8 +225,8 @@ strong { color: var(--ink); font-weight: 600; }
   height: 2px;
   background: var(--muted);
 }
-.slide-body ol li { padding-left: 52px; position: relative; }
-.slide-body ol li::before {
+.slide-body ol > li { padding-left: 52px; position: relative; }
+.slide-body ol > li::before {
   content: counter(slide-ol) '.';
   position: absolute;
   left: 0;
@@ -340,3 +340,15 @@ strong { color: var(--ink); font-weight: 600; }
   overflow-x: auto;
   overflow-y: hidden;
 }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — a thin bar in the quiet grey, the quote set in a little,
+   in the softer ink
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  margin: 0 0 var(--gap-item);
+  padding: 2px 0 2px 28px;
+  border: 0;
+  border-left: 3px solid var(--muted);
+  color: var(--ink-soft);
+}

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

@@ -336,13 +336,13 @@ strong { color: var(--ink); font-weight: 600; }
 /* ─────────────────────────────────────────────
    LISTS — square markers in the accent, numbers in the display face
    ───────────────────────────────────────────── */
-.slide-body ul li {
+.slide-body ul > li {
   font-weight: 400;
   line-height: 1.32;
   padding-left: 44px;
   position: relative;
 }
-.slide-body ul li::before {
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 0;
@@ -351,12 +351,12 @@ strong { color: var(--ink); font-weight: 600; }
   height: 14px;
   background: var(--accent);
 }
-.slide-body ol li {
+.slide-body ol > li {
   counter-increment: slide-ol;
   padding-left: 64px;
   position: relative;
 }
-.slide-body ol li::before {
+.slide-body ol > li::before {
   content: counter(slide-ol, decimal-leading-zero);
   position: absolute;
   left: 0;
@@ -487,3 +487,16 @@ strong { color: var(--ink); font-weight: 600; }
   overflow-x: auto;
   overflow-y: hidden;
 }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — a rule, not a box: a red bar to the left, the quote set
+   in a little, in the text's own size
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  margin: 0 0 var(--gap-item);
+  padding: 2px 0 2px 32px;
+  border: 0;
+  border-left: 6px solid var(--accent);
+  max-width: 1200px;
+  color: var(--ink);
+}

package/docs/reference/authoring.md

@@ -592,6 +592,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 +756,33 @@ 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) |
+| `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 belongs to it (`$|x|$` is one option), and `\|` is a bar in plain text. 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/site/content/audience.md

@@ -28,19 +28,47 @@ Every poll in a presentation shows the same code, so people scan once. Their pho
 | Setting | Meaning |
 |---|---|
 | `room` | A short name for this question, different for each poll in the deck. Letters, digits, hyphens and underscores. |
-| `answer` | Optional: the right answer, written exactly like the option. A button with a tick then appears under the bars; tapping it outlines the right answer, its bar and its number in green, and tapping again hides it. The audience window shows it too. |
+| `answer` | Optional: the right answer, written exactly like the option (several separated by `\|`). A button with a tick then appears under the bars; tapping it outlines the right answer, its bar and its number in green, and each phone says whether its vote was right. Tapping again hides it. |
 | `options` | The answers, separated by `\|` |
 | `question` | Optional question text. Without it, phones show the slide's heading. |
+| `multiple` | Each phone may pick several options. The slide and the phones say “Several answers possible”. Without it, one option per phone. |
+| `buttons` | `letters` puts A, B, C … before the options on the slide, and the phones show only those letters; `numbers` does the same with 1, 2, 3 … For options that are pictures or long formulas, better read on the big screen. |
+| `results` | `hidden` starts with the bars hidden, e.g. to let people vote before they see what others chose. |
 | `qr` | `false` leaves out the QR code, when an earlier slide showed it with `<qrcode join />`. |
 
+The question and the options may contain formatting and formulas, written as on a slide, so a maths lecture can ask:
+
+```markdown
+<poll room="derivative" question="What is $\frac{d}{dx}\, x^2$?" options="$2x$|$x^2$|$\frac{x^3}{3}$" answer="$2x$" />
+```
+
+Both the slide and the phones show the formulas. A `|` inside a formula stays in it, so `$|x|$` is one option; to put a `|` in plain text, write `\|`.
+
+Options can also be pictures. Show only letters on the phones then:
+
+```markdown
+<poll room="graph" question="Which graph shows $f(x) = e^{-x}$?" options="![](a.svg)|![](b.svg)|![](c.svg)" answer="![](b.svg)" buttons="letters" />
+```
+
+### During the poll
+
+Below the bars, the slide counts the answers, “12 of 31 answered” while phones are connected. The presenter has three buttons there (the audience window does not show them):
+
+- **The lock** closes the poll. Answers after that do not count, and the phones say the poll is closed until you open it again.
+- **The eye** hides or shows the bars. Hidden, the audience sees no bars; your own screens show them faint.
+- **The tick** (with `answer`) shows the right answer: on the slide, and on each phone, which says whether its answer was right.
+
+Together they make a peer-instruction round: start with `results="hidden"`, let people vote, close, show the bars, let them discuss, and show the answer. **Reset** clears the answers and opens the poll again.
+
 With `lang: de` in the settings, the slide and the phones show German words, such as “Scannen und abstimmen”. The phones use the presentation's colours and fonts; if you pick another theme or palette in the presenter view, the phones change with it.
 
 ## Other kinds of questions
 
-Besides a poll, three more kinds work the same way: one line on a slide, answered on the phones.
+Besides a poll, four more kinds work the same way: one line on a slide, answered on the phones.
 
 ```markdown
 <scale room="pace" min="1" max="5" low="Too slow" high="Too fast" />
+<numeric room="limit" question="What is $\lim_{x \to 0} \frac{\sin x}{x}$?" answer="1" />
 <wordcloud room="mood" placeholder="One word" />
 <question room="ask" placeholder="Your question" />
 ```
@@ -48,10 +76,11 @@ Besides a poll, three more kinds work the same way: one line on a slide, answere
 | Tag | Phones show | The slide shows |
 |---|---|---|
 | `<scale>` | The numbers from `min` to `max` (1 to 5 unless set, at most 11 steps), with `low` and `high` as labels at the ends | How many chose each number, and the average. Each phone's latest answer counts |
+| `<numeric>` | A field for a number: `0.5`, `0,5`, `1/2` or `1e-3` | The most frequent answers as bars, six unless `limit` says otherwise, and the rest as Other. With `answer`, the tick marks the right ones and counts them, and each phone hears whether it was right; `tolerance` (0 unless set) says how far off still counts. Each phone's latest answer counts |
 | `<wordcloud>` | A short text field | A cloud of every answer, packed around the middle, larger the more often it came in and some upright. Capitals and extra spaces do not matter. People may send several. `height` sets its height (520). Colours come from the palette; `--cloud-1` to `--cloud-6` override them |
 | `<question>` | A text field | The newest answers as cards, eight unless `limit` says otherwise. People may send several |
 
-All of them take `room`, `question` and `qr` like a poll, and `placeholder` for the text fields.
+All of them take `room`, `question` and `qr` like a poll, and `placeholder` for the text fields. Their `question`, and the scale's `low` and `high`, may contain formatting and formulas like a poll's options. All of them have the lock that closes them; `<numeric>` also has the eye and the tick, and takes `results="hidden"`.
 
 ## Show the code once
 
@@ -175,9 +204,11 @@ Two presentations with the same title share a session code. Give one of them `se
 
 Answers are anonymous. Each phone gets a random number so it can change its vote; nothing else identifies it. The server keeps answers in memory only. It forgets a room after twelve hours without visitors and everything when it restarts. Each phone can send a limited number of answers in a short time.
 
+While you present with `mdeck run`, the answers are also kept beside the presentation, in `my-talk.results.json`. It holds each answer with its time, and the phones numbered 1, 2, 3 … per question instead of their random numbers. Once a question was closed, only the answers that counted. **Reset** takes a question's answers out of the file; a new server that starts empty leaves the file as it is. `mdeck results my-talk.md` prints the answers as CSV (question, phone, time, answer), to open in a spreadsheet; `-o answers.csv` saves them to a file. A deck hosted with its own `server` keeps nothing beside it.
+
 ## In a PDF or a shared file
 
-A PDF, a file made with `mdeck send` and a folder hosted without a poll server keep your questions as a record of the talk: each shows its question and options, with a note that it was answered live, and no join code. If the deck's `server` still answers when the file is made or opened, the results it holds appear instead. Printed slides never show the join code or the presenter's buttons.
+A PDF, a file made with `mdeck send` and a folder hosted without a poll server keep your questions as a record of the talk, without a join code. With answers kept in `my-talk.results.json`, each shows its results as they were at the end of the talk; without, its question and options with a note that it was answered live. `--no-results` leaves the kept answers out. If the deck's `server` still answers when the file is opened, the results it holds appear instead. Printed slides never show the join code or the presenter's buttons.
 
 ## Make your own activity
 

package/docs/site/content/commands.md

@@ -97,6 +97,8 @@ The design page shows themes and palettes on a sample deck with every kind of sl
 | `mdeck send my-talk.md --no-pdf` | The same, without rendering the PDF |
 | `mdeck pdf my-talk.md -o talk.pdf` | Render the slides to a PDF file (`--no-polls` leaves out the slides with polls) |
 | `--no-drawings` | Leave out the drawings from `my-talk.drawings.json`, for `build`, `send` and `pdf` |
+| `--no-results` | Leave out the answers kept in `my-talk.results.json`, for `build`, `send` and `pdf`; the polls then show their questions only |
+| `mdeck results my-talk.md` | The answers kept during the talk, as CSV; `-o answers.csv` saves them to a file |
 
 See [Send, host or print your slides](sharing.html) for help choosing between them. Unknown options, missing option values and extra filenames stop the command before it changes any output. `--output=path` and `-o path` are both accepted. `mdeck preview --no-open --port 4200` previews without opening a browser and chooses a port.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdeck",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "type": "module",
   "description": "Write slides as a plain text file, present them in the browser, share them as one HTML file or PDF.",
   "license": "MIT",

package/skills/write-slides/SKILL.md

@@ -94,7 +94,7 @@ Right column
 - Named areas use `:::slot name … :::`; the layout's regions and settings come from `mdeck list layouts --json`.
 - `:::notes … :::` holds speaker notes. `:::steps … :::` reveals list items one at a time. `:::note`, `:::tip`, `:::important`, `:::warning` and `:::caution` are callouts (`mdeck check` warns about other names); for lectures, `:::definition`, `:::theorem`, `:::lemma`, `:::proof`, `:::example` and `:::remark`, numbered in the title (`::: theorem Theorem 2.4 (Lagrange)`). `:::columns … +++ … :::` makes columns inside a slide.
 - Code fences get syntax highlighting; `$…$` and `$$…$$` render math.
-- `<poll room="lunch" options="Mensa|Thai|Pizza" />` lets the audience vote on their phones through a QR code on the slide; each poll needs its own `room`. `<scale room="pace" min="1" max="5" low="Too slow" high="Too fast" />`, `<wordcloud room="mood" />` and `<question room="ask" />` ask for a rating, short words or open answers the same way. With several of them, put `<qrcode join />` (the deck's join code) on an early slide to show the QR code once, and add `qr="false"` to the questions. It works when the deck is presented with `mdeck run <deck>.md --network` or with a server set as `server:` in the deck settings.
+- `<poll room="lunch" options="Mensa|Thai|Pizza" />` lets the audience vote on their phones through a QR code on the slide; each poll needs its own `room`. `question` and `options` may use Markdown and `$…$` maths (`options="$2x$|$x^2$"`); `answer` repeats the right option's text. `multiple` allows several picks; `buttons="letters"` shows only A, B, C on the phones, for options that are pictures or long formulas. `<numeric room="lim" question="…" answer="1/2" tolerance="0.01" />` asks for a number. `<scale room="pace" min="1" max="5" low="Too slow" high="Too fast" />`, `<wordcloud room="mood" />` and `<question room="ask" />` ask for a rating, short words or open answers the same way. With several of them, put `<qrcode join />` (the deck's join code) on an early slide to show the QR code once, and add `qr="false"` to the questions. It works when the deck is presented with `mdeck run <deck>.md --network` or with a server set as `server:` in the deck settings.
 
 ## 3. Write the deck
 

package/src/build/bibliography.js

@@ -1,8 +1,9 @@
-import { readFileSync, statSync } from 'fs'
-import { resolve, dirname, extname } from 'path'
+import { readFileSync, statSync, existsSync } from 'fs'
+import { resolve, dirname, extname, basename } from 'path'
 import yaml from 'js-yaml'
 import { parseSlides } from '../core/parseSlides.js'
 import { scanCitations, citedKeys } from '../core/citations.js'
+import { sampleDeck, SAMPLE_REFERENCES, SAMPLE_REFERENCES_FILE } from '../editor/sampleDeck.js'
 
 // The deck's references, formatted here in Node with citeproc so that none of
 // it travels in the deck: the page receives finished HTML for every citation
@@ -26,8 +27,14 @@ async function readItems(file) {
   const { mtimeMs } = statSync(file)
   const cached = parsed.get(file)
   if (cached?.mtimeMs === mtimeMs) return cached.items
-  const text = readFileSync(file, 'utf-8')
-  const ext = extname(file).toLowerCase()
+  const items = await parseReferences(readFileSync(file, 'utf-8'), extname(file))
+  parsed.set(file, { mtimeMs, items })
+  return items
+}
+
+// Reference file text as CSL-JSON items; `ext` names the format.
+export async function parseReferences(text, ext) {
+  ext = ext.toLowerCase()
   let items
   if (ext === '.json') items = JSON.parse(text)
   else if (ext === '.yml' || ext === '.yaml') {
@@ -40,18 +47,20 @@ async function readItems(file) {
     items = new Cite(text, { forceType: '@biblatex/text' }).data
   } else throw new Error(`unknown reference format "${ext}" (use .bib, .json or .yml)`)
   if (!Array.isArray(items)) throw new Error('expected a list of references')
-  items = items.filter(item => item && item.id != null).map(item => ({ ...item, id: String(item.id) }))
-  parsed.set(file, { mtimeMs, items })
-  return items
+  return items.filter(item => item && item.id != null).map(item => ({ ...item, id: String(item.id) }))
 }
 
-export async function loadBibliography(files) {
+// `sample`: the sample deck's references stand in for a missing file of
+// theirs (the dev and edit servers show the sample deck without a folder).
+export async function loadBibliography(files, { sample = false } = {}) {
   const items = []
   const seen = new Set()
   const diagnostics = []
   for (const file of files) {
     let found
-    try { found = await readItems(file) } catch (error) {
+    try {
+      found = sample && basename(file) === SAMPLE_REFERENCES_FILE && !existsSync(file) ? await parseReferences(SAMPLE_REFERENCES, '.bib') : await readItems(file)
+    } catch (error) {
       diagnostics.push({ severity: 'warning', code: 'bibliography-file', message: error.code === 'ENOENT' ? `Bibliography ${file} not found` : `Bibliography ${file}: ${error.message}` })
       continue
     }
@@ -275,15 +284,24 @@ export async function formatBibliography({ items, texts, csl, lang, nocite = [],
 
 // Everything the deck's `bibliography`, `csl`, `nocite` and `lang` ask for,
 // or null when the deck has no bibliography.
-export async function resolveBibliography(deckPath, source) {
+export async function resolveBibliography(deckPath, source, { sample = false } = {}) {
   let deckConfig
   try { deckConfig = parseSlides(source).deckConfig ?? {} } catch { return null }
   const files = bibliographyFiles(deckPath, deckConfig)
   if (!files.length) return null
-  const loaded = await loadBibliography(files)
+  const loaded = await loadBibliography(files, { sample })
   const formatted = await formatBibliography({
     items: loaded.items, texts: deckTexts(source), csl: deckConfig.csl, lang: deckConfig.lang,
     nocite: deckConfig.nocite ?? [], deckDir: dirname(resolve(deckPath)),
   })
   return { ...formatted, diagnostics: [...loaded.diagnostics, ...formatted.diagnostics], files, style: styleFile(deckPath, deckConfig) }
 }
+
+// The sample deck's citations, formatted once: the design page previews it
+// in the editor of any deck, whose own references are another matter.
+let sampleFormatted = null
+export function sampleBibliography() {
+  sampleFormatted ??= parseReferences(SAMPLE_REFERENCES, '.bib')
+    .then(items => formatBibliography({ items, texts: deckTexts(sampleDeck()) }))
+  return sampleFormatted
+}

package/src/build/resultsPlugin.js

@@ -0,0 +1,77 @@
+// Keeping the answers while `mdeck run` runs: the presenter's screens send
+// each activity's answers as they come in (src/live/client.js), and they go
+// into <deck>.results.json beside the deck (src/core/results.js).
+//
+//   POST /__mdeck/results   { room, closed, answers } → { ok }
+//
+// Answers of none take the room out of the file, as Reset does. Writes wait
+// a moment, so a burst of votes is one write, and do not reload the open
+// windows (ownWrites.js).
+import { existsSync, readFileSync, writeFileSync, renameSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { resultsFileFor, normalizeResults, withRoom, serializeResults } from '../core/results.js'
+import { isAllowedRequest, send, readJson } from './editorPlugin.js'
+import { markOwnWrite } from './ownWrites.js'
+
+export function createResultsFile(deckPath, { debounceMs = 500 } = {}) {
+  const path = resultsFileFor(resolve(deckPath))
+  let results = null, timer = null
+
+  const current = () => {
+    if (results) return results
+    try { results = existsSync(path) ? normalizeResults(JSON.parse(readFileSync(path, 'utf8'))) : normalizeResults({}) }
+    catch { results = normalizeResults({}) }
+    return results
+  }
+
+  function flush() {
+    clearTimeout(timer)
+    timer = null
+    if (!results) return
+    // A deck that never kept answers gets no empty file.
+    if (!Object.keys(results.rooms).length && !existsSync(path)) return
+    const text = serializeResults(results)
+    markOwnWrite(path, text)
+    const temp = `${path}.${process.pid}.tmp`
+    writeFileSync(temp, text, 'utf8')
+    renameSync(temp, path)
+  }
+
+  return {
+    path,
+    read: current,
+    save(room, entry) {
+      results = withRoom(current(), room, entry)
+      clearTimeout(timer)
+      timer = setTimeout(flush, debounceMs)
+    },
+    flush,
+  }
+}
+
+export function resultsMiddleware(file, { authorize = isAllowedRequest } = {}) {
+  return async (request, response, next) => {
+    const { pathname } = new URL(request.url, 'http://localhost')
+    if (pathname !== '/') return next()
+    if (request.method !== 'POST') { response.setHeader('Allow', 'POST'); return send(response, 405, { error: 'Method not allowed' }) }
+    if (!authorize(request)) return send(response, 403, { error: 'Only the presenter keeps the results' })
+    try {
+      const { room, closed, answers } = await readJson(request)
+      file.save(String(room ?? ''), { closed, answers })
+      return send(response, 200, { ok: true })
+    } catch (error) {
+      return send(response, error.status ?? 500, { error: error.message })
+    }
+  }
+}
+
+export function resultsPlugin(slidesPath, { authorize } = {}) {
+  return {
+    name: 'vite-plugin-mdeck-results',
+    configureServer(server) {
+      const file = createResultsFile(slidesPath)
+      server.middlewares.use('/__mdeck/results', resultsMiddleware(file, { authorize }))
+      server.httpServer?.once('close', () => file.flush())
+    },
+  }
+}