@geekity/cms 0.14.0 → 0.15.0

package/dist/web/share-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"share-image.d.ts","sourceRoot":"","sources":["../../src/web/share-image.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAChF,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,CAAC;CAClD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,UAAU,GAAG,SAAS,CAmBzB"}
+{"version":3,"file":"share-image.d.ts","sourceRoot":"","sources":["../../src/web/share-image.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAChF,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,CAAC;CAClD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC1C,GAAG,UAAU,GAAG,SAAS,CAuBzB"}

package/dist/web/share-image.js

@@ -7,13 +7,11 @@ import { siteImageRecord, uploadPath } from '../images/markup.js';
  */
 export const LARGE_CARD_MIN_WIDTH = 1200;
 /**
- * The page's share image, or `undefined` when it has none: the entry's own
- * `image`, else the site's avatar.
+ * The page's share image, or `undefined` when it has none.
  *
  * The alt text is the front matter's `imageAlt` for the entry's own picture,
  * because one picture can need describing differently in two posts; else what
- * the media library says about the upload; else the entry's title for its own
- * picture and the site's author for the avatar, which is a picture of them.
+ * the media library says about the upload.
  *
  * The size is read off the variant sidecar, never off the file, so a render
  * never opens an image (decision-10). A picture with no sidecar has no size
@@ -21,14 +19,17 @@ export const LARGE_CARD_MIN_WIDTH = 1200;
  */
 export function shareImage(input) {
     const own = nonEmpty(input.image);
-    const url = own ?? nonEmpty(input.avatar);
-    if (url === undefined)
+    const chosen = own === undefined
+        ? input.fallbacks.find((fallback) => nonEmpty(fallback.url) !== undefined)
+        : { url: own, describedAs: input.title };
+    const url = nonEmpty(chosen?.url);
+    if (chosen === undefined || url === undefined)
         return undefined;
     const source = uploadPath(url);
     const described = source === undefined ? undefined : readAltTexts(input.config.contentDir).get(source);
     const alt = (own === undefined ? undefined : nonEmpty(input.imageAlt)) ??
         (described?.kind === 'described' ? nonEmpty(described.text) : undefined) ??
-        (own === undefined ? input.owner : input.title);
+        chosen.describedAs;
     const record = source === undefined ? undefined : siteImageRecord(input.config, source);
     const size = record === undefined ? undefined : { width: record.width, height: record.height };
     const large = size !== undefined && size.width >= LARGE_CARD_MIN_WIDTH && size.width > size.height;

package/dist/web/share-image.js.map

@@ -1 +1 @@
-{"version":3,"file":"share-image.js","sourceRoot":"","sources":["../../src/web/share-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBlE;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,KAW1B;IACC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAExC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,GACb,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvF,MAAM,GAAG,GACP,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC,SAAS,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC/F,MAAM,KAAK,GACT,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,oBAAoB,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IAEvF,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"share-image.js","sourceRoot":"","sources":["../../src/web/share-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBlE;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAOzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,KAS1B;IACC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,MAAM,GACV,GAAG,KAAK,SAAS;QACf,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;QAC1E,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,GACb,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvF,MAAM,GAAG,GACP,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC,SAAS,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,MAAM,CAAC,WAAW,CAAC;IAErB,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC/F,MAAM,KAAK,GACT,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,oBAAoB,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IAEvF,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekity/cms",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "type": "module",
   "description": "A file-first CMS: Markdown content, a SQLite index, a Hono server that is both the editor and the public site.",
   "license": "MIT",

package/themes/default/README.md

@@ -207,7 +207,8 @@ it sits beside the link home. See [Navigation](#navigation).
 **The footer** prints the copyright with the current year and the site
 author's display name, `soloAuthor.name`, or the site title on a site with
 several authors,
-`Published with Geekity`, and then `menus.footer` — the `footer` area this
+then the page's license, when it has one, as `<a rel="license">` with its name,
+then `Published with Geekity`, and then `menus.footer` — the `footer` area this
 theme declares, and the whole of what the footer links. A site that wants its
 feed there types an `RSS | /feed/` line into it, the way the starter site does.
 Nothing in the footer is read off an account: it used to hold one `rel="me"`
@@ -216,7 +217,9 @@ presented as the site's. An empty or missing footer menu prints no list at all,
 and the copyright line stands on its own. The year is
 `{{ "now" | date("year") }}` — `now` is the one word the `date` filter reads
 rather than parses — so it is the year at the moment the page is rendered, in
-the site's own timezone.
+the site's own timezone. The license is `license`: a post's own from its
+`license` front matter, else the site's from Settings > General, and nothing
+on a site with none.
 
 **The breadcrumb** opens `<main>` on a page with a place in the site's
 hierarchy (TASK-150): a post filed under a category, and a category, tag or
@@ -230,8 +233,8 @@ two cannot disagree. Every other page has an empty trail and prints nothing. A
 site that wants no visible breadcrumb empties the `breadcrumbs` block, and the
 `BreadcrumbList` stays in the graph.
 
-Webrings, badges, a licence notice and anything else that is markup rather than
-a link are deliberately not in the package. They go in a site theme's `footer`
+Webrings, badges and anything else that is markup rather than a link are
+deliberately not in the package. They go in a site theme's `footer`
 block:
 
 ```njk
@@ -400,6 +403,41 @@ is a `p-category` of this entry, as one `p.post-categories` from
 `partials/tags.njk`. The stylesheet draws the `#` in front of each, so the
 category a parser reads is the tag and not the hash.
 
+**A post with a recording plays it** (TASK-213), from
+`partials/recording.njk`, between the header and the `e-content`. The main file
+is the browser's own player, `<audio controls>` or `<video controls>` as
+`enclosure.player` says, with `preload="metadata"` so a reader who never presses
+play downloads nothing, and a download link inside it for a browser that plays
+neither. The `<source>` carries `u-audio` or `u-video`, so a microformats parser
+finds the file on the entry. A video whose transcript is WebVTT also gets it as
+a `<track kind="captions">`. Under the player a `figcaption` links the
+transcript, as Captions for VTT or SRT and Transcript otherwise, and lists the
+other versions by their title, else their media type. A post without a
+recording, or whose front matter is missing what a player needs, prints none of
+it.
+
+```html
+<figure class="post-recording">
+  <audio controls preload="metadata" aria-label="Recording of Episode twelve">
+    <source
+      class="u-audio"
+      src="/uploads/2026/10/episode-12.mp3"
+      type="audio/mpeg"
+    />
+    <a href="/uploads/2026/10/episode-12.mp3">Download the recording</a>
+  </audio>
+  <figcaption class="post-recording-links">
+    <p><a href="/uploads/2026/10/episode-12.vtt">Captions</a></p>
+    <p id="post-recording-versions">Other versions</p>
+    <ul aria-labelledby="post-recording-versions">
+      <li>
+        <a href="/uploads/2026/10/episode-12.mp4" type="video/mp4">Video</a>
+      </li>
+    </ul>
+  </figcaption>
+</figure>
+```
+
 After the entry a post prints `nav.blog-post-nav`: the `previous` and `next`
 posts as two cards, `rel="prev"` and `rel="next"`, each opening on a
 `span.blog-post-nav-label`, and nothing at all at the ends of the archive; then
@@ -709,17 +747,28 @@ included. `og:url` is the canonical URL. An article also carries
 publish date), `article:author` (the author's profile URL here, else their
 name) and one `article:tag` per tag.
 
-**The picture** is the `image` in the entry's front matter, else `site.avatar`,
-on the context as `shareImage`. A site with neither prints no `og:image` and no
-`twitter:image` rather than an empty one. The picture always carries
-`og:image:alt` and `twitter:image:alt`. For the entry's own picture, the alt
-text is its `imageAlt` front matter, else what the media library says about the
-upload, else the entry's title. For the avatar, it is the media library's text,
-else the site's author. `og:image:width` and `og:image:height` are printed when
-the image's variants have been derived, because the size is read from their
-sidecar rather than from the file. `twitter:card` is `summary_large_image` for a
-picture at least 1200 pixels wide and wider than it is tall. Everything else,
-the avatar included, is `summary`, the small picture beside the words.
+**The picture** is the first of these that the page has, on the context as
+`shareImage`:
+
+1. The `image` in the entry's front matter.
+2. `site.avatar`, which only a hand edit of `site.json` sets.
+3. The profile photo of the person the page is by: the writer of a post or page
+   that names an author, the user of an author archive, and the site's author
+   on a solo-author site's homepage and other pages about nobody in particular.
+4. The site icon, from `icon` in `site.json`.
+
+A page with none of these prints no `og:image` and no `twitter:image` rather
+than an empty one. The picture always carries `og:image:alt` and
+`twitter:image:alt`. The alt text is what the media library says about the
+upload, else words for what it shows. For the entry's own picture, its
+`imageAlt` front matter comes first, and the entry's title last. For the
+avatar, the last resort is the site's author; for a photo, that person's
+display name; for the icon, the site's title. `og:image:width` and
+`og:image:height` are printed when the image's variants have been derived,
+because the size is read from their sidecar rather than from the file.
+`twitter:card` is `summary_large_image` for a picture at least 1200 pixels wide
+and wider than it is tall. Everything else, a square photo included, is
+`summary`, the small picture beside the words.
 
 **The icons** come from the site's `icon` setting in `site.json`, else
 `site.avatar`, through the derived images (decision-10). `icon` exists for a
@@ -778,7 +827,7 @@ IndieWeb. The graph holds:
   `/search/?q={search_term_string}`. On a site whose author is a user, its
   `publisher` and `about` both point at that user's Person, on every page. On
   a site with several authors its `publisher` is the Organization below and it
-  has no `about`.
+  has no `about`. With a site license, `license` is its URL.
 - `Organization`, on a site with several authors only: the site itself, named
   for its title, at `{baseUrl}/#organization`. It publishes the `WebSite` and
   every entry.
@@ -795,8 +844,9 @@ IndieWeb. The graph holds:
   `author`, and the site's `publisher`: the site author's Person, or the
   Organization. A post with no title is headed by the words its `<title>`
   names it by, its `label`, cut on a word boundary to at most 110 characters.
-  A post with no picture of its own, on a site with no avatar, takes its
-  author's photo, else the site's `icon` upload.
+  Its `image` is the picture the Open Graph tags print, so the two always
+  agree (see [The head](#the-head)). Its `license` is the page's license URL,
+  the front matter's over the site's, and absent with none.
 - `BreadcrumbList` wherever the page prints a breadcrumb (see
   [The page shell](#the-page-shell)): one `ListItem` per crumb with its
   `position`, `name` and absolute URL as `item`.
@@ -1055,16 +1105,18 @@ an Eleventy build needs few edits. It is part of the package's semver contract.
 
 Every template gets:
 
-| Key          | What it holds                                                                                                                                                                                           |
-| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `site`       | `content/_data/site.json`, if the site has one, over the defaults `title` and `url`. Any key in the file is readable, so `site.tagline`, `site.author` and anything else a site adds are all available. |
-| `menus`      | Every menu the site stores, by name, marked for this page: `menus.primary`, `menus.footer`, and any other name. See [Navigation](#navigation).                                                          |
-| `siteAuthor` | Who the page is by, as a profile. **Absent** when nobody matches. See [Bylines and author archives](#bylines-and-author-archives).                                                                      |
-| `soloAuthor` | The site author's profile, on every page of a site whose Site author setting names a user. **Absent** on a site with several authors. See [The bio](#the-bio).                                          |
-| `icons`      | The site's icons, as `{ rel, sizes, type, href }`. Empty until the site has an icon or an avatar to derive them from. See [The head](#the-head).                                                        |
-| `theme`      | The colours the theme declares, as `{ colorScheme, themeColor: { light, dark } }`, each absent when no theme declares it. See [The manifest](#the-manifest).                                            |
-| `shareImage` | The picture a shared link shows, as `{ url, alt, size: { width, height }, card }`. `size` is absent when it is not known. **Absent** when there is no picture. See [The head](#the-head).               |
-| `llmsTxt`    | The path of `/llms.txt`, while the site serves it. **Absent** when the site has turned it off. The default theme links it from the front page only.                                                     |
+| Key           | What it holds                                                                                                                                                                                           |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `site`        | `content/_data/site.json`, if the site has one, over the defaults `title` and `url`. Any key in the file is readable, so `site.tagline`, `site.author` and anything else a site adds are all available. |
+| `menus`       | Every menu the site stores, by name, marked for this page: `menus.primary`, `menus.footer`, and any other name. See [Navigation](#navigation).                                                          |
+| `siteAuthor`  | Who the page is by, as a profile. **Absent** when nobody matches. See [Bylines and author archives](#bylines-and-author-archives).                                                                      |
+| `soloAuthor`  | The site author's profile, on every page of a site whose Site author setting names a user. **Absent** on a site with several authors. See [The bio](#the-bio).                                          |
+| `icons`       | The site's icons, as `{ rel, sizes, type, href }`. Empty until the site has an icon or an avatar to derive them from. See [The head](#the-head).                                                        |
+| `theme`       | The colours the theme declares, as `{ colorScheme, themeColor: { light, dark } }`, each absent when no theme declares it. See [The manifest](#the-manifest).                                            |
+| `shareImage`  | The picture a shared link shows, as `{ url, alt, size: { width, height }, card }`. `size` is absent when it is not known. **Absent** when there is no picture. See [The head](#the-head).               |
+| `llmsTxt`     | The path of `/llms.txt`, while the site serves it. **Absent** when the site has turned it off. The default theme links it from the front page only.                                                     |
+| `license`     | The page's license as `{ name, url }`: the page's `license` front matter, else the site's. **Undefined** with none. It replaces the raw front matter value on the context.                              |
+| `siteLicense` | The site's own license as `{ name, url }`, whatever the page says. **Undefined** with none.                                                                                                             |
 
 A document — one post, one page, or one entry of a listing — adds:
 
@@ -1085,6 +1137,7 @@ A document — one post, one page, or one entry of a listing — adds:
 | `type`                                      | `post` or `page`.                                                                                                 |
 | `permalink`, `slug`, `draft`, `description` | Straight from the front matter.                                                                                   |
 | `lang`                                      | The `lang` front matter as a canonical tag, such as `fr-CA`. Absent when it names none or no tag.                 |
+| `enclosure`                                 | The post's recording, parsed, with `player` (`audio` or `video`) and `transcript.captions`. Absent with none.     |
 | `author`                                    | Who wrote it, as a profile rather than a string. See [Bylines and author archives](#bylines-and-author-archives). |
 | `activityStreams`                           | The post's ActivityPub object id, absolute. Only on a rendered published post.                                    |
 | `previous`                                  | The published post before this one by date, as `{ title, url }`. Absent on the oldest post.                       |

package/themes/default/layouts/base.njk

@@ -40,9 +40,8 @@
 
     `metaDescription` is the page's own description, else the entry's summary
     — the very line the feeds publish — else the site's tagline. `metaImage` is
-    `shareImage.url`: the picture the front matter names, else the site's
-    avatar; with neither, nothing is printed rather than an empty tag. The CMS
-    works out `shareImage` because its alt text and its size live in files a
+    `shareImage.url`; with none, nothing is printed rather than an empty tag.
+    The CMS works out `shareImage` because its alt text and its size live in files a
     template cannot read. `isEntry` is a rendered post
     or page, which is what Open Graph calls an article: a listing has
     `pagination`, and the posts page is a listing carrying a page's front
@@ -281,7 +280,7 @@
 
       {% block footer %}
       <footer>
-        <p>&copy; {{ "now" | date("year") }}, {{ soloAuthor.name or site.title }} &middot; Published with Geekity</p>
+        <p>&copy; {{ "now" | date("year") }}, {{ soloAuthor.name or site.title }}{% if license %} &middot; <a rel="license" href="{{ license.url }}">{{ license.name }}</a>{% endif %} &middot; Published with Geekity</p>
         {#
           The footer menu: the `footer` area this theme declares in its
           `theme.json`, which a site fills in on the Navigation screen, and the

package/themes/default/layouts/post.njk

@@ -56,6 +56,10 @@
   {% include "partials/reply-context.njk" %}
   {% endif %}
 
+  {% if enclosure %}
+  {% include "partials/recording.njk" %}
+  {% endif %}
+
   <section class="e-content">
     {{ content | safe }}
     <p class="entry-meta">

package/themes/default/partials/jsonld.njk

@@ -54,12 +54,8 @@
 {% set entryType = "BlogPosting" if type == "post" else "Article" %}
 {#- A post with no title is headed by the words its <title> names it by,
     within the 110 characters Google reads, cut where a word ends (TASK-201).
-    Its picture is its own, else the site's avatar, else its author's photo,
-    else the site icon: the original upload rather than a derived icon, which
-    at 180 pixels is too small for an article image. A page keeps its title
-    and its own picture. -#}
+    A page keeps its title. -#}
 {% set headline = title or (label | truncate(109, false, "…") if type == "post" else "") %}
-{% set entryImage = metaImage or (siteAuthor.avatar or site.icon if type == "post" else "") %}
 {% set nodes = [] %}
 {% set website %}
     {
@@ -82,6 +78,7 @@
       }) }}
       {{- member("publisher", publisher) }}
       {{- member("about", { "@id": soloId } if soloId else "") }}
+      {{- member("license", siteLicense.url if siteLicense else "") }}
     }{% endset %}
 {% set _ = nodes.push(website) %}
 {% if not soloId %}
@@ -129,9 +126,10 @@
       {{- member("datePublished", date | date("iso") if date else "") }}
       {{- member("dateModified", (updated or date) | date("iso") if (updated or date) else "") }}
       {{- member("description", metaDescription) }}
-      {{- member("image", entryImage | absoluteUrl if entryImage else "") }}
+      {{- member("image", metaImage | absoluteUrl if metaImage else "") }}
       {{- member("author", person) }}
       {{- member("publisher", publisher) }}
+      {{- member("license", license.url if license else "") }}
     }{% endset %}
 {% set _ = nodes.push(entry) %}
 {% endif %}

package/themes/default/partials/recording.njk

@@ -0,0 +1,41 @@
+{#
+  Timed captions in WebVTT go on a video as a track as well as in the links,
+  since that is the one format a browser shows over the picture. The source
+  carries `u-audio` or `u-video`, so a microformats parser finds the file on
+  the entry.
+
+  The `preload="metadata"` asks for the length and the first frame and no
+  more: a reader who never presses play does not download the episode.
+#}
+{% set recordingLabel = ("Recording of " ~ title) if named else "Recording" %}
+<figure class="post-recording">
+  {% if enclosure.player == "video" %}
+  <video controls preload="metadata" aria-label="{{ recordingLabel }}">
+    <source class="u-video" src="{{ enclosure.url | url }}" type="{{ enclosure.type }}">
+    {% if enclosure.transcript and enclosure.transcript.type == "text/vtt" %}
+    <track kind="captions" src="{{ enclosure.transcript.url | url }}" srclang="{{ lang or (site.language | default("en")) }}" label="Captions" default>
+    {% endif %}
+    <a href="{{ enclosure.url | url }}">Download the video</a>
+  </video>
+  {% else %}
+  <audio controls preload="metadata" aria-label="{{ recordingLabel }}">
+    <source class="u-audio" src="{{ enclosure.url | url }}" type="{{ enclosure.type }}">
+    <a href="{{ enclosure.url | url }}">Download the recording</a>
+  </audio>
+  {% endif %}
+  {% if enclosure.alternates.length or enclosure.transcript %}
+  <figcaption class="post-recording-links">
+    {% if enclosure.transcript %}
+    <p><a href="{{ enclosure.transcript.url | url }}">{{ "Captions" if enclosure.transcript.captions else "Transcript" }}</a></p>
+    {% endif %}
+    {% if enclosure.alternates.length %}
+    <p id="post-recording-versions">Other versions</p>
+    <ul aria-labelledby="post-recording-versions">
+      {% for alternate in enclosure.alternates %}
+      <li><a href="{{ alternate.url | url }}" type="{{ alternate.type }}"{% if alternate.lang %} hreflang="{{ alternate.lang }}"{% endif %}>{{ alternate.title or alternate.type }}</a></li>
+      {% endfor %}
+    </ul>
+    {% endif %}
+  </figcaption>
+  {% endif %}
+</figure>

package/themes/default/src/style.css

@@ -660,6 +660,22 @@
     @apply text-[1.08rem] leading-[1.65];
   }
 
+  .post-recording {
+    @apply my-8;
+  }
+
+  .post-recording :is(audio, video) {
+    @apply block w-full;
+  }
+
+  .post-recording-links {
+    @apply mt-3 font-sans text-sm text-muted;
+  }
+
+  .post-recording-links ul {
+    @apply mt-1 flex flex-wrap gap-x-4 gap-y-1;
+  }
+
   /* An untitled post is its words, set larger. It is the one entry whose
      heading is the hidden one TASK-144 gave it. */
   .blog-post > .screen-reader-text ~ .e-content {

package/themes/default/static/style.css

@@ -1190,6 +1190,31 @@
     line-height: 1.65;
   }
 
+  .post-recording {
+    margin-block: calc(var(--spacing) * 8);
+  }
+
+  .post-recording :is(audio, video) {
+    width: 100%;
+    display: block;
+  }
+
+  .post-recording-links {
+    margin-top: calc(var(--spacing) * 3);
+    font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+    font-size: var(--text-sm);
+    line-height: var(--tw-leading, var(--text-sm--line-height));
+    color: var(--color-muted);
+  }
+
+  .post-recording-links ul {
+    margin-top: var(--spacing);
+    column-gap: calc(var(--spacing) * 4);
+    row-gap: var(--spacing);
+    flex-wrap: wrap;
+    display: flex;
+  }
+
   .blog-post > .screen-reader-text ~ .e-content {
     --tw-leading: 1.55;
     font-size: 1.3rem;