@geekity/cms 0.15.0 → 0.17.0

package/dist/webmention/syndication.js

@@ -0,0 +1,337 @@
+import path from 'node:path';
+import { readFileIfPresentSync, withFileLock, writeFileAtomicallySync } from '../files/atomic.js';
+import { canonicalLocale, DEFAULT_LOCALE, documentLanguage } from '../web/locale.js';
+/**
+ * Syndication targets (TASK-155): services such as IndieNews and Bridgy
+ * Publish that take a copy of a post when it links to them and sends them a
+ * webmention, and answer with the URL of the copy they made.
+ *
+ * Nothing here names a service. A site declares its targets in
+ * {@link SYNDICATION_TARGETS_FILE}; a post selects some with its
+ * `syndicate-to` list or by carrying a target's tag; the theme links to each
+ * one inside the post's h-entry; the sender notifies them as it notifies any
+ * linked page; and the URL each one answers with is kept in
+ * {@link SYNDICATION_FILE} (decision-26) and printed as `u-syndication`.
+ */
+/** Where a site declares its targets, relative to the content directory. */
+export const SYNDICATION_TARGETS_FILE = '_data/syndicationTargets.json';
+/**
+ * Where the copies targets answered with are kept, relative to the content
+ * directory: one object keyed by a post's permalink, each mapping a target's
+ * URL to the copy it made (decision-26). Eleventy reads it as `syndication`.
+ */
+export const SYNDICATION_FILE = '_data/syndication.json';
+/** The front matter key a post lists the ids of its targets under. */
+export const SYNDICATE_TO_FRONT_MATTER_KEY = 'syndicate-to';
+/** The front matter key, and mf2 property, for the URLs of a post's copies. */
+export const SYNDICATION_FRONT_MATTER_KEY = 'syndication';
+/** What an id may be made of, so it can name a form field and a Micropub uid alike. */
+const ID_PATTERN = /^[A-Za-z0-9._-]+$/;
+/** What a target's `url` may hold to follow the post's language (TASK-156). */
+export const LANGUAGE_PLACEHOLDER = '{lang}';
+/** Read the targets file's text. An entry that is not a target is reported and left out. */
+export function parseSyndicationTargets(text) {
+    const read = syndicationEntries(text);
+    if ('problem' in read)
+        return { targets: [], problems: [read.problem] };
+    const targets = [];
+    const problems = [];
+    read.entries.forEach((entry, index) => {
+        if ('target' in entry) {
+            targets.push(entry.target);
+            return;
+        }
+        const id = isRecord(entry.raw) && typeof entry.raw['id'] === 'string' ? entry.raw['id'] : '';
+        const named = id === '' ? '' : ` ("${id}")`;
+        problems.push(`${SYNDICATION_TARGETS_FILE} entry ${String(index + 1)}${named} was ignored. ${entry.problems.join(' ')}`);
+    });
+    return { targets, problems };
+}
+/**
+ * Every entry of the targets file's text, each with the target it declares or
+ * its problems, in file order. A later entry repeating an earlier one's id
+ * declares nothing, so the first one wins.
+ */
+export function syndicationEntries(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return { problem: `${SYNDICATION_TARGETS_FILE} is not valid JSON.` };
+    }
+    if (!Array.isArray(parsed)) {
+        return { problem: `${SYNDICATION_TARGETS_FILE} is not a list of targets.` };
+    }
+    const seen = new Set();
+    const entries = parsed.map((raw) => {
+        if (!isRecord(raw)) {
+            return { raw, problems: ['It is not an object with an id, a name and a url.'] };
+        }
+        const checked = checkSyndicationTarget(raw);
+        if ('problems' in checked)
+            return { raw, problems: Object.values(checked.problems) };
+        if (seen.has(checked.target.id)) {
+            return { raw, problems: [repeatedIdProblem(checked.target.id)] };
+        }
+        seen.add(checked.target.id);
+        return { raw, target: checked.target };
+    });
+    return { entries };
+}
+/** What an id another target already has is told. */
+export function repeatedIdProblem(id) {
+    return `Another target already has the id "${id}".`;
+}
+/**
+ * One entry as a target, or a sentence for each key that is wrong. The one
+ * rule a target is read by, whether it comes from the file or from the admin's
+ * form; whether its id is unique depends on the other entries, so that is the
+ * caller's.
+ */
+export function checkSyndicationTarget(entry) {
+    const { id, name, url, tag, languages } = entry;
+    const problems = {};
+    if (typeof id !== 'string' || !ID_PATTERN.test(id)) {
+        problems.id = 'An id is letters, digits, dots, dashes and underscores, and nothing else.';
+    }
+    if (typeof name !== 'string' || name.trim() === '')
+        problems.name = 'A target needs a name.';
+    const href = urlTemplate(url);
+    if (href === undefined) {
+        problems.url = `The url must be an http or https address. It may hold ${LANGUAGE_PLACEHOLDER} where the language goes.`;
+    }
+    if (tag !== undefined && (typeof tag !== 'string' || tag.trim() === '')) {
+        problems.tag = 'A tag must be a word, or left out.';
+    }
+    const tags = languages === undefined ? undefined : languageList(languages);
+    if (tags === null) {
+        problems.languages = 'Languages must be a list of language tags, such as en or de-AT.';
+    }
+    if (typeof id !== 'string' ||
+        typeof name !== 'string' ||
+        href === undefined ||
+        tags === null ||
+        Object.keys(problems).length > 0) {
+        return { problems };
+    }
+    return {
+        target: {
+            id,
+            name: name.trim(),
+            url: href,
+            ...(typeof tag === 'string' ? { tag: tag.trim() } : {}),
+            ...(tags === undefined ? {} : { languages: tags }),
+        },
+    };
+}
+/**
+ * A declared `url` as kept: an http or https URL, which may hold
+ * {@link LANGUAGE_PLACEHOLDER}. One with the placeholder is checked with a
+ * language filled in and kept as written, since a URL parser would escape the
+ * braces.
+ */
+function urlTemplate(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    if (!value.includes(LANGUAGE_PLACEHOLDER))
+        return webUrl(value);
+    const template = value.trim();
+    return webUrl(fillLanguage(template, DEFAULT_LOCALE)) === undefined ? undefined : template;
+}
+/** A non-empty list of language tags, canonical, or `null` when it is not one. */
+function languageList(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return null;
+    const tags = [];
+    for (const item of value) {
+        const tag = typeof item === 'string' ? canonicalLocale(item) : undefined;
+        if (tag === undefined)
+            return null;
+        tags.push(tag);
+    }
+    return tags;
+}
+/** A reader over one content directory's targets file. A missing file declares none. */
+export function syndicationTargetsReader(contentDir) {
+    const file = path.join(contentDir, ...SYNDICATION_TARGETS_FILE.split('/'));
+    let cachedText;
+    let cached = [];
+    return () => {
+        const text = readFileIfPresentSync(file);
+        if (text === undefined) {
+            cachedText = undefined;
+            cached = [];
+        }
+        else if (text !== cachedText) {
+            cachedText = text;
+            cached = parseSyndicationTargets(text).targets;
+        }
+        return cached;
+    };
+}
+/** What is wrong with a content directory's targets file, for the boot log. */
+export function syndicationTargetProblems(contentDir) {
+    const text = readFileIfPresentSync(path.join(contentDir, ...SYNDICATION_TARGETS_FILE.split('/')));
+    return text === undefined ? [] : parseSyndicationTargets(text).problems;
+}
+/**
+ * The declared targets a post selects, in the order the site declares them,
+ * each with its `url` filled for the post: those its `syndicate-to` names, and
+ * those whose tag it carries. An id nobody declared selects nothing.
+ *
+ * The post's language is its own `lang`, else `siteLanguage` (TASK-156). A
+ * target that lists `languages` is selected only for a post in one of them or
+ * in a regional form of one, so `de-AT` goes to a target that lists `de`, and
+ * {@link LANGUAGE_PLACEHOLDER} takes the listed tag; without a list it takes
+ * the post's. The one place the URL is decided, so the theme's link, the
+ * webmention and the stored copy's key cannot disagree.
+ */
+export function selectedTargets(document, targets, siteLanguage) {
+    const listed = new Set(stringsOf(document.extra[SYNDICATE_TO_FRONT_MATTER_KEY]));
+    const tags = new Set(document.tags.map((tag) => tag.toLowerCase()));
+    const language = documentLanguage(document) ?? canonicalLocale(siteLanguage) ?? DEFAULT_LOCALE;
+    return targets.flatMap((target) => {
+        const selected = listed.has(target.id) || (target.tag !== undefined && tags.has(target.tag.toLowerCase()));
+        if (!selected)
+            return [];
+        const filled = target.languages === undefined ? language : matchingLanguage(language, target.languages);
+        if (filled === undefined)
+            return [];
+        if (!target.url.includes(LANGUAGE_PLACEHOLDER))
+            return [target];
+        const url = webUrl(fillLanguage(target.url, filled));
+        return url === undefined ? [] : [{ ...target, url }];
+    });
+}
+/** The first of `languages` that `language` is, or is a regional form of. */
+function matchingLanguage(language, languages) {
+    const wanted = language.toLowerCase();
+    return languages.find((tag) => {
+        const listed = tag.toLowerCase();
+        return wanted === listed || wanted.startsWith(`${listed}-`);
+    });
+}
+function fillLanguage(template, language) {
+    return template.replaceAll(LANGUAGE_PLACEHOLDER, encodeURIComponent(language));
+}
+/** The ids a post's `syndicate-to` lists, as written. */
+export function syndicateToOf(extra) {
+    return stringsOf(extra[SYNDICATE_TO_FRONT_MATTER_KEY]);
+}
+/** The copies an author listed by hand under `syndication`, each an http or https URL. */
+export function handSyndicationOf(extra) {
+    return stringsOf(extra[SYNDICATION_FRONT_MATTER_KEY]).flatMap((value) => webUrl(value) ?? []);
+}
+/** The copies file of one content directory. */
+export function syndicationCopies(contentDir) {
+    const file = path.join(contentDir, ...SYNDICATION_FILE.split('/'));
+    let cachedText;
+    let cached = {};
+    function readAll() {
+        const text = readFileIfPresentSync(file);
+        if (text === undefined) {
+            cachedText = undefined;
+            cached = {};
+        }
+        else if (text !== cachedText) {
+            cachedText = text;
+            cached = parseCopies(text);
+        }
+        return cached;
+    }
+    /**
+     * Change the file under its lock, and write it only when something changed:
+     * a resend that gets the same copy back must not churn a file that is in the
+     * site's git history.
+     */
+    function update(change) {
+        return withFileLock(file, () => {
+            const current = readFileIfPresentSync(file);
+            const all = current === undefined ? {} : parseCopies(current);
+            if (change(all))
+                writeFileAtomicallySync(file, `${JSON.stringify(all, null, 2)}\n`);
+        });
+    }
+    return {
+        read(permalink) {
+            return readAll()[permalink] ?? {};
+        },
+        write(permalink, target, copy) {
+            return update((all) => {
+                const copies = { ...all[permalink] };
+                if (copies[target] === copy)
+                    return false;
+                if (copy === undefined)
+                    delete copies[target];
+                else
+                    copies[target] = copy;
+                if (Object.keys(copies).length === 0)
+                    delete all[permalink];
+                else
+                    all[permalink] = copies;
+                return true;
+            });
+        },
+        forget(permalink) {
+            return update((all) => {
+                if (!(permalink in all))
+                    return false;
+                delete all[permalink];
+                return true;
+            });
+        },
+    };
+}
+/**
+ * The copies file's entries, each checked, since a person may edit it by hand.
+ * An entry that is not a URL is dropped rather than failing a render.
+ */
+function parseCopies(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+    if (!isRecord(parsed))
+        return {};
+    const all = {};
+    for (const [permalink, value] of Object.entries(parsed)) {
+        if (!isRecord(value))
+            continue;
+        const copies = {};
+        for (const [target, copy] of Object.entries(value)) {
+            const href = webUrl(copy);
+            if (href !== undefined)
+                copies[target] = href;
+        }
+        if (Object.keys(copies).length > 0)
+            all[permalink] = copies;
+    }
+    return all;
+}
+/** A front matter value as a list of strings: a lone string is a list of one. */
+function stringsOf(value) {
+    if (typeof value === 'string')
+        return value === '' ? [] : [value];
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === 'string' && item !== '');
+}
+function webUrl(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    try {
+        const url = new URL(value);
+        return url.protocol === 'http:' || url.protocol === 'https:' ? url.href : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=syndication.js.map

package/dist/webmention/syndication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syndication.js","sourceRoot":"","sources":["../../src/webmention/syndication.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekity/cms",
-  "version": "0.15.0",
+  "version": "0.17.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

@@ -25,6 +25,7 @@ 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
+    citations.njk     the citation of what a like, repost or bookmark cites
     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>
@@ -334,8 +335,8 @@ is a microformats2 `h-entry`. An article, and a page:
   <section class="e-content">
     <p>The rendered body.</p>
     <p class="entry-meta">
-      <a class="u-category small" href="https://news.indieweb.org/en"
-        >#indienews</a
+      <a class="u-syndication small" href="https://news.indieweb.org/en"
+        >IndieNews</a
       >
       <a href="/2026/09/hello/" class="u-url"
         ><time class="small dt-published" datetime="2026-09-02T09:00:00.000Z"
@@ -346,6 +347,13 @@ is a microformats2 `h-entry`. An article, and a page:
       <time class="small dt-updated" datetime="2026-09-05T09:00:00.000Z"
         >Updated 5 September 2026</time
       >
+      <span aria-hidden="true">·</span>
+      <span class="small"
+        >Also on
+        <a class="u-syndication" href="https://news.indieweb.org/en/…"
+          >news.indieweb.org</a
+        ></span
+      >
     </p>
   </section>
   <p class="post-categories">…tags…</p>
@@ -369,10 +377,11 @@ permalink are part of the words, so a reader, or a fediverse peer reading the
 `e-content`, takes them with the post. The permalink wraps the `dt-published`
 time as a `u-url`, and a `dt-updated` follows it after a middle dot only when
 the update happened on a different day in the site's own timezone; a typo fixed
-an hour later is not news. A post tagged `indienews` opens the line with a
-`u-category` link to <https://news.indieweb.org/en>, which is how IndieNews is
-told the post is for it; a page never prints one, and its line is a
-`p.page-meta` rather than a `p.entry-meta`.
+an hour later is not news. The line opens with a `u-syndication` link to each
+syndication target the post selects (`syndicateTo`, TASK-155), which is what
+IndieNews and Bridgy Publish look for on the page, and ends with the post's
+copies elsewhere (`syndication`) after **Also on**. A page never prints either,
+and its line is a `p.page-meta` rather than a `p.entry-meta`.
 
 **Every post's page has one `h1`.** A post with a name of its own is headed by
 it, as above. A note, or a reply without a title, opens on its words instead,
@@ -385,7 +394,7 @@ who wrote it and when, and then the kicker:
 <p class="kicker"><span class="kicker-kind">Note</span></p>
 ```
 
-It says `Reply` for a reply and leaves out the name or the date the post does
+It says `Reply`, `Like`, `Repost` or `Bookmark` for those and leaves out the name or the date the post does
 not have. It is not a `p-name`: a parser that found one would take the post
 for an article. The headings under it step down one level at a time: the
 conversation and the comment form are `h2`, and a refused form's error summary
@@ -398,6 +407,14 @@ far as they are known, and its excerpt as a `blockquote.cite-quote.p-content`.
 An untitled reply prints it under the kicker; a titled reply prints it above
 its header. The same partial cites a reply in a feed.
 
+**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
+`u-repost-of`, `u-like-of` or `u-bookmark-of`, whose `p.cite-line` says
+Reposted, Liked or Bookmarked and links the target as its `u-url`. Its kicker
+and its hidden `h1` say Repost, Like or Bookmark. A listing cites each entry's
+from the same partial.
+
 The tags are printed under the words and inside the article, so that each link
 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
@@ -416,6 +433,16 @@ 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.
 
+**A post with photos shows them** (TASK-166), from `partials/photos.njk`, after
+the recording and before the `e-content`, each in a `figure.post-photo`. Each is
+the context's `photo.html`: an `<img class="u-photo">` with its alt text, so a
+microformats parser finds every photo on the entry, and a `<picture>` with the
+upload's resizes when it has them. The alt text is the post's own, else the
+media library's. A listing prints them the same way above each entry, and the
+JSON-LD `BlogPosting` lists each as an `ImageObject` with its absolute `url`
+and its alt text as `caption`. The first photo is the post's share image when
+its front matter names no `image`.
+
 ```html
 <figure class="post-recording">
   <audio controls preload="metadata" aria-label="Recording of Episode twelve">
@@ -442,8 +469,8 @@ 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 IndieNews
-link, because none of those are things a page has.
+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
 
@@ -1138,6 +1165,10 @@ A document — one post, one page, or one entry of a listing — adds:
 | `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.     |
+| `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 }` with `property` the mf2 name. Empty with none.      |
+| `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). |
 | `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/post.njk

@@ -39,6 +39,7 @@
   {#- A reply cites the post it answers, whose URL is also the link its
       webmention points a receiver at. -#}
   {% include "partials/reply-context.njk" %}
+  {% include "partials/citations.njk" %}
   <header class="post-header">
     {{ kicker.line(postType | capitalize, false, false, categories) }}
     <h1 class="p-name">{{ title }}</h1>
@@ -48,26 +49,33 @@
   </header>
   {% else %}
   <h1 class="screen-reader-text">
-    {{- "Reply" if postType == "reply" else "Note" }}
+    {{- postType | capitalize if postType in ["reply", "like", "repost", "bookmark"] 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) }}
   {% include "partials/reply-context.njk" %}
+  {% include "partials/citations.njk" %}
   {% endif %}
 
   {% if enclosure %}
   {% include "partials/recording.njk" %}
   {% endif %}
 
+  {% if photos.length %}
+  {% include "partials/photos.njk" %}
+  {% endif %}
+
   <section class="e-content">
     {{ content | safe }}
     <p class="entry-meta">
-      {#- A post tagged `indienews` opens the line with the link that submits
-          it there, which is how IndieNews is told the post is for it. -#}
-      {%- if "indienews" in tags %}
-      <a class="u-category small" href="https://news.indieweb.org/en">#indienews</a>
-      {%- endif %}
+      {#- The line opens with a link to each syndication target the post
+          selects (TASK-155). It is inside the h-entry and marked
+          `u-syndication`, the markup IndieNews documents, and a target that
+          is sent a webmention checks the page for it. -#}
+      {%- for target in syndicateTo %}
+      <a class="u-syndication small" href="{{ target.url }}">{{ target.name }}</a>
+      {%- endfor %}
       {%- if date %}
       <a href="{{ entryUrl | url }}" class="u-url"><time class="small dt-published" datetime="{{ date | date("iso") }}">Published {{ date | date("readable", none, lang) }}</time></a>
       {%- endif %}
@@ -75,6 +83,11 @@
           a typo fixed an hour after publishing is not news. -#}
       {%- if updated and (not date or (updated | date("html")) != (date | date("html"))) %}
       {% if date %}<span aria-hidden="true">·</span> {% endif %}<time class="small dt-updated" datetime="{{ updated | date("iso") }}">Updated {{ updated | date("readable", none, lang) }}</time>
+      {%- endif %}
+      {#- The post's copies elsewhere: those its targets answered with and
+          those its front matter lists by hand. -#}
+      {%- if syndication.length %}
+      {% if date or updated %} <span aria-hidden="true">·</span> {% endif %}<span class="small">Also on {% for copy in syndication %}<a class="u-syndication" href="{{ copy.url }}">{{ copy.label }}</a>{% if not loop.last %}, {% endif %}{% endfor %}</span>
       {%- endif -%}
     </p>
   </section>

package/themes/default/partials/citations.njk

@@ -0,0 +1,17 @@
+{#
+  What a post reposts, likes or bookmarks (TASK-169), cited the way a reply
+  cites what it answers: each one an embedded `h-cite` under its own mf2
+  property, `u-repost-of`, `u-like-of` or `u-bookmark-of`, that always carries
+  the target's URL, so a parser reads what the post cites and the page its
+  webmention names links to it.
+
+  Drawn as the same citation block as `reply-context.njk` (doc-9). An entry
+  includes it with `citations` on the context, a list of `{ property, url }`;
+  a feed sets it from the entry it is printing.
+#}
+{% set citationVerbs = { "repost-of": "Reposted", "like-of": "Liked", "bookmark-of": "Bookmarked" } %}
+{% for citation in citations %}
+<div class="reply-context cite u-{{ citation.property }} h-cite">
+  <p class="cite-line small">{{ citationVerbs[citation.property] }} <a class="u-url" href="{{ citation.url }}">{{ citation.url }}</a></p>
+</div>
+{% endfor %}

package/themes/default/partials/jsonld.njk

@@ -56,6 +56,17 @@
     within the 110 characters Google reads, cut where a word ends (TASK-201).
     A page keeps its title. -#}
 {% set headline = title or (label | truncate(109, false, "…") if type == "post" else "") %}
+{#- A photo post's image is its photos, each an ImageObject captioned with
+    its alt text, in order (TASK-166); anything else's is the share image. -#}
+{% set entryImage = metaImage | absoluteUrl if metaImage else "" %}
+{% if photos and photos.length %}
+{% set entryImage = [] %}
+{% for photo in photos %}
+{% set imageObject = { "@type": "ImageObject", "url": photo.url | absoluteUrl } %}
+{% if photo.alt %}{% set imageObject = { "@type": "ImageObject", "url": photo.url | absoluteUrl, "caption": photo.alt } %}{% endif %}
+{% set _ = entryImage.push(imageObject) %}
+{% endfor %}
+{% endif %}
 {% set nodes = [] %}
 {% set website %}
     {
@@ -126,7 +137,7 @@
       {{- 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", metaImage | absoluteUrl if metaImage else "") }}
+      {{- member("image", entryImage) }}
       {{- member("author", person) }}
       {{- member("publisher", publisher) }}
       {{- member("license", license.url if license else "") }}

package/themes/default/partials/photos.njk

@@ -0,0 +1,10 @@
+{#
+  A post's photos (TASK-166), each `photo.html`: an `img.u-photo` with its alt
+  text, so a microformats parser finds every photo on the h-entry, served as a
+  responsive picture when the upload has variants.
+#}
+<div class="post-photos">
+  {% for photo in photos %}
+  <figure class="post-photo">{{ photo.html | safe }}</figure>
+  {% endfor %}
+</div>

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

@@ -39,6 +39,13 @@
     {% set lang = post.lang %}
     {% include "partials/reply-context.njk" %}
     {% endif %}
+    {#- What it reposts, likes or bookmarks, from the partial an entry uses. -#}
+    {% set citations = post.citations %}
+    {% include "partials/citations.njk" %}
+    {% if post.photos.length %}
+    {% set photos = post.photos %}
+    {% include "partials/photos.njk" %}
+    {% endif %}
     {% if not post.named %}
     <div class="feed-excerpt e-content">{{ post.content | safe }}</div>
     {% else %}

package/themes/default/src/style.css

@@ -676,6 +676,15 @@
     @apply mt-1 flex flex-wrap gap-x-4 gap-y-1;
   }
 
+  /* A post's photos (TASK-166), one under another at the column's width. */
+  .post-photos {
+    @apply my-8 grid gap-4;
+  }
+
+  .post-photo img {
+    @apply block h-auto w-full;
+  }
+
   /* 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

@@ -1215,6 +1215,18 @@
     display: flex;
   }
 
+  .post-photos {
+    margin-block: calc(var(--spacing) * 8);
+    gap: calc(var(--spacing) * 4);
+    display: grid;
+  }
+
+  .post-photo img {
+    width: 100%;
+    height: auto;
+    display: block;
+  }
+
   .blog-post > .screen-reader-text ~ .e-content {
     --tw-leading: 1.55;
     font-size: 1.3rem;
@@ -2149,6 +2161,10 @@
     overflow: hidden;
   }
 
+  .capitalize {
+    text-transform: capitalize;
+  }
+
   .italic {
     font-style: italic;
   }