@geekity/cms 0.22.0 → 0.24.0

package/themes/default/README.md

@@ -17,6 +17,7 @@ themes/default/
     author.njk   one person's archive, paginated
     search.njk   the search form and what it found, paginated
     404.njk      nothing at this URL
+    410.njk      what was at this URL was deleted
     500.njk      the request failed on the server
     503.njk      the site is in maintenance mode
   partials/
@@ -25,14 +26,15 @@ themes/default/
     tags.njk          macros for tag and category links
     kicker.njk        the line above an entry naming its kind and date
     reply-context.njk the citation of what a reply answers
+    event.njk         when and where an event is
     citations.njk     the citation of what a like, repost or bookmark cites
     cited-page.njk    the name and author both citations print
     read.njk          what a read post read, and how far
     bio.njk           who an entry is by, as an h-card
     menu.njk          one named menu, as a nav of links
     feeds.njk         macros for the feed links in <head>
-    conversation.njk  the replies, likes and boosts under a post
-    comment-form.njk  the form under a post that is taking comments
+    conversation.njk  the replies, likes and boosts under a post or an open page
+    comment-form.njk  the form under a post or page that is taking comments
     contact-form.njk  the form on a page whose front matter says contact: true
     archive.njk       every post by month, on a page that says archive: true
     search-form.njk   the search box, on the search page
@@ -418,6 +420,44 @@ title and summary. The same partial cites a reply in a feed. The layouts own
 the placement; the partial owns only what the citation says, and it stays
 inside the `h-entry` wherever it is printed.
 
+**A reply to a silo copy cites the original** (TASK-197). When the post a
+reply answers is a copy of a post on another site, and that post lists the
+copy as its `u-syndication`, `replyContext.original` is the original's URL and
+the rest of `replyContext` describes the original. The `h-cite` links the
+original, and a `p.cite-copy` after it says "Also in reply to its copy on" the
+silo's host, linking the copy as a `u-in-reply-to` of its own, so a parser
+reads both as what the post answers.
+
+**An RSVP says whether its author is going** (TASK-198). An RSVP is a reply
+to an event whose `rsvp` is `yes`, `no`, `maybe` or `interested`.
+`partials/rsvp.njk` opens its `e-content` with a `p.rsvp-line` holding a
+`data.p-rsvp` whose value is the answer and whose text is Going, Not going,
+Maybe or Interested; it prints `rsvp.line`, the HTML the feeds also carry. Its
+reply context says "RSVP to" rather than "In reply to", and when the event's
+page is an `h-event`, or describes a schema.org `Event` in JSON-LD, its start
+follows the event's name as a `time.dt-start` and its place as a
+`span.p-location`, inside the `h-cite`. A start the event page wrote with no
+zone is that wall clock where the event is, so it is printed in UTC
+(`replyContext.startZone`) rather than moved into the site's zone. Its kicker
+and its hidden `h1` say RSVP. An RSVP to a silo copy of an event cites the
+original as a reply does.
+
+**An event is an h-event** (TASK-200, decision-32). A post whose front matter
+has a readable `start` is an event: its title is the event's name, its body
+the description, and `end` and `location` are optional. `layouts/post.njk`
+types its article `h-event` rather than `h-entry`, its kicker and hidden `h1`
+say Event, and `partials/event.njk` follows the title with a
+`dl.event-details`. The When row is a `time.dt-start` and, with an end, a
+`time.dt-end`, each written with the `date` filter's `datetime` format in the
+site's zone, with the instant as its `datetime`. The Where row is a
+`span.p-location` holding the place's words, or "Online at" an
+`a.p-location` that links the address to join an online event. The JSON-LD
+describes the post as a schema.org `Event` instead of a `BlogPosting`. That
+`Event` is a `Place` or a `VirtualLocation`, carries an attendance mode and an
+`EventScheduled` status, and names the author's Person as its `organizer`.
+The answers it is given are grouped in `conversation.rsvps`; see [The
+conversation](#the-conversation).
+
 **A like, a repost or a bookmark cites what it cites** (TASK-169) with
 `partials/citations.njk`, beside the reply context and drawn the same way: one
 `div.reply-context.cite.h-cite` per entry of `citations`, classed
@@ -452,6 +492,21 @@ bookmark of a Scripting News post reads "Bookmarked RSS tip #2 · Scripting
 News". A like's, a repost's or a bookmark's citation never prints the page's
 description, which on many sites describes the site rather than the post.
 
+**A citation shows who wrote the cited page** (TASK-199) as fully as the page
+said. The author's photo, an `img.u-photo.cite-avatar` with empty alt text
+since their name is beside it, comes before the name inside the `h-card`; a
+fediverse author's handle follows the name as a `span.p-nickname.cite-handle`
+reading `@user@host`. The photo is the `u-photo` of the `h-entry` author's
+`h-card` (or of the page's `h-card` for the same person), the avatar of the
+account an ActivityPub object is attributed to, or the author image in the
+page's JSON-LD, copied into the site's uploads as a picture is, and left out
+when the post has removed its preview. A Mastodon status is read from the
+ActivityPub object its page links, so its author's display name, handle,
+avatar, words, first image and date come from the status itself rather than
+from the page's `og:title`. A page with no `h-entry` and no object is read
+from its JSON-LD (`headline`, `author`, `datePublished`, `image`) and then its
+Open Graph, Twitter and `article:` tags.
+
 **A citation shows the cited page's picture** (TASK-252) when the page named
 one and the post has not removed its preview. The picture is the page's
 oEmbed photo, else its oEmbed thumbnail, else its `og:image`, else its
@@ -553,8 +608,9 @@ its front matter names no `image`.
 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
-the conversation and the comment form. A page prints the contact form when its
-front matter asked for one. A page has no neighbours, no tags and no
+the conversation and the comment form. A page prints the conversation and the
+comment form too when it takes comments, and the contact form when its front
+matter asked for one. A page has no neighbours, no tags and no
 syndication links, because none of those are things a page has.
 
 ### The bio
@@ -724,6 +780,13 @@ writes one today and the header is the heading alone.
 links home and to the search. The 500 and 503 pages below open on a kicker the
 same way.
 
+`layouts/410.njk` is the page at the URL of a post or page that was moved to
+the trash (TASK-195). It says `This content has been deleted.` under a
+`Deleted` kicker and links home and to the search. The context is the 404's:
+`title`, `url` and `page.url`, and nothing of the deleted document. Its `.md`
+and `.json` representations answer 410 too. A trashed draft was never public,
+so its URL is a 404 instead.
+
 `layouts/500.njk` is the page a request gets when the server fails while
 answering it (TASK-129). It says `Something went wrong.` in an
 `article.server-error` and links home. The context is the 404's: `title`,
@@ -1261,6 +1324,8 @@ A document — one post, one page, or one entry of a listing — adds:
 | `photos`                                    | The post's photos, each `{ url, alt, html }`; `html` is the `img.u-photo`, responsive. Empty with none.           |
 | `citations`                                 | What it reposts, likes or bookmarks, each `{ property, url, context }`; `context` as `replyContext`, when known.  |
 | `read`                                      | A read post's `{ status, statusLabel, of, line }`; `of` is `{ name, author, uid, uidLabel, url }`.                |
+| `rsvp`                                      | An RSVP's `{ value, label, line }`: `yes`, `no`, `maybe` or `interested`, its words, and its `p-rsvp` line.       |
+| `event`                                     | An event's `{ start, end, location }`: `Date`s, and `{ kind: "place", name }` or `{ kind: "virtual", url }`.      |
 | `syndicateTo`                               | On a post's page, the syndication targets it selects, each `{ id, name, url }`. Empty with none.                  |
 | `syndication`                               | Its copies elsewhere, each `{ url, label }`: front matter `syndication`, and on its page the copies targets made. |
 | `author`                                    | Who wrote it, as a profile rather than a string. See [Bylines and author archives](#bylines-and-author-archives). |
@@ -1543,6 +1608,18 @@ site that has turned them off advertises nothing. The CMS also sends the same
 endpoint as a `Link` header on every representation of a document, so a sender
 that does not parse HTML still finds it.
 
+The pingback endpoint follows it, as an absolute URL because the spec asks for
+one:
+
+```html
+<link rel="pingback" href="https://example.com/_geekity/pingback" />
+```
+
+It comes from `pingback` on the context, which is there only when the site
+takes webmentions and the document can be answered: every post, and a page
+only while it takes comments. The same endpoint goes out in an `X-Pingback`
+header under the same rule.
+
 On the front page it also writes the site's index for language models:
 
 ```html
@@ -1586,7 +1663,17 @@ ask:
 {% endif %}
 ```
 
-That is what `layouts/post.njk` does. `partials/conversation.njk` is the whole
+That is what `layouts/post.njk` does, and `layouts/page.njk` with it.
+
+A page takes part only while it takes comments: when its front matter says
+`comments: true` and the site has not switched comments off. A page is closed
+by default, as WordPress closes them, and the CMS leaves `conversation` off the
+context of a closed page however much has been approved against it, so a page
+that turns comments off shows nothing. A post is different: it keeps its thread
+after it closes. Webmentions to a page are received and moderated either way,
+exactly as webmentions to a post are, and appear once the page opens.
+
+`partials/conversation.njk` is the whole
 section — a `div.reactions-section` of the likes, the boosts and the mentions
 as facepiles grouped by kind, and then the thread as
 `div#comments.comments-area` — and a site replaces it with a
@@ -1610,34 +1697,37 @@ correctly; one that does can style them apart. The one thing a theme does have
 to look at is `kind`: a `mention` is in `conversation.mentions` rather than in
 the thread, because it is not an answer.
 
-| Key                                                | What it holds                                                                              |
-| -------------------------------------------------- | ------------------------------------------------------------------------------------------ |
-| `replies`                                          | The replies to the post, oldest first, each carrying its own `replies`. See below.         |
-| `likes`                                            | The likes, oldest first, in the same shape.                                                |
-| `boosts`                                           | The boosts, oldest first, in the same shape. A webmention `repost` is one of them.         |
-| `mentions`                                         | The pages and fediverse quotes about this post, oldest first, in the same shape.           |
-| `counts.replies`                                   | How many replies, counted through the whole thread rather than the top of it.              |
-| `counts.likes`, `counts.boosts`, `counts.mentions` | How many of each.                                                                          |
-| `counts.total`                                     | All four added up. Zero never reaches a template: there would be no `conversation` at all. |
+| Key                                                | What it holds                                                                                                           |
+| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `replies`                                          | The replies to the post, oldest first, each carrying its own `replies`. See below.                                      |
+| `likes`                                            | The likes, oldest first, in the same shape.                                                                             |
+| `boosts`                                           | The boosts, oldest first, in the same shape. A webmention `repost` is one of them.                                      |
+| `mentions`                                         | The pages and fediverse quotes about this post, oldest first, in the same shape.                                        |
+| `rsvps`                                            | An event's answers, each group `{ value, label, people }`, going, maybe, interested, not going, only with people in it. |
+| `counts.replies`                                   | How many replies, counted through the whole thread rather than the top of it.                                           |
+| `counts.likes`, `counts.boosts`, `counts.mentions` | How many of each.                                                                                                       |
+| `counts.rsvps`                                     | How many people answered an event, in every group.                                                                      |
+| `counts.total`                                     | All of them added up. Zero never reaches a template: there would be no `conversation` at all.                           |
 
 Each entry — a reply, a like or a boost — is:
 
-| Key              | What it holds                                                                                                                                                                                                                                     |
-| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `id`             | What it is called: a reply's own note id, which is what an answer to it names.                                                                                                                                                                    |
-| `source`         | `"activitypub"` for a fediverse reply, `"comment"` for one left on the page, `"webmention"` for another page linking here.                                                                                                                        |
-| `kind`           | `"reply"`, `"like"`, `"boost"`, `"repost"` or `"mention"`. A `repost` comes from a webmention; a `mention` is a webmention or an approved fediverse quote.                                                                                        |
-| `author.name`    | The best name available: their display name, else their handle, else their server, else their id. For a webmention, the source's `h-card` name, else its host.                                                                                    |
-| `author.handle`  | `@user@host`, or `null`. Taken from the follower or actor profile the site holds, else guessed from the actor URL unless it ends in a number. `null` for a native comment.                                                                        |
-| `author.url`     | Their profile page, the website a commenter typed, or a webmention author's `u-url`. May be `null`, so guard the link.                                                                                                                            |
-| `author.avatar`  | Their avatar, or `null`. The site knows one for a fediverse actor whose profile it holds and for a webmention whose `h-card` carried a `u-photo`. Always a same-origin `/_geekity/avatars/…` path, never the remote URL: see [Avatars](#avatars). |
-| `author.actorId` | Their id, which is what identifies them however they are named. `null` for a native comment.                                                                                                                                                      |
-| `url`            | Where it can be read: the remote note's `url` for a fediverse reply or quote, the source page for a webmention, and `{permalink}#comment-{id}` — this page's own anchor — for a native comment.                                                   |
-| `content`        | What it says, **already sanitised**, so print it with `\| safe`. Empty for a like or a boost.                                                                                                                                                     |
-| `published`      | A `Date`: when it was published, or when it arrived if it did not say. Use the `date` filter.                                                                                                                                                     |
-| `inReplyTo`      | What it answers — the post's ActivityPub id, or another reply's — and `null` for a reaction.                                                                                                                                                      |
-| `status`         | `"published"`. On the record for the sources that moderate.                                                                                                                                                                                       |
-| `replies`        | The replies to this one, oldest first, nested as deep as the site has seen.                                                                                                                                                                       |
+| Key              | What it holds                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`             | What it is called: a reply's own note id, which is what an answer to it names.                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `source`         | `"activitypub"` for a fediverse reply, `"comment"` for one left on the page, `"webmention"` for another page linking here.                                                                                                                                                                                                                                                                                                                                                            |
+| `kind`           | `"reply"`, `"like"`, `"boost"`, `"repost"` or `"mention"`. A `repost` comes from a webmention; a `mention` is a webmention or an approved fediverse quote.                                                                                                                                                                                                                                                                                                                            |
+| `author.name`    | The best name available: their display name, else their handle, else their server, else their id. For a webmention, the source's `h-card` name, else its host.                                                                                                                                                                                                                                                                                                                        |
+| `author.handle`  | `@user@host`, or `null`. Taken from the follower or actor profile the site holds, else guessed from the actor URL unless it ends in a number. `null` for a native comment.                                                                                                                                                                                                                                                                                                            |
+| `author.url`     | Their profile page, the website a commenter typed, or a webmention author's `u-url`. May be `null`, so guard the link.                                                                                                                                                                                                                                                                                                                                                                |
+| `author.avatar`  | Their avatar, or `null`. The site knows one for a fediverse actor whose profile it holds and for a webmention whose `h-card` carried a `u-photo`. Always a same-origin `/_geekity/avatars/…` path, never the remote URL: see [Avatars](#avatars).                                                                                                                                                                                                                                     |
+| `author.actorId` | Their id, which is what identifies them however they are named. `null` for a native comment.                                                                                                                                                                                                                                                                                                                                                                                          |
+| `url`            | Where it can be read: the remote note's `url` for a fediverse reply or quote, the source page for a webmention, and `{permalink}#comment-{id}` — this page's own anchor — for a native comment.                                                                                                                                                                                                                                                                                       |
+| `content`        | What it says, **already sanitised**, so print it with `\| safe`. Empty for a like or a boost.                                                                                                                                                                                                                                                                                                                                                                                         |
+| `published`      | A `Date`: when it was published, or when it arrived if it did not say. Use the `date` filter.                                                                                                                                                                                                                                                                                                                                                                                         |
+| `inReplyTo`      | What it answers — the post's ActivityPub id, or another reply's — and `null` for a reaction.                                                                                                                                                                                                                                                                                                                                                                                          |
+| `status`         | `"published"`. On the record for the sources that moderate.                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `replies`        | The replies to this one, oldest first, nested as deep as the site has seen.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `rsvp`           | An RSVP: `{ value, label }`, its `p-rsvp` (`yes`, `no`, `maybe` or `interested`) and the words for it. Absent otherwise. A webmention reply that is an RSVP carries one, and the default theme prints it as a `data.p-rsvp` at the top of the comment's content. On an event, an RSVP is in `rsvps` rather than the thread, and so is a fediverse `Accept` (`yes`), `TentativeAccept` (`maybe`) or `Reject` (`no`) of the event. Each person is there once, with their latest answer. |
 
 Three rules decide what is in the thread, and they are the CMS's rather than a
 theme's: a reply whose author deleted it is gone, and its own answers move up to
@@ -1898,13 +1988,13 @@ the import above carries `with context`: a macro imported without it cannot see
 
 ## Filters
 
-| Filter                       | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `date(format, zone, locale)` | Formats a `Date` or a date string. `long` gives `2 September 2026` on an `en` site and `2 septembre 2026` on an `fr` one; `full`, `medium` and `short` are Intl's other date styles, and `readable` (the default) is `long`. `month` gives `September 2026`, `year` gives `2026`, `html` gives `2026-09-02` for a `<time datetime>`, and `iso` gives the full ISO 8601 instant. Every format but `html` and `iso` is written in the site's locale: the `locale` setting, or the `language` when that is empty. Bare `en` writes the day first, as `en-GB` does; `en-US` gives `September 2, 2026`. A date in a file is a UTC instant; every format but `iso` is rendered in the site's `timezone` setting, and `iso` stays the instant. Pass `zone` — an IANA name — to override the setting for one call. Pass `locale` — a BCP 47 tag — to write the words in another language for one call; it comes after `zone`, so pass `none` for the zone to keep the site's: `{{ date \| date("readable", none, lang) }}`. An empty locale, or one that is no tag, writes in the site's. A value that is not a date renders as the empty string. |
-| `plural(forms, locale)`      | Picks the form for a count by its plural category in the site's locale, through `Intl.PluralRules`: `{{ n \| plural({ one: "# reply", other: "# replies" }) }}`. The keys are the CLDR categories (`zero`, `one`, `two`, `few`, `many`, `other`), a category the forms leave out falls back to `other`, and `#` is the count in the locale's digits. Pass `locale` when the strings are in a language of their own: the default theme's words are English, so it passes `"en"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `url`                        | Prefixes a root-relative path with the base URL's path, so a site served from a subdirectory links correctly. Eleventy's filter of the same name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| `absoluteUrl`                | The same path as a fully qualified URL against the site's `baseUrl`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `asset`                      | The URL of a file in the theme's `static/` directory, with the base path in front and a hash of the file's bytes on the end: `{{ "style.css" \| asset }}` gives `/theme/style.css?v=3f2a9c01b7d4`. The file is found the way `/theme/` finds it, the chosen theme first. A hashed URL is served with `Cache-Control: public, max-age=31536000, immutable`, and editing the file changes the hash on the next render. A file no theme has gets its plain `/theme/` URL.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| Filter                       | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `date(format, zone, locale)` | Formats a `Date` or a date string. `long` gives `2 September 2026` on an `en` site and `2 septembre 2026` on an `fr` one; `full`, `medium` and `short` are Intl's other date styles, and `readable` (the default) is `long`. `datetime` gives `10 October 2026 at 09:00 GMT-5`, the day and the time with the zone named. `month` gives `September 2026`, `year` gives `2026`, `html` gives `2026-09-02` for a `<time datetime>`, and `iso` gives the full ISO 8601 instant. Every format but `html` and `iso` is written in the site's locale: the `locale` setting, or the `language` when that is empty. Bare `en` writes the day first, as `en-GB` does; `en-US` gives `September 2, 2026`. A date in a file is a UTC instant; every format but `iso` is rendered in the site's `timezone` setting, and `iso` stays the instant. Pass `zone` — an IANA name — to override the setting for one call. Pass `locale` — a BCP 47 tag — to write the words in another language for one call; it comes after `zone`, so pass `none` for the zone to keep the site's: `{{ date \| date("readable", none, lang) }}`. An empty locale, or one that is no tag, writes in the site's. A value that is not a date renders as the empty string. |
+| `plural(forms, locale)`      | Picks the form for a count by its plural category in the site's locale, through `Intl.PluralRules`: `{{ n \| plural({ one: "# reply", other: "# replies" }) }}`. The keys are the CLDR categories (`zero`, `one`, `two`, `few`, `many`, `other`), a category the forms leave out falls back to `other`, and `#` is the count in the locale's digits. Pass `locale` when the strings are in a language of their own: the default theme's words are English, so it passes `"en"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `url`                        | Prefixes a root-relative path with the base URL's path, so a site served from a subdirectory links correctly. Eleventy's filter of the same name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `absoluteUrl`                | The same path as a fully qualified URL against the site's `baseUrl`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `asset`                      | The URL of a file in the theme's `static/` directory, with the base path in front and a hash of the file's bytes on the end: `{{ "style.css" \| asset }}` gives `/theme/style.css?v=3f2a9c01b7d4`. The file is found the way `/theme/` finds it, the chosen theme first. A hashed URL is served with `Cache-Control: public, max-age=31536000, immutable`, and editing the file changes the hash on the next render. A file no theme has gets its plain `/theme/` URL.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 
 `date` reads one word rather than parsing it: `{{ "now" | date("year") }}` is
 the year at the moment the page is rendered, in the site's own timezone. It is

package/themes/default/layouts/410.njk

@@ -0,0 +1,10 @@
+{% extends "layouts/base.njk" %}
+{% import "partials/kicker.njk" as kicker with context %}
+
+{% block content %}
+<article class="not-found">
+  {{ kicker.line("Deleted") }}
+  <h1 class="page-title">This content has been deleted.</h1>
+  <p>Go <a href="{{ "/" | url }}">home</a>, or <a href="{{ "/search/" | url }}">search the site</a>.</p>
+</article>
+{% endblock %}

package/themes/default/layouts/base.njk

@@ -153,6 +153,9 @@
     {% if webmention %}
     <link rel="webmention" href="{{ webmention | url }}">
     {% endif %}
+    {% if pingback %}
+    <link rel="pingback" href="{{ pingback | absoluteUrl }}">
+    {% endif %}
     {#- The site's search, for a browser to offer from its address bar
         (TASK-204). #}
     <link rel="search" type="application/opensearchdescription+xml" title="{{ site.title }}" href="{{ "/opensearch.xml" | url }}">

package/themes/default/layouts/page.njk

@@ -61,6 +61,13 @@
   {% endif %}
 </article>
 
+{% if conversation %}
+{% include "partials/conversation.njk" %}
+{% endif %}
+{% if commentForm %}
+{% include "partials/comment-form.njk" %}
+{% endif %}
+
 {# Only a page whose front matter says `contact: true` has one (TASK-56). #}
 {% if contactForm %}
 {% include "partials/contact-form.njk" %}

package/themes/default/layouts/post.njk

@@ -31,7 +31,7 @@
 
 {% block content %}
 {% set entryUrl = page.url or url %}
-<article class="blog-post h-entry"{{ language.attr(lang) }}>
+<article class="blog-post {{ "h-event" if postType == "event" else "h-entry" }}"{{ language.attr(lang) }}>
   {#- A post with no name of its own (a note, or a reply without a title) is
       its words, so it opens on them in sight. Its page still needs one h1 to
       navigate by, so it gets one that says what it is, who wrote it and when,
@@ -39,21 +39,23 @@
       title and read the note as an article. -#}
   {% if named %}
   <header class="post-header">
-    {{ kicker.line(postType | capitalize, false, false, categories) }}
+    {{ kicker.line("RSVP" if postType == "rsvp" else postType | capitalize, false, false, categories) }}
     <h1 class="p-name">{{ title }}</h1>
     {% if description %}
     <p class="post-deck p-summary">{{ description }}</p>
     {% endif %}
   </header>
+  {% include "partials/event.njk" %}
   {% include "partials/reply-context.njk" %}
   {% include "partials/citations.njk" %}
   {% else %}
   <h1 class="screen-reader-text">
-    {{- postType | capitalize if postType in ["reply", "like", "repost", "bookmark", "read"] else "Note" }}
+    {{- "RSVP" if postType == "rsvp" else (postType | capitalize if postType in ["event", "reply", "like", "repost", "bookmark", "read"] else "Note") }}
     {%- if bioAuthor.name %} by {{ bioAuthor.name }}{% endif %}
     {%- if date %}, {{ date | date("readable", none, lang) }}{% endif -%}
   </h1>
-  {{ kicker.line(postType | capitalize, false, false, categories) }}
+  {{ kicker.line("RSVP" if postType == "rsvp" else postType | capitalize, false, false, categories) }}
+  {% include "partials/event.njk" %}
   {% include "partials/reply-context.njk" %}
   {% include "partials/citations.njk" %}
   {% endif %}
@@ -69,6 +71,7 @@
   <section class="e-content">
     {#- Inside the content, so a parser that reads only the content of a
         read, as a webmention receiver does, has its sentence. -#}
+    {% include "partials/rsvp.njk" %}
     {% include "partials/read.njk" %}
     {{ content | safe }}
     <p class="entry-meta">

package/themes/default/layouts/search.njk

@@ -37,7 +37,7 @@
 <div class="search-results">
   {% for post in posts %}
   <article class="search-result h-entry"{{ language.attr(post.lang) }}>
-    {{ kicker.line(("Page" if post.type == "page" else post.postType) | capitalize, post.date, lang=post.lang) }}
+    {{ kicker.line("Page" if post.type == "page" else ("RSVP" if post.postType == "rsvp" else post.postType | capitalize), post.date, lang=post.lang) }}
     {#- A post with no name of its own has none to claim, so its first words
         link it without being marked up as one. -#}
     <h2 class="feed-title{% if post.named %} p-name{% endif %}">

package/themes/default/partials/cited-page.njk

@@ -23,6 +23,11 @@
   `og:site_name`), printed after a middle dot as plain text: a site is not an
   author, so it is no `h-card`.
 
+  The author's `h-card` shows their photo before their name when the page
+  gave one (`author.photo.imgHtml`, an `img.u-photo` copied into the site's
+  uploads, TASK-199), and a fediverse author's handle after it as its
+  `p-nickname`, written `@user@host`.
+
   `thumb(url, picture)` is a cited page's thumbnail (TASK-252): a link to the
   page around `picture.imgHtml`, out of the tab order and hidden from assistive
   technology because the title beside it is the same link. A video's carries
@@ -52,7 +57,9 @@
 
 {% macro card(author, name) -%}
 <span class="p-author h-card">
+  {%- if author.photo %}{{ author.photo.imgHtml | safe }}{% endif -%}
   {%- if author.url %}<a class="u-url p-name" href="{{ author.url }}">{{ name }}</a>
   {%- else %}<span class="p-name">{{ name }}</span>{% endif -%}
+  {%- if author.handle %} <span class="p-nickname cite-handle">@{{ author.handle }}</span>{% endif -%}
 </span>
 {%- endmacro %}

package/themes/default/partials/conversation.njk

@@ -3,11 +3,13 @@
   grouped by kind, and the replies as a thread, in the source design's markup
   (decision-16, TASK-84).
 
-  Rendered from `layouts/post.njk` with the `conversation` on the context,
-  which is only there when there is something in it, so a post nobody has
-  answered renders none of this. A site replaces the whole section with a
-  `partials/conversation.njk` of its own in the theme it wears; the shape it is
-  handed is documented in the theme README under "The conversation".
+  Rendered from `layouts/post.njk` and `layouts/page.njk` with the
+  `conversation` on the context, which is only there when there is something
+  in it and, on a page, only while the page takes comments (TASK-196), so a
+  post nobody has answered renders none of this. A site replaces the whole
+  section with a `partials/conversation.njk` of its own in the theme it wears;
+  the shape it is handed is documented in the theme README under "The
+  conversation".
 
   The macros come first because Nunjucks defines one where it stands rather
   than hoisting it, and the two sections below call them.
@@ -80,6 +82,9 @@
       </div>
     </footer>
     <div class="comment-content e-content">
+      {%- if reply.rsvp %}
+      <p class="comment-rsvp"><data class="p-rsvp" value="{{ reply.rsvp.value }}">{{ reply.rsvp.label }}</data></p>
+      {%- endif %}
       {{ reply.content | safe }}
     </div>
     {#
@@ -102,6 +107,21 @@
 </li>
 {% endmacro %}
 
+{#
+  Who is coming to an event (TASK-200): each answer it was given, by a
+  webmention RSVP or a fediverse Accept, TentativeAccept or Reject, as a
+  facepile per answer in the order `conversation.rsvps` gives them, going
+  first. A post that is no event has no groups.
+#}
+{% set rsvpIcons = { yes: "✅", maybe: "🤔", interested: "⭐", no: "❌" } %}
+{% if conversation.rsvps.length %}
+<div class="reactions-section rsvps-section">
+  {%- for answer in conversation.rsvps %}
+  {{- group(answer.people, answer.label, "rsvp-" + answer.value, rsvpIcons[answer.value]) }}
+  {%- endfor %}
+</div>
+{% endif %}
+
 {#
   The reactions, above the thread. A like and a boost come from the fediverse
   and a `repost` from a webmention; the CMS has already put a repost among the

package/themes/default/partials/event.njk

@@ -0,0 +1,27 @@
+{#
+  When and where an event is (TASK-200): its `dt-start`, its `dt-end` when it
+  has one, and its `p-location`, the place's words or a link to join it
+  online. `layouts/post.njk` includes it inside the h-event with `event` on
+  the context. The times are the site's clock (decision-11), named with its
+  zone so a reader elsewhere can work out their own; the `datetime` is the
+  instant.
+#}
+{% if event %}
+<dl class="event-details">
+  <dt>When</dt>
+  <dd>
+    <time class="dt-start" datetime="{{ event.start | date("iso") }}">{{ event.start | date("datetime", none, lang) }}</time>
+    {%- if event.end %} to <time class="dt-end" datetime="{{ event.end | date("iso") }}">{{ event.end | date("datetime", none, lang) }}</time>{% endif %}
+  </dd>
+  {% if event.location %}
+  <dt>Where</dt>
+  <dd>
+    {%- if event.location.kind == "virtual" -%}
+    Online at <a class="p-location" href="{{ event.location.url }}">{{ event.location.url | host }}</a>
+    {%- else -%}
+    <span class="p-location">{{ event.location.name }}</span>
+    {%- endif -%}
+  </dd>
+  {% endif %}
+</dl>
+{% endif %}

package/themes/default/partials/jsonld.njk

@@ -127,6 +127,34 @@
       {{- member("mainEntity", person) }}
     }{% endset %}
 {% set _ = nodes.push(profilePage) %}
+{% elif isEntry and event %}
+{% if event.location.kind == "virtual" %}
+{% set eventLocation = { "@type": "VirtualLocation", "url": event.location.url } %}
+{% set attendance = "https://schema.org/OnlineEventAttendanceMode" %}
+{% elif event.location %}
+{% set eventLocation = { "@type": "Place", "name": event.location.name, "address": event.location.name } %}
+{% set attendance = "https://schema.org/OfflineEventAttendanceMode" %}
+{% else %}
+{% set eventLocation = "" %}
+{% set attendance = "" %}
+{% endif %}
+{% set entry %}
+    {
+      "@type": "Event"
+      {{- member("@id", metaUrl + "#event") }}
+      {{- member("name", headline) }}
+      {{- member("url", metaUrl) }}
+      {{- member("mainEntityOfPage", metaUrl) }}
+      {{- member("startDate", event.start | date("iso")) }}
+      {{- member("endDate", event.end | date("iso") if event.end else "") }}
+      {{- member("location", eventLocation) }}
+      {{- member("eventAttendanceMode", attendance) }}
+      {{- member("eventStatus", "https://schema.org/EventScheduled") }}
+      {{- member("description", metaDescription) }}
+      {{- member("image", entryImage) }}
+      {{- member("organizer", person or publisher) }}
+    }{% endset %}
+{% set _ = nodes.push(entry) %}
 {% elif isEntry %}
 {% set entry %}
     {

package/themes/default/partials/post-list.njk

@@ -29,13 +29,14 @@
   {% endif %}
   <article class="feed-item h-entry"{{ language.attr(post.lang) }}>
     {% if post.named %}
-    {{ kicker.line(post.postType | capitalize, post.date, false, post.categories, lang=post.lang) }}
+    {{ kicker.line("RSVP" if post.postType == "rsvp" else post.postType | capitalize, post.date, false, post.categories, lang=post.lang) }}
     {% else %}
-    {{ kicker.line(post.postType | capitalize, post.date, post.url, [], post.label, lang=post.lang) }}
+    {{ kicker.line("RSVP" if post.postType == "rsvp" else post.postType | capitalize, post.date, post.url, [], post.label, lang=post.lang) }}
     {% endif %}
     {% set cited %}
     {% if post.inReplyTo %}
     {% set inReplyTo = post.inReplyTo %}
+    {% set rsvp = post.rsvp %}
     {% set replyContext = post.replyContext %}
     {% set lang = post.lang %}
     {% include "partials/reply-context.njk" %}
@@ -44,6 +45,8 @@
     {% include "partials/citations.njk" %}
     {% endset %}
     {% if not post.named %}{{ cited | safe }}{% endif %}
+    {% set rsvp = post.rsvp %}
+    {% include "partials/rsvp.njk" %}
     {% set read = post.read %}
     {% include "partials/read.njk" %}
     {% if post.photos.length %}

package/themes/default/partials/reply-context.njk

@@ -18,19 +18,39 @@
 
   `replyContext.picture`, when the target has one and the reply shows it, is
   drawn as a thumbnail beside the line, as `citations.njk` draws it (TASK-252).
+
+  An RSVP (`rsvp` on the context, TASK-198) says "RSVP to" rather than "In
+  reply to", and an event's `replyContext.start` and `replyContext.location`
+  follow its name as a `dt-start` and a `p-location`. `startDate` is the
+  instant to print and `startZone` the zone to print it in: "UTC" for a start
+  the event page wrote with no zone, which is the wall clock where the event
+  is, and nothing otherwise, so the site's zone applies. The `dt-start`
+  carries `start` as the page wrote it.
+
+  `replyContext.original`, when the target is a silo copy of a post that lists
+  the copy as its own (TASK-197), is the post cited: the `h-cite` links the
+  original and describes it, so its site finds the link when it is sent a
+  webmention. The copy follows the citation as a `u-in-reply-to` of its own,
+  outside the `h-cite`, so the silo can thread the reply too.
 #}
 {% import "partials/cited-page.njk" as cited %}
 {% if inReplyTo %}
 {% set picture = replyContext.picture %}
+{% set answered = replyContext.original or inReplyTo %}
 <div class="reply-context cite u-in-reply-to h-cite{% if picture %} cite-with-thumb{% endif %}">
-  {%- if picture %}{{ cited.thumb(inReplyTo, picture) }}{% endif %}
-  <p class="cite-line small">In reply to
-    {{- cited.page(inReplyTo, replyContext) }}
-    {%- if replyContext.published %}, <time class="dt-published" datetime="{{ replyContext.published | date("iso") }}">{{ replyContext.published | date("readable", none, lang) }}</time>
+  {%- if picture %}{{ cited.thumb(answered, picture) }}{% endif %}
+  <p class="cite-line small">{{ "RSVP to" if rsvp else "In reply to" }}
+    {{- cited.page(answered, replyContext) }}
+    {%- if replyContext.startDate %}, <time class="dt-start" datetime="{{ replyContext.start }}">{{ replyContext.startDate | date("readable", replyContext.startZone, lang) }}</time>
+    {%- elif replyContext.published %}, <time class="dt-published" datetime="{{ replyContext.published | date("iso") }}">{{ replyContext.published | date("readable", none, lang) }}</time>
     {%- endif -%}
+    {%- if replyContext.location %}, <span class="p-location">{{ replyContext.location }}</span>{% endif -%}
   </p>
   {% if replyContext.text %}
   <blockquote class="cite-quote p-content">{{ replyContext.text }}</blockquote>
   {% endif %}
 </div>
+{% if replyContext.original %}
+<p class="cite-copy small">Also in reply to <a class="u-in-reply-to" href="{{ inReplyTo }}">its copy on {{ inReplyTo | host }}</a></p>
+{% endif %}
 {% endif %}

package/themes/default/partials/rsvp.njk

@@ -0,0 +1,7 @@
+{#
+  An RSVP's answer, the `p-rsvp` (TASK-198), as the line its content opens
+  with. An entry includes it with `rsvp` on the context; a listing sets it
+  from the entry it is printing. Nothing is printed for a post that is no
+  RSVP.
+#}
+{% if rsvp %}{{ rsvp.line | safe }}{% endif %}