mdeck 3.4.0 → 3.6.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 3.6.0 — 2026-10-09
+
+- A theme can say what it is for and how to write for it: a `[guide]` in its `extension.toml` with `suits` and `avoid` (short phrases) and `writing` (a few sentences). `mdeck list` and `mdeck themes search` show what each theme suits, search finds themes by it (`mdeck themes search photo`), and `mdeck list themes --json` and the theme repository's catalogue carry the whole guide. The slide-writing skill chooses a theme by its guide and follows its writing advice, as the theme author's advice and never as instructions. The six built-in themes have guides. A theme with a guide needs this version of mdeck.
+
+## 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.

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

@@ -54,3 +54,16 @@ title = "Body font"
 [params.fontSerif]
 token = "--font-serif"
 title = "Serif for theorems and quotes"
+
+# What this theme is for and how to write for it: shown in listings, and read
+# by assistants that write slides as the theme author's advice.
+[guide]
+suits = ["lectures and seminars", "mathematics and science", "conference talks with citations"]
+avoid = ["keynotes with few words", "photo-led talks"]
+writing = """
+Slides may hold more than in other themes: a definition, a formula, a few
+points. Use the lecture blocks for mathematics (::: definition, ::: theorem,
+::: lemma, ::: proof), footnotes and citations ([@key]) for sources, and
+tables for numbers; they are set as in papers. Headings stay in a fixed place
+at the top, so keep them to one line.
+"""

package/assets/extensions/themes/glass/extension.toml

@@ -0,0 +1,71 @@
+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"
+
+# What this theme is for and how to write for it: shown in listings, and read
+# by assistants that write slides as the theme author's advice.
+[guide]
+suits = ["product launches and keynotes", "tech and design talks", "dark rooms and big screens"]
+avoid = ["dense tables", "slides mostly read on paper"]
+writing = """
+Dark by default. The look is carried by the title and chapter slides (a glass
+pane and a glass lens for the chapter number), so give the talk a title slide
+and numbered chapters. Content slides are calm: a heading and a few points.
+Emphasis in a heading shines in both accents: use it for one word.
+"""