mdeck 3.3.0 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 3.5.0 — 2026-10-09
+
+- mdeck now comes with six themes: `neue` (still the default), `academic` and `minimal` as before, and new among them `plain` (black on white, the heading in a column beside the content), `work` (an everyday company template with an accent band, the logo and numbered sections) and `glass` (liquid glass, dark by default). The palettes `greyscale` (`plain`'s) and `cobalt` (`work`'s) come with it too. `aurora` and its palette `neon` moved to the theme repository: a deck that uses them is told to run `mdeck themes install aurora`; files made with `mdeck send` or `mdeck build` keep working, because they carry their theme. The tour example now uses `glass`.
+- Tags in a deck are found the way the slide finds them, everywhere mdeck looks for them: the phones, `--no-polls`, the pictures and videos a build takes along. A `>` in a quoted value no longer cuts a tag short there either (`<qrcode label="a > b" join />`, `<img alt="a > b" src="…">`), and a tag that a blank line cuts in two is no activity for the phones when the slide does not show it.
+- Fixed: a bar inside `code`, a [link](…) or a picture in a poll's options split the option in two. Only bars outside them, and outside formulas, separate options.
+- A poll's options may be a list inside the tag, one item each, with `[x]` for a right answer: `<poll room="d">` then `- [x] $2x$`, `- [ ] $x^2$` and `</poll>`. Nothing needs escaping, and long options read better than in one attribute.
+- Fixed: text after an activity written `<poll … />` (or any component closed with `/>`) went missing from the slide, as did another activity right after it. What follows an activity or a join code now has room above it in every theme.
+
+## 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/README.md

@@ -143,7 +143,7 @@ complete folder.
 
 | Example | Theme | What it demonstrates |
 |---|---|---|
-| [Tour](examples/showcase/slides.md) | Aurora | Start here: each slide shows the Markdown beside what it becomes, from headings to layouts, live code, notes, drawing, a poll and sharing |
+| [Tour](examples/showcase/slides.md) | Glass | Start here: each slide shows the Markdown beside what it becomes, from headings to layouts, live code, notes, drawing, a poll and sharing |
 | [Python](examples/python/slides.md) | Academic | A real lesson: live code to try out, points revealed step by step, notes on every slide, a poll to check understanding |
 | [Poll](examples/poll/slides.md) | Neue | A join slide, then a poll, a scale, a word cloud and open questions; start it with `mdeck run slides.md --network` |
 | [Custom layouts](examples/custom-layouts/slides.md) | Neue | A deck-local comparison design and named regions |

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/palettes/cobalt/extension.toml

@@ -0,0 +1,30 @@
+schema = 1
+kind = "palette"
+id = "cobalt"
+title = "Cobalt"
+description = "Strong ultramarine on white, with vivid orange; bold and clear."
+version = "1.0.0"
+author = "Tilman Schieber"
+license = "MIT"
+
+[light]
+"--bg" = "#ffffff"
+"--surface" = "#eef1fb"
+"--ink" = "#0c1033"
+"--ink-soft" = "#2a2f55"
+"--muted" = "#5b6080"
+"--rule" = "#d5dbf0"
+"--accent" = "#1f3fd1"
+"--accent-2" = "#e8590c"
+"--on-accent" = "#ffffff"
+
+[dark]
+"--bg" = "#0a1030"
+"--surface" = "#121a44"
+"--ink" = "#eef1ff"
+"--ink-soft" = "#c9cff0"
+"--muted" = "#8e97c4"
+"--rule" = "#212b5e"
+"--accent" = "#6f8cff"
+"--accent-2" = "#ff922b"
+"--on-accent" = "#0a1030"

package/assets/extensions/palettes/greyscale/extension.toml

@@ -0,0 +1,57 @@
+schema = 1
+kind = "palette"
+id = "greyscale"
+title = "Greyscale"
+description = "Black, white and greys only, code and callouts too: for printing and for a quiet look."
+version = "1.0.0"
+author = "Tilman Schieber"
+license = "MIT"
+
+# No colour anywhere: emphasis is black against the softer body text, the
+# second accent a mid grey; code and callouts use greys instead of their
+# usual colours.
+[light]
+"--bg" = "#ffffff"
+"--surface" = "#f0f0f0"
+"--ink" = "#141414"
+"--ink-soft" = "#363636"
+"--muted" = "#606060"
+"--rule" = "#d4d4d4"
+"--accent" = "#000000"
+"--accent-2" = "#6e6e6e"
+"--on-accent" = "#ffffff"
+"--token-default" = "#141414"
+"--token-comment" = "#6b6b6b"
+"--token-string" = "#454545"
+"--token-number" = "#000000"
+"--token-keyword" = "#000000"
+"--token-function" = "#2a2a2a"
+"--token-operator" = "#555555"
+"--callout-note" = "#4a4a4a"
+"--callout-tip" = "#4a4a4a"
+"--callout-important" = "#000000"
+"--callout-warning" = "#7a7a7a"
+"--callout-caution" = "#000000"
+
+[dark]
+"--bg" = "#121212"
+"--surface" = "#1f1f1f"
+"--ink" = "#f2f2f2"
+"--ink-soft" = "#d0d0d0"
+"--muted" = "#9c9c9c"
+"--rule" = "#303030"
+"--accent" = "#ffffff"
+"--accent-2" = "#a6a6a6"
+"--on-accent" = "#121212"
+"--token-default" = "#f2f2f2"
+"--token-comment" = "#9a9a9a"
+"--token-string" = "#c4c4c4"
+"--token-number" = "#ffffff"
+"--token-keyword" = "#ffffff"
+"--token-function" = "#e0e0e0"
+"--token-operator" = "#b0b0b0"
+"--callout-note" = "#b8b8b8"
+"--callout-tip" = "#b8b8b8"
+"--callout-important" = "#ffffff"
+"--callout-warning" = "#8c8c8c"
+"--callout-caution" = "#ffffff"

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/glass/extension.toml

@@ -0,0 +1,59 @@
+schema = 1
+kind = "theme"
+id = "glass"
+title = "Glass"
+description = "Liquid glass: soft pools of light behind every slide, content without frames, titles on a frosted pane with a bright rim; capsule labels, glass beads for list markers and a glass lens for chapter numbers; Geist throughout, dark by default."
+version = "0.1.1"
+author = "Tilman Schieber"
+license = "MIT"
+# The palette this theme uses unless the deck sets one; colours come only from palettes.
+# Muted: polar night, ice blue and lavender; the glass is the look, not the colour.
+palette = "nordic"
+appearance = "dark"
+fonts = [
+  "https://fonts.googleapis.com/css2?family=Geist:wght@300..800&family=Geist+Mono:wght@400..600&display=swap",
+]
+
+[files]
+styles = "styles.css"
+
+# Type, spacing and fonts used by styles.css; colours come from the palette.
+# Deck settings (params) override these.
+[tokens]
+
+# Type scale (px) — projection-appropriate at 1920×1080
+"--fs-display" = "136px"
+"--fs-title" = "104px"
+"--fs-focus" = "88px"
+"--fs-h" = "68px"
+"--fs-sub" = "40px"
+"--fs-body" = "32px"
+"--fs-small" = "24px"
+"--fs-eyebrow" = "20px"
+
+# Spacing
+"--pad-x" = "96px"
+"--pad-y" = "60px"
+"--gap-title" = "40px"
+"--gap-item" = "22px"
+
+# The glass: how round the panes are and how much they blur what is behind them.
+"--glass-radius" = "44px"
+"--glass-blur" = "28px"
+
+# Type families
+"--font-display" = "\"Geist\", \"Inter\", \"Helvetica Neue\", Arial, sans-serif"
+"--font-body" = "\"Geist\", \"Inter\", \"Helvetica Neue\", Arial, sans-serif"
+"--font-mono" = "\"Geist Mono\", ui-monospace, \"SF Mono\", Menlo, Consolas, monospace"
+
+[params.fontDisplay]
+token = "--font-display"
+title = "Display font"
+
+[params.fontBody]
+token = "--font-body"
+title = "Body font"
+
+[params.glassBlur]
+token = "--glass-blur"
+title = "How much the glass blurs"