abqari 1.1.0

data/app/views/partials/_webmentions.html.erb

@@ -0,0 +1,131 @@
+<!--
+  Webmentions partial — renders received mentions for the current page.
+  Pulled from `site.webmentions_for(page.url)`, populated at build by
+  `Indieweb::Fetcher` from webmention.io's cached JF2 feed.
+
+  Renders nothing when:
+    - The IndieWeb integration is disabled (no cached data exists).
+    - No mentions exist for this page's URL.
+
+  Mention types ("wm-property" in JF2):
+    in-reply-to  → "Replies"  (full content + author)
+    mention-of   → "Mentions" (full content + author)
+    like-of      → "Likes"    (facepile — just author photos)
+    repost-of    → "Reposts"  (facepile)
+    bookmark-of  → "Bookmarks" (facepile)
+
+  Replies + mentions get the full visual treatment because they're
+  conversational; likes/reposts/bookmarks are facepiled because the
+  content (when present) is just "X liked Y" — the signal is the count
+  + avatars, not the body text.
+
+  TRUST NOTE — this is the least-trusted data the engine renders.
+  Anyone can send a webmention, and the author name, avatar, URLs and
+  body text all come from the SENDER. Indieweb::Fetcher#sanitise_mention
+  scrubs every URL to an absolute http(s) URL (or nil) BEFORE the data
+  reaches this template, and that is what makes the href/src sinks
+  below safe. Erubi's auto-escaping alone would NOT be: it stops a value
+  breaking out of the attribute, but leaves the URL scheme untouched, so
+  a javascript: URL escapes to itself and stays a working link.
+  If you add a new URL sink here it must come from that sanitised data —
+  do not reach around it.
+-->
+<%
+  all = site.webmentions_for(page.url)
+%>
+<% if all.any? %>
+<%
+  by_type = all.group_by { |m| m['wm-property'].to_s }
+  conversational = (by_type['in-reply-to'] || []) + (by_type['mention-of'] || [])
+  likes          = by_type['like-of']     || []
+  reposts        = by_type['repost-of']   || []
+  bookmarks      = by_type['bookmark-of'] || []
+  facepile       = likes + reposts + bookmarks
+%>
+<section class="webmentions" aria-label="Replies and mentions from around the web">
+  <h2 class="webmentions__heading">Replies &amp; mentions</h2>
+
+  <% if conversational.any? %>
+    <ol class="webmentions__list">
+      <% conversational.each do |m| %>
+        <%
+          author    = m['author'] || {}
+          name      = author['name'].to_s
+          author_url = author['url'].to_s
+          photo     = author['photo'].to_s
+          published = m['published'].to_s
+          src       = m['url'] || m['wm-source']
+          text      = (m.dig('content', 'text') || m.dig('content', 'html') || '').to_s
+          kind      = m['wm-property'] == 'in-reply-to' ? 'replied' : 'mentioned'
+        %>
+        <li class="webmention webmention--<%= kind %>">
+          <% if !photo.empty? %>
+            <img class="webmention__avatar" src="<%= photo %>"
+                 alt="" loading="lazy" width="48" height="48">
+          <% end %>
+          <div class="webmention__body">
+            <p class="webmention__byline">
+              <% if !author_url.empty? %>
+                <a class="webmention__author" rel="nofollow ugc" href="<%= author_url %>"><%= name.empty? ? author_url : name %></a>
+              <% else %>
+                <span class="webmention__author"><%= name.empty? ? '(anonymous)' : name %></span>
+              <% end %>
+              <%= kind %>
+              <% if !published.empty? %>
+                <%# `src` is nil when the sender's source URL failed
+                    sanitisation — render the timestamp unlinked rather
+                    than emitting an empty href. %>
+                <% if src %>
+                  <a class="webmention__permalink" rel="nofollow ugc" href="<%= src %>">
+                    <time datetime="<%= published %>"><%= local_time(Time.parse(published)) rescue published %></time>
+                  </a>
+                <% else %>
+                  <time class="webmention__permalink" datetime="<%= published %>"><%= local_time(Time.parse(published)) rescue published %></time>
+                <% end %>
+              <% end %>
+            </p>
+            <% if !text.empty? %>
+              <p class="webmention__text"><%= truncate(text, length: 320) %></p>
+            <% end %>
+          </div>
+        </li>
+      <% end %>
+    </ol>
+  <% end %>
+
+  <% if facepile.any? %>
+    <div class="webmentions__facepile">
+      <% if likes.any? %>
+        <p class="webmentions__facepile-label"><%= pluralize(likes.size, 'like') %></p>
+        <ul class="webmentions__facepile-list">
+          <% likes.each do |m| %><% photo = (m['author'] || {})['photo'].to_s; name = (m['author'] || {})['name'].to_s; src = m['url'] || m['wm-source'] %>
+            <% if !photo.empty? %>
+              <li><% if src %><a rel="nofollow ugc" href="<%= src %>"><img src="<%= photo %>" alt="<%= name %>" loading="lazy" width="32" height="32"></a><% else %><img src="<%= photo %>" alt="<%= name %>" loading="lazy" width="32" height="32"><% end %></li>
+            <% end %>
+          <% end %>
+        </ul>
+      <% end %>
+      <% if reposts.any? %>
+        <p class="webmentions__facepile-label"><%= pluralize(reposts.size, 'repost') %></p>
+        <ul class="webmentions__facepile-list">
+          <% reposts.each do |m| %><% photo = (m['author'] || {})['photo'].to_s; name = (m['author'] || {})['name'].to_s; src = m['url'] || m['wm-source'] %>
+            <% if !photo.empty? %>
+              <li><% if src %><a rel="nofollow ugc" href="<%= src %>"><img src="<%= photo %>" alt="<%= name %>" loading="lazy" width="32" height="32"></a><% else %><img src="<%= photo %>" alt="<%= name %>" loading="lazy" width="32" height="32"><% end %></li>
+            <% end %>
+          <% end %>
+        </ul>
+      <% end %>
+      <% if bookmarks.any? %>
+        <p class="webmentions__facepile-label"><%= pluralize(bookmarks.size, 'bookmark') %></p>
+        <ul class="webmentions__facepile-list">
+          <% bookmarks.each do |m| %><% photo = (m['author'] || {})['photo'].to_s; name = (m['author'] || {})['name'].to_s; src = m['url'] || m['wm-source'] %>
+            <% if !photo.empty? %>
+              <li><% if src %><a rel="nofollow ugc" href="<%= src %>"><img src="<%= photo %>" alt="<%= name %>" loading="lazy" width="32" height="32"></a><% else %><img src="<%= photo %>" alt="<%= name %>" loading="lazy" width="32" height="32"><% end %></li>
+            <% end %>
+          <% end %>
+        </ul>
+      <% end %>
+    </div>
+  <% end %>
+</section>
+<% end %>

data/app/views/partials/_website_jsonld.html.erb

@@ -0,0 +1,39 @@
+<!--
+  Schema.org WebSite JSON-LD — the canonical entity declaration for
+  the site as a whole. Rendered on the home page only. Establishes:
+
+    - the site's identity (name, URL, description, language)
+    - the publisher (Person or Organization, derived from config)
+    - sameAs links to social profiles (the same `social:` config the
+      footer uses), giving Google an entity graph to connect to
+
+  This is the table-stakes E-E-A-T signal — search engines use it to
+  identify "who is this site about" before they rank individual pages.
+
+  Renders nothing when `site.config['url']` is unset.
+-->
+<% site_url = site.config['url'].to_s.sub(%r{/\z}, '') %>
+<% if !site_url.empty? %>
+<%
+  social_urls = site.social_links.map { |entry| entry['url'] }.compact
+                                  .reject { |u| u.start_with?('mailto:') || u.start_with?('/') }
+
+  publisher = {
+    "@type" => "Person",
+    "name"  => site.config['author'] || site.config['title'],
+    "url"   => "#{site_url}/"
+  }
+  publisher["sameAs"] = social_urls if social_urls.any?
+
+  jsonld = {
+    "@context"   => "https://schema.org",
+    "@type"      => "WebSite",
+    "name"       => site.config['title'],
+    "url"        => "#{site_url}/",
+    "inLanguage" => site.config['locale'] || 'en',
+    "publisher"  => publisher
+  }
+  jsonld["description"] = site.config['description'] if site.config['description']
+%>
+<script type="application/ld+json"><%== script_safe_json(jsonld) %></script>
+<% end %>

data/app/views/partials/home/_contact.html.erb

@@ -0,0 +1,19 @@
+<!--
+  Home module — contact. Wraps the spam-resistant contact button in a
+  home-module section so it sits alongside the other home modules
+  visually. Renders nothing when `contact:` isn't configured in
+  config/site.yml (the inner partial guards on that).
+
+  Toggled by `home.contact: true` in config/site.yml.
+  Style via `.home-module*` class hooks in your theme.
+-->
+<%
+  contact_cfg = site.config['contact'] || {}
+  has_email = contact_cfg['email'].to_s.include?('@')
+%>
+<% if has_email %>
+<section class="home-module home-module--contact" aria-label="Get in touch">
+  <h2 class="home-module__heading">Get in touch</h2>
+  <%== render 'partials/contact_button' %>
+</section>
+<% end %>

data/app/views/partials/home/_featured_publication.html.erb

@@ -0,0 +1,107 @@
+<!--
+  Home module — featured publication. Surfaces the publication flagged
+  with `showcase: true` in frontmatter (the same one that anchors the
+  showcase block at the top of `/publications/`), rendered in the
+  smaller home-module card shape (mirrors the latest-publication
+  module). Renders nothing when no publication is flagged.
+
+  Note: this module respects the `showcase: true` flag regardless of
+  `collections.publications.index.display_showcase`. The two settings
+  are independent — `display_showcase` controls the showcase block on
+  the publications index; `home.featured_publication` controls whether
+  the same flagged book appears here on the home page. A site can run
+  one without the other.
+
+  Config (`home.featured_publication` in config/site.yml). Accepts
+  two shapes — pick whichever suits:
+
+      # Simple — module on with all defaults
+      featured_publication: true
+
+      # Granular — opt-in field controls
+      featured_publication:
+        enabled: true             # set false to disable; absent = true
+        show_excerpt: true        # default true; the long marketing prose
+        show_price: false         # default false; canonical price.formatted
+        show_published_at: false  # default false; release / first-published date
+
+  Cover image, title, and tagline are always rendered when present
+  in the publication's frontmatter — those are the card's identity.
+  The three configurable fields below the tagline are optional
+  surface decisions; defaults preserve the historical "card with a
+  description, no price, no date" look.
+
+  Reads canonical publication frontmatter per docs/publications.md:
+  `cover_url`, `tagline`, `excerpt`, `price.formatted`, `published_at`.
+  Stale pre-0.3.0 keys (`cover`, `cover_image`, `description`) are
+  not honoured — manual publications must use the canonical names.
+-->
+<%
+  pub = site.collection('publications').find { |p| p.frontmatter['showcase'] == true }
+  # `priority_image: true` (set by the home layout for the first
+  # enabled module) flips this image to eager + high fetch priority
+  # so the LCP candidate isn't artificially delayed by lazy-loading.
+  _priority = defined?(priority_image) && priority_image
+
+  # Field-visibility resolution: per-module hash > defaults. Defaults
+  # match the historical render shape (excerpt on; price and
+  # published_at off).
+  mod_cfg           = site.config.dig('home', 'featured_publication')
+  mod_cfg           = {} unless mod_cfg.is_a?(Hash)
+  show_excerpt      = mod_cfg.fetch('show_excerpt',      true)
+  show_price        = mod_cfg.fetch('show_price',        false)
+  show_published_at = mod_cfg.fetch('show_published_at', false)
+%>
+<% if pub %>
+<section class="home-module home-module--featured-publication" aria-label="Featured publication">
+  <header class="home-module__header">
+    <h2 class="home-module__heading">Featured publication</h2>
+    <a class="home-module__see-all" href="<%= sanitized_url(collection_index_url('publications')) %>">All <%= collection_index_label('publications') %> &rarr;</a>
+  </header>
+  <article class="home-module__item">
+    <% if (cover = pub.frontmatter['cover_url']) %>
+      <a class="home-module__cover" href="<%= sanitized_url(pub.url) %>">
+        <img src="<%= sanitized_url(cover) %>"
+             alt="<%= pub.title %> cover"
+             loading="<%= _priority ? 'eager' : 'lazy' %>"
+             <% if _priority %>fetchpriority="high"<% end %>
+             decoding="async">
+      </a>
+    <% end %>
+    <div class="home-module__body">
+      <h3 class="home-module__title">
+        <a href="<%= sanitized_url(pub.url) %>"><%= pub.title %></a>
+      </h3>
+      <% if (tagline = pub.frontmatter['tagline']) %>
+        <p class="home-module__tagline"><%= tagline %></p>
+      <% end %>
+      <% if show_excerpt && (desc = pub.frontmatter['excerpt'].to_s) && !desc.empty? %>
+        <p class="home-module__description"><%= truncate(desc, length: 200) %></p>
+      <% end %>
+      <%# Optional meta line — published_at and price, both off by
+          default. When both are configured on AND present in the
+          frontmatter, they sit on one bullet-separated line; if
+          only one resolves, the bullet disappears so the line reads
+          cleanly with whichever field made it through. %>
+      <%
+        meta_parts = []
+        meta_parts << :published if show_published_at && pub.frontmatter['published_at']
+        meta_parts << :price     if show_price        && pub.frontmatter.dig('price', 'formatted')
+      %>
+      <% if meta_parts.any? %>
+        <p class="home-module__meta">
+          <% meta_parts.each_with_index do |kind, i| %>
+            <% if i.positive? %> &middot; <% end %>
+            <% case kind %>
+            <% when :published %>
+              <time datetime="<%= pub.frontmatter['published_at'] %>"><%= local_time(pub.frontmatter['published_at']) %></time>
+            <% when :price %>
+              <%= pub.frontmatter.dig('price', 'formatted') %>
+            <% end %>
+          <% end %>
+        </p>
+      <% end %>
+    </div>
+  </article>
+</section>
+<% end %>

data/app/views/partials/home/_latest_photo.html.erb

@@ -0,0 +1,95 @@
+<!--
+  Home module — latest photo. Pulls the newest photo from the photos
+  collection. Renders nothing when the collection is empty or
+  disabled.
+
+  Config (`home.latest_photo` in config/site.yml). Accepts two shapes:
+
+      # Simple — module on with all defaults
+      latest_photo: true
+
+      # Granular — opt-in field controls
+      latest_photo:
+        enabled: true              # `enabled: false` disables; absent = true
+        show_caption: true         # default true   — the descriptive prose
+        show_date:    true         # default true   — capture date
+        show_city:    true         # default true   — city (combined with country)
+        show_country: true         # default true   — country
+        show_camera:  false        # default false  — camera body
+        show_type:    false        # default false  — digital / film / etc.
+        show_series:  false        # default false  — series this photo belongs to
+        show_tags:    false        # default false  — tag pills
+
+  Hero image and photo title are always rendered when present — those
+  are the card's identity. City and country combine into a single
+  "City, Country" entry when both are enabled (or just one of them
+  when only one is on).
+
+  Style via `.home-module*` class hooks in your theme.
+-->
+<%
+  photo = site.collection('photos').first
+  _priority = defined?(priority_image) && priority_image
+
+  mod_cfg      = site.config.dig('home', 'latest_photo')
+  mod_cfg      = {} unless mod_cfg.is_a?(Hash)
+  show_caption = mod_cfg.fetch('show_caption', true)
+  show_date    = mod_cfg.fetch('show_date',    true)
+  show_city    = mod_cfg.fetch('show_city',    true)
+  show_country = mod_cfg.fetch('show_country', true)
+  show_camera  = mod_cfg.fetch('show_camera',  false)
+  show_type    = mod_cfg.fetch('show_type',    false)
+  show_series  = mod_cfg.fetch('show_series',  false)
+  show_tags    = mod_cfg.fetch('show_tags',    false)
+%>
+<% if photo %>
+<%
+  fm    = photo.frontmatter
+  parts = []
+  if show_date && photo.date
+    parts << %(<time datetime="#{photo.date.iso8601}">#{local_time(photo.date)}</time>)
+  end
+  city    = show_city    ? fm['city']    : nil
+  country = show_country ? fm['country'] : nil
+  location = [city, country].compact.reject { |s| s.to_s.strip.empty? }.join(', ')
+  parts << h(location)        unless location.empty?
+  parts << h(fm['camera'])    if show_camera && fm['camera']
+  parts << h(fm['type'])      if show_type   && fm['type']
+  parts << h(fm['series'])    if show_series && fm['series']
+%>
+<section class="home-module home-module--latest-photo" aria-label="Latest photo">
+  <header class="home-module__header">
+    <h2 class="home-module__heading">Latest photo</h2>
+    <a class="home-module__see-all" href="<%= sanitized_url(collection_index_url('photos')) %>">All <%= collection_index_label('photos') %> &rarr;</a>
+  </header>
+  <article class="home-module__item">
+    <% if (img = fm['image']) %>
+      <a class="home-module__cover" href="<%= sanitized_url(photo.url) %>">
+        <img src="<%= sanitized_url(img) %>"
+             alt="<%= fm['caption'] || photo.title %>"
+             loading="<%= _priority ? 'eager' : 'lazy' %>"
+             <% if _priority %>fetchpriority="high"<% end %>
+             decoding="async">
+      </a>
+    <% end %>
+    <div class="home-module__body">
+      <h3 class="home-module__title">
+        <a href="<%= sanitized_url(photo.url) %>"><%= photo.title %></a>
+      </h3>
+      <% if parts.any? %>
+        <p class="home-module__meta"><%== parts.join(' &middot; ') %></p>
+      <% end %>
+      <% if show_caption && (caption = fm['caption']) %>
+        <p class="home-module__description"><%= truncate(caption.to_s, length: 200) %></p>
+      <% end %>
+      <% if show_tags && Array(fm['tags']).any? %>
+        <p class="home-module__tags">
+          <% Array(fm['tags']).each do |tag| %>
+            <a class="home-module__tag" href="/tags/<%= slugify(tag) %>/"><%= tag %></a>
+          <% end %>
+        </p>
+      <% end %>
+    </div>
+  </article>
+</section>
+<% end %>

data/app/views/partials/home/_latest_post.html.erb

@@ -0,0 +1,48 @@
+<!--
+  Home module — latest post. Pulls the newest published post from the
+  posts collection and renders a one-card preview (title, date,
+  reading time, truncated description). Renders nothing when the
+  collection is empty or all posts are drafts/future-dated.
+
+  Toggled by `home.latest_post: true` in config/site.yml.
+  Style via `.home-module*` class hooks in your theme.
+-->
+<%
+  post = site.collection('posts').first
+  _priority = defined?(priority_image) && priority_image
+%>
+<% if post %>
+<section class="home-module home-module--latest-post" aria-label="Latest post">
+  <header class="home-module__header">
+    <h2 class="home-module__heading">Latest post</h2>
+    <a class="home-module__see-all" href="<%= sanitized_url(collection_index_url('posts')) %>">All <%= collection_index_label('posts') %> &rarr;</a>
+  </header>
+  <article class="home-module__item">
+    <% if (img = post.frontmatter['image']) %>
+      <a class="home-module__cover" href="<%= sanitized_url(post.url) %>">
+        <img src="<%= sanitized_url(bundle_asset_url_for(post, img)) %>"
+             alt="<%= post.title %>"
+             loading="<%= _priority ? 'eager' : 'lazy' %>"
+             <% if _priority %>fetchpriority="high"<% end %>
+             decoding="async">
+      </a>
+    <% end %>
+    <div class="home-module__body">
+      <h3 class="home-module__title">
+        <a href="<%= sanitized_url(post.url) %>"><%= post.title %></a>
+      </h3>
+      <% if post.date %>
+        <p class="home-module__meta">
+          <time datetime="<%= post.date.iso8601 %>"><%= local_time(post.date) %></time>
+          <% if post.respond_to?(:content) && post.content.to_s.length.positive? %>
+            · <%= reading_time(post.content) %>
+          <% end %>
+        </p>
+      <% end %>
+      <% if (desc = post.frontmatter['description'].to_s) && !desc.empty? %>
+        <p class="home-module__description"><%= truncate(desc, length: 160) %></p>
+      <% end %>
+    </div>
+  </article>
+</section>
+<% end %>

data/app/views/partials/home/_latest_publication.html.erb

@@ -0,0 +1,89 @@
+<!--
+  Home module — latest publication. Pulls the most recent entry from
+  the publications collection (both manual `content/publications/`
+  pages and externally-sourced publisher entries — `site.collection`
+  returns the merged list).
+
+  Config (`home.latest_publication` in config/site.yml). Accepts
+  two shapes — pick whichever suits:
+
+      # Simple — module on with all defaults
+      latest_publication: true
+
+      # Granular — opt-in field controls
+      latest_publication:
+        enabled: true             # set false to disable; absent = true
+        show_excerpt: true        # default true; the long marketing prose
+        show_price: false         # default false; canonical price.formatted
+        show_published_at: false  # default false; release / first-published date
+
+  Cover image, title, and tagline are always rendered when present
+  in the publication's frontmatter — those are the card's identity.
+
+  Reads canonical publication frontmatter per docs/publications.md:
+  `cover_url`, `tagline`, `excerpt`, `price.formatted`, `published_at`.
+  Stale pre-0.3.0 keys (`cover`, `cover_image`, `description`) are
+  not honoured.
+-->
+<%
+  pub = site.collection('publications').first
+  _priority = defined?(priority_image) && priority_image
+
+  # Field-visibility resolution: per-module hash > defaults. Defaults
+  # match the historical render shape (excerpt on; price and
+  # published_at off).
+  mod_cfg           = site.config.dig('home', 'latest_publication')
+  mod_cfg           = {} unless mod_cfg.is_a?(Hash)
+  show_excerpt      = mod_cfg.fetch('show_excerpt',      true)
+  show_price        = mod_cfg.fetch('show_price',        false)
+  show_published_at = mod_cfg.fetch('show_published_at', false)
+%>
+<% if pub %>
+<section class="home-module home-module--latest-publication" aria-label="Latest publication">
+  <header class="home-module__header">
+    <h2 class="home-module__heading">Latest publication</h2>
+    <a class="home-module__see-all" href="<%= sanitized_url(collection_index_url('publications')) %>">All <%= collection_index_label('publications') %> &rarr;</a>
+  </header>
+  <article class="home-module__item">
+    <% if (cover = pub.frontmatter['cover_url']) %>
+      <a class="home-module__cover" href="<%= sanitized_url(pub.url) %>">
+        <img src="<%= sanitized_url(cover) %>"
+             alt="<%= pub.title %> cover"
+             loading="<%= _priority ? 'eager' : 'lazy' %>"
+             <% if _priority %>fetchpriority="high"<% end %>
+             decoding="async">
+      </a>
+    <% end %>
+    <div class="home-module__body">
+      <h3 class="home-module__title">
+        <a href="<%= sanitized_url(pub.url) %>"><%= pub.title %></a>
+      </h3>
+      <% if (tagline = pub.frontmatter['tagline']) %>
+        <p class="home-module__tagline"><%= tagline %></p>
+      <% end %>
+      <% if show_excerpt && (desc = pub.frontmatter['excerpt'].to_s) && !desc.empty? %>
+        <p class="home-module__description"><%= truncate(desc, length: 200) %></p>
+      <% end %>
+      <%# Optional meta line — same shape as `_featured_publication`. %>
+      <%
+        meta_parts = []
+        meta_parts << :published if show_published_at && pub.frontmatter['published_at']
+        meta_parts << :price     if show_price        && pub.frontmatter.dig('price', 'formatted')
+      %>
+      <% if meta_parts.any? %>
+        <p class="home-module__meta">
+          <% meta_parts.each_with_index do |kind, i| %>
+            <% if i.positive? %> &middot; <% end %>
+            <% case kind %>
+            <% when :published %>
+              <time datetime="<%= pub.frontmatter['published_at'] %>"><%= local_time(pub.frontmatter['published_at']) %></time>
+            <% when :price %>
+              <%= pub.frontmatter.dig('price', 'formatted') %>
+            <% end %>
+          <% end %>
+        </p>
+      <% end %>
+    </div>
+  </article>
+</section>
+<% end %>

data/app/views/partials/home/_next_workshop.html.erb

@@ -0,0 +1,119 @@
+<!--
+  Home module — next workshop. Pulls the soonest upcoming entry from
+  the workshops collection. A workshop is "upcoming" when its end-date
+  (`date_to` ‖ `date_from`) is today or later, OR when it has no dates
+  at all (evergreen offerings). Renders nothing when no workshop fits
+  or the collection is empty/disabled.
+
+  Card shape mirrors the other home modules: optional hero on the left
+  (when the workshop has `image:` frontmatter), title + meta + short
+  description on the right. The meta line condenses the dl block used
+  on the workshops index into a one-row summary.
+
+  Config (`home.next_workshop` in config/site.yml). Accepts two shapes:
+
+      # Simple — module on with all defaults
+      next_workshop: true
+
+      # Granular — opt-in field controls
+      next_workshop:
+        enabled: true              # `enabled: false` disables; absent = true
+        show_dates:       true     # default true   — date_from – date_to
+        show_description: true     # default true   — short summary
+        show_location:    true     # default true   — city / country
+        show_format:      false    # default false  — In-person / Remote / Hybrid
+        show_price:       false    # default false  — canonical `price.formatted`
+        show_tags:        false    # default false  — tag pills
+
+  Cover image and workshop title are always rendered when present —
+  those are the card's identity. The fields above are optional
+  surface decisions.
+
+  Style via `.home-module*` class hooks in your theme.
+-->
+<%
+  today = Date.today
+  upcoming = site.collection('workshops').select do |w|
+    end_date = w.frontmatter['date_to'] || w.frontmatter['date_from']
+    end_date.nil? || to_time(end_date).to_date >= today
+  end
+  upcoming.sort_by! do |w|
+    fm = w.frontmatter
+    start_key = fm['date_from'] ? to_time(fm['date_from']).to_i : Float::INFINITY
+    [fm['order'] || Float::INFINITY, start_key, w.title.to_s]
+  end
+  workshop = upcoming.first
+  _priority = defined?(priority_image) && priority_image
+
+  mod_cfg          = site.config.dig('home', 'next_workshop')
+  mod_cfg          = {} unless mod_cfg.is_a?(Hash)
+  show_dates       = mod_cfg.fetch('show_dates',       true)
+  show_description = mod_cfg.fetch('show_description', true)
+  show_location    = mod_cfg.fetch('show_location',    true)
+  show_format      = mod_cfg.fetch('show_format',      false)
+  show_price       = mod_cfg.fetch('show_price',       false)
+  show_tags        = mod_cfg.fetch('show_tags',        false)
+%>
+<% if workshop %>
+<%
+  fm    = workshop.frontmatter
+  df    = fm['date_from']
+  dt    = fm['date_to']
+  parts = []
+  if show_dates && df
+    date_html = %(<time datetime="#{to_time(df).iso8601}">#{local_time(df)}</time>)
+    if dt && dt != df
+      date_html += %( &ndash; <time datetime="#{to_time(dt).iso8601}">#{local_time(dt)}</time>)
+    end
+    parts << date_html
+  elsif show_dates && fm['duration']
+    parts << h(fm['duration'])
+  end
+  parts << h(fm['location']) if show_location && fm['location']
+  parts << h(fm['format'])   if show_format   && fm['format']
+  if show_price && (price = fm['price'])
+    # Workshop frontmatter `price:` is free-form (typically a display
+    # string like "$1,495", per docs/publications.md — the canonical
+    # `{cents, currency, formatted}` shape is publications-only).
+    # Accept either shape so a site can move to the canonical hash
+    # later without re-authoring every workshop.
+    price_str = price.is_a?(Hash) ? price['formatted'].to_s : price.to_s
+    parts << h(price_str) unless price_str.empty?
+  end
+%>
+<section class="home-module home-module--next-workshop" aria-label="Next workshop">
+  <header class="home-module__header">
+    <h2 class="home-module__heading">Next workshop</h2>
+    <a class="home-module__see-all" href="<%= sanitized_url(collection_index_url('workshops')) %>">All <%= collection_index_label('workshops') %> &rarr;</a>
+  </header>
+  <article class="home-module__item">
+    <% if (img = fm['image']) %>
+      <a class="home-module__cover" href="<%= sanitized_url(workshop.url) %>">
+        <img src="<%= sanitized_url(bundle_asset_url_for(workshop, img)) %>"
+             alt="<%= workshop.title %>"
+             loading="<%= _priority ? 'eager' : 'lazy' %>"
+             <% if _priority %>fetchpriority="high"<% end %>
+             decoding="async">
+      </a>
+    <% end %>
+    <div class="home-module__body">
+      <h3 class="home-module__title">
+        <a href="<%= sanitized_url(workshop.url) %>"><%= workshop.title %></a>
+      </h3>
+      <% if parts.any? %>
+        <p class="home-module__meta"><%== parts.join(' &middot; ') %></p>
+      <% end %>
+      <% if show_description && (desc = fm['description'].to_s) && !desc.empty? %>
+        <p class="home-module__description"><%= truncate(desc, length: 200) %></p>
+      <% end %>
+      <% if show_tags && Array(fm['tags']).any? %>
+        <p class="home-module__tags">
+          <% Array(fm['tags']).each do |tag| %>
+            <a class="home-module__tag" href="/tags/<%= slugify(tag) %>/"><%= tag %></a>
+          <% end %>
+        </p>
+      <% end %>
+    </div>
+  </article>
+</section>
+<% end %>