abqari 1.1.0

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

@@ -0,0 +1,85 @@
+<%#
+  Newsletter subscription form. Provider-agnostic — works with any
+  service that accepts an HTML form POST (Cogent Notes, Mailchimp,
+  Buttondown, ConvertKit / Kit, TinyLetter, Substack, etc.).
+
+  Configure once in config/site.yml under `newsletter:`. The form
+  renders ONLY when `newsletter.action` is set; without it the
+  partial emits nothing, so it's safe to drop into any layout.
+
+  Schema:
+      newsletter:
+        action: https://your-provider.example/s/FORM_ID      # required — POST target
+        email_field: email                                   # default 'email'
+                                                             #   Mailchimp: EMAIL
+                                                             #   ConvertKit: email_address
+        title: Subscribe to the newsletter                   # default
+        description: Short standfirst (optional)
+        button: Subscribe                                    # default
+        hidden_fields:                                       # optional — extra inputs
+          - { name: tags,   value: blog }                    #   e.g. Buttondown tags
+          - { name: b_abc1, value: '' }                      #   e.g. Mailchimp honeypot
+        script: https://your-provider.example/js/subscribe.js # optional, loaded `defer`
+        attribution:                                         # optional — omit for none
+          text: Your Provider
+          url: https://your-provider.example
+          prefix: Powered by                                 # default
+
+  Per-call overrides (any layout or markdown body with erb: true):
+      <%%= render 'partials/newsletter_subscribe' %>
+      <%%= render 'partials/newsletter_subscribe',
+                title: 'Get notified when new books drop',
+                description: 'One short email a month.',
+                button: 'Notify me' %>
+
+  Common placements: bottom of posts_index, end of about page,
+  end of a publications index, sidebar slot, dedicated
+  /subscribe/ page.
+
+  Note on indentation: this partial can be rendered from a markdown
+  body (erb: true), where commonmarker treats indented lines as code
+  blocks. We keep all output HTML at column 0 and use `-%>` on
+  control tags to suppress whitespace-only output.
+%>
+<%
+  cfg = site.config['newsletter']
+-%>
+<% if cfg.is_a?(Hash) && (action_url = cfg['action']) -%>
+<%
+  form_title       = defined?(title)       && title       ? title       : (cfg['title']       || 'Subscribe to the newsletter')
+  form_description = defined?(description) && description ? description : cfg['description']
+  form_button      = defined?(button)      && button      ? button      : (cfg['button']      || 'Subscribe')
+  email_field      = cfg['email_field'] || 'email'
+  hidden_fields    = Array(cfg['hidden_fields'])
+  attribution      = cfg['attribution']
+  script_url       = cfg['script']
+-%>
+<aside class="newsletter-subscribe">
+<h2 class="newsletter-subscribe__title"><%= form_title %></h2>
+<% if form_description && !form_description.to_s.empty? -%>
+<p class="newsletter-subscribe__description"><%= form_description %></p>
+<% end -%>
+<form action="<%= action_url %>" method="post" class="newsletter-subscribe__form">
+<label for="newsletter-email" class="visually-hidden">Your email</label>
+<input type="email" id="newsletter-email" name="<%= email_field %>" placeholder="you@example.com" required class="newsletter-subscribe__input">
+<% hidden_fields.each do |field| -%>
+<input type="hidden" name="<%= field['name'] %>" value="<%= field['value'] %>">
+<% end -%>
+<button type="submit" class="btn btn-primary newsletter-subscribe__button"><%= form_button %></button>
+</form>
+<% if attribution.is_a?(Hash) && attribution['text'] -%>
+<% prefix = attribution['prefix'] || 'Powered by' -%>
+<p class="newsletter-subscribe__attribution">
+<%= prefix %>
+<% if attribution['url'] -%>
+<a href="<%= sanitized_url(attribution['url']) %>" target="_blank" rel="noopener noreferrer"><%= attribution['text'] %></a>
+<% else -%>
+<%= attribution['text'] %>
+<% end -%>
+</p>
+<% end -%>
+<% if script_url && (safe_script = sanitized_url(script_url)) -%>
+<script src="<%= safe_script %>" defer></script>
+<% end -%>
+</aside>
+<% end -%>

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

@@ -0,0 +1,27 @@
+<!--
+  "Next in the series" card — renders below a show view when the
+  current page is part of a series AND a later-positioned item exists
+  in the same series. Functionally the series-ordered counterpart of
+  `_next_item.html.erb` (which uses chronological order).
+
+  Reuses the `_post_list` index card for the same reason as
+  `_next_item`: there's only one next-in-series post, so the
+  prominent index-row treatment (cover-left, title / date /
+  description right) fits. Heading style matches `.related__heading`
+  so the section still sits coherently alongside its siblings.
+
+  Required: the page must have BOTH `series:` and `series_position:`
+  in frontmatter and there must be a next page in the series.
+  `site.next_in_series` returns nil in every other case, and this
+  partial renders nothing.
+
+  Used by:  post.html.erb (in place of `_next_item` when the post is
+             in a series with a later position to advance to)
+-->
+<% next_post = site.next_in_series(page) %>
+<% if next_post %>
+<section class="next-item next-item--series" aria-labelledby="next-in-series-heading">
+  <h2 id="next-in-series-heading" class="next-item__heading">Next in the series</h2>
+  <%== render 'partials/post_list', posts: [next_post] %>
+</section>
+<% end %>

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

@@ -0,0 +1,38 @@
+<!--
+  Renders a single "Up next" card below a show view, linking to the
+  chronologically-newer post in the same collection. "Next" means
+  strictly newer — at the newest post the section is suppressed
+  rather than falling back to an older neighbour (which would
+  contradict the label).
+
+  Reuses the `_post_list` index card so the single "Up next" entry
+  reads like a regular index row — cover-left, title / date /
+  description on the right at desktop, stacked on mobile. There's
+  only ever one up-next post, so the full index treatment fits;
+  the related grid below uses a different (compact, multi-card)
+  shape for its many-card case.
+
+  Heading style matches `.related__heading` (small uppercase muted)
+  so the show-view tail still reads as a coherent run of sections —
+  it's the card body that differs.
+
+  Usage:
+      <%%= render 'partials/next_item' %>
+
+  Config (per collection in config/site.yml):
+
+      collections:
+        posts:
+          next:
+            enabled: true       # set false to suppress the section
+
+  Renders nothing when the source is the newest in its collection,
+  there's no next page, or `next.enabled` is false.
+-->
+<% next_post = site.next_in_collection(page) %>
+<% if next_post %>
+<section class="next-item" aria-labelledby="next-item-heading">
+  <h2 id="next-item-heading" class="next-item__heading">Up next</h2>
+  <%== render 'partials/post_list', posts: [next_post] %>
+</section>
+<% end %>

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

@@ -0,0 +1,15 @@
+<% if paginator && paginator.total_pages > 1 %>
+<nav class="pagination" aria-label="Pagination">
+  <% if paginator.prev_url %>
+    <a href="<%= paginator.prev_url %>">← Newer</a>
+  <% else %>
+    <span></span>
+  <% end %>
+  <span>Page <%= paginator.page %> of <%= paginator.total_pages %></span>
+  <% if paginator.next_url %>
+    <a href="<%= paginator.next_url %>">Older →</a>
+  <% else %>
+    <span></span>
+  <% end %>
+</nav>
+<% end %>

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

@@ -0,0 +1,46 @@
+<!--
+  Schema.org Person JSON-LD for an About page. Establishes the
+  site's primary author as an entity in Google's knowledge graph,
+  with `sameAs` linking to every claimed social profile.
+
+  This is THE E-E-A-T signal — Google uses the entity graph to
+  decide "is this author trustworthy / authoritative on this topic?"
+  when ranking individual pages. Wiring an About page with proper
+  Person markup is one of the highest-leverage SEO additions a
+  personal site can make.
+
+  Optional About-page frontmatter (overrides config defaults):
+      person_name:      Ada Lovelace       # defaults to site.author
+      person_job_title: Author              # optional
+      person_description: One-line bio      # defaults to page.description
+      person_image:     /portrait.jpg       # optional headshot
+
+  Wire it into the About layout:
+      <%%= render 'partials/person_jsonld' %>
+-->
+<%
+  site_url = site.config['url'].to_s.sub(%r{/\z}, '')
+  fm       = page.frontmatter || {}
+  name     = fm['person_name'] || site.config['author']
+%>
+<% if !site_url.empty? && name %>
+<%
+  social_urls = site.social_links.map { |entry| entry['url'] }.compact
+                                  .reject { |u| u.start_with?('mailto:') || u.start_with?('/') }
+
+  jsonld = {
+    "@context" => "https://schema.org",
+    "@type"    => "Person",
+    "name"     => name,
+    "url"      => "#{site_url}#{page.url}"
+  }
+  jsonld["jobTitle"]    = fm['person_job_title']                   if fm['person_job_title']
+  jsonld["description"] = fm['person_description'] || page.description
+  jsonld["sameAs"]      = social_urls                              if social_urls.any?
+
+  if (img = fm['person_image'])
+    jsonld["image"] = img.start_with?('http') ? img : "#{site_url}#{img}"
+  end
+%>
+<script type="application/ld+json"><%== script_safe_json(jsonld.compact) %></script>
+<% end %>

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

@@ -0,0 +1,24 @@
+<!--
+  Plausible analytics. Renders only when `plausible.enabled: true` AND
+  `plausible.key` are both set in config/site.yml:
+
+      plausible:
+        enabled: true
+        key: pa-abc123        # the slug in https://plausible.io/js/<key>.js
+
+  The CSP is auto-extended in lib/abqari/headers_file.rb when this
+  block is enabled, so the strict 'self'-only policy stays intact
+  otherwise.
+
+  The inline boot script lives at lib/abqari/plausible_script.rb so
+  its SHA256 hash is computed at the same place CSP picks it up.
+-->
+<%
+  cfg = site.config['plausible'] || {}
+  show = cfg['enabled'] == true && !cfg['key'].to_s.empty?
+%>
+<% if show %>
+<!-- Privacy-friendly analytics by Plausible -->
+<script async src="https://plausible.io/js/<%= cfg['key'] %>.js"></script>
+<script><%== Abqari::PlausibleScript::SCRIPT %></script>
+<% end %>

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

@@ -0,0 +1,101 @@
+<!--
+  Post list — the cards on /<posts-slug>/ and tag-index pages. Each
+  card is title, optional hero image, date, truncated description,
+  reading time, and tags, all toggled via `collections.posts.index.*`
+  in config/site.yml:
+
+    collections:
+      posts:
+        index:
+          cover: photo                   # photo | photo_or_svg | svg | none
+                                         #   photo        — image: if set, basic
+                                         #                  flat-tint placeholder otherwise
+                                         #   photo_or_svg — image: if set, decorative
+                                         #                  initial-tile SVG otherwise
+                                         #   svg          — always decorative SVG
+                                         #                  (image: ignored)
+                                         #   none         — no cover slot at all
+          show_date: true
+          show_description: true
+          description_truncate: 160      # characters
+          show_reading_time: true
+          show_tags: false
+
+  Per-post override: set `cover: false` (or one of the enum values)
+  in frontmatter to override the collection default for that one post.
+
+  The semantic class names (`.post-list__cover`, `.post-list__title`,
+  `.post-list__body`, etc.) are theme-neutral hooks. Themes style them
+  to match their visual language — the `bootstrap` theme renders cards
+  with a cover-on-left layout, `minimal` renders a flat list. Edit
+  themes/<name>/css/app.css to change appearance; edit this partial
+  to change structure or add fields.
+-->
+<%
+  cfg = (site.collection_config('posts')['index'] || {})
+  show_date         = cfg.fetch('show_date',         true)
+  show_description  = cfg.fetch('show_description',  true)
+  show_reading_time = cfg.fetch('show_reading_time', true)
+  show_tags         = cfg.fetch('show_tags',         false)
+  truncate_at       = cfg.fetch('description_truncate', 160)
+%>
+<ul class="post-list h-feed">
+  <% posts.each do |post| %>
+    <%# `h-entry` on each card lets feed readers and IndieWeb parsers
+        treat the index as a microformats2 feed; `h-feed` on the <ul>
+        marks the surrounding container. Class names are invisible. %>
+    <li class="post-list__item h-entry">
+      <%# Cover slot. `cover_choice_for` returns one of :photo /
+          :placeholder / :svg / :none — see CoverHelpers for the
+          mode resolution (frontmatter > collection config > default).
+          When `:none`, the slot doesn't render at all and the body
+          fills the card via the `:not(:has(.post-list__cover))`
+          CSS rule. %>
+      <% case cover_choice_for(post, context: :index) %>
+      <% when :photo %>
+        <a class="post-list__cover" href="<%= post.url %>" aria-label="<%= post.title %>">
+          <img src="<%= sanitized_url(bundle_asset_url_for(post, post.frontmatter['image'])) %>" alt="<%= post.title %>" loading="lazy">
+        </a>
+      <% when :placeholder %>
+        <a class="post-list__cover" href="<%= post.url %>" aria-label="<%= post.title %>">
+          <svg class="post-list__cover-placeholder" viewBox="0 0 4 3"
+               preserveAspectRatio="none" aria-hidden="true">
+            <rect width="4" height="3" fill="currentColor"/>
+          </svg>
+        </a>
+      <% when :svg %>
+        <a class="post-list__cover post-list__cover--svg" href="<%= post.url %>" aria-label="<%= post.title %>">
+          <%== cover_svg_for(post) %>
+        </a>
+      <% when :none %>
+      <% end %>
+
+      <div class="post-list__body">
+        <h2 class="post-list__title p-name">
+          <% if (pos = post.frontmatter['series_position']) %><span class="series-position">#<%= pos %></span> <% end %><a class="u-url" href="<%= post.url %>"><%= post.title %></a>
+        </h2>
+
+        <% if show_date && post.date %>
+          <p class="post-list__meta">
+            <time class="dt-published" datetime="<%= post.date.iso8601 %>"><%= local_time(post.date) %></time>
+            <% if show_reading_time && post.respond_to?(:content) && post.content.to_s.length.positive? %>
+              · <%= reading_time(post.content) %>
+            <% end %>
+          </p>
+        <% end %>
+
+        <% if show_description && (desc = post.frontmatter['description'].to_s) && !desc.empty? %>
+          <p class="post-list__description p-summary"><%= truncate(desc, length: truncate_at) %></p>
+        <% end %>
+
+        <% if show_tags && post.tags.any? %>
+          <p class="post-list__tags">
+            <% post.tags.each do |tag| %>
+              <a class="post-list__tag p-category" href="/tags/<%= slugify(tag) %>/"><%= tag %></a>
+            <% end %>
+          </p>
+        <% end %>
+      </div>
+    </li>
+  <% end %>
+</ul>

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

@@ -0,0 +1,92 @@
+<!--
+  Post series previews — stacked-image row showing each series in the
+  posts collection. Visual mirrors the publications index's series
+  preview block: overlapping covers fanned at slight angles, with the
+  series name + post count below.
+
+  Driven by the `posts_series` taxonomy (config/site.yml). Renders
+  nothing when no post has `series:` in its frontmatter.
+
+  Required locals (passed by `posts_index.html.erb`):
+    heading       — section heading text (default: "Series")
+    limit         — max tiles to show; nil = show all
+    all_url       — optional destination for the "View all →" link
+    cover_cap     — max overlapping covers per tile (default 3)
+
+  Each post in a series contributes its hero image (`image:` frontmatter,
+  resolved via `bundle_asset_url_for`). Posts without an image are
+  skipped from the stack; the tile still renders if at least one
+  cover is available.
+
+  Items are sorted by post-count desc (largest series first), then
+  by series name. Tile links to `/posts/series/<slug>/`.
+
+  Shares the `.series-preview*` CSS family with the publications
+  series previews — the `--posts` modifier overrides the cover's
+  aspect-ratio from 2:3 (book cover) to 16:9 (post hero).
+-->
+<%
+  cover_cap = (defined?(cover_cap) && cover_cap) || 3
+  limit     = defined?(limit) ? limit : nil
+  all_url   = defined?(all_url) ? all_url : nil
+  heading   = defined?(heading) && heading ? heading : 'Series'
+
+  series_map = site.posts_by_term('posts_series')
+                   .reject { |_term, posts| posts.empty? }
+                   .sort_by { |term, posts| [-posts.size, term.to_s] }
+
+  previews = series_map.map do |term, posts|
+    sorted = posts.sort_by do |p|
+      pos = p.frontmatter['series_position']
+      [pos.nil? ? Float::INFINITY : pos.to_i,
+       -(p.date&.to_i || 0)]
+    end
+    covers = sorted
+             .map { |p| { post: p, image: p.frontmatter['image'] } }
+             .select { |c| c[:image] }
+             .first(cover_cap)
+
+    {
+      term:   term,
+      url:    taxonomy_url('posts_series', term),
+      count:  posts.size,
+      covers: covers
+    }
+  end
+
+  previews = previews.first(limit) if limit && limit.to_i.positive?
+%>
+<% if previews.any? %>
+<section class="post-series-previews" aria-label="<%= h(heading) %>">
+  <header class="home-module__header">
+    <h2 class="home-module__heading"><%= heading %></h2>
+    <% if all_url && !all_url.to_s.empty? %>
+      <a class="home-module__see-all" href="<%= sanitized_url(all_url) %>">View all &rarr;</a>
+    <% end %>
+  </header>
+  <ul class="series-previews">
+    <% previews.each do |s| %>
+      <li class="series-preview series-preview--posts">
+        <a class="series-preview__link" href="<%= sanitized_url(s[:url]) %>">
+          <% if s[:covers].any? %>
+            <span class="series-preview__row" aria-hidden="true" data-n="<%= s[:covers].size %>">
+              <% s[:covers].each do |c| %>
+                <img class="series-preview__cover"
+                     src="<%= sanitized_url(bundle_asset_url_for(c[:post], c[:image])) %>"
+                     alt=""
+                     loading="lazy">
+              <% end %>
+            </span>
+          <% end %>
+          <span class="series-preview__body">
+            <span class="series-preview__title"><%= s[:term] %></span>
+            <span class="series-preview__meta">
+              <%= pluralize(s[:count], 'post') %>
+            </span>
+          </span>
+        </a>
+      </li>
+    <% end %>
+  </ul>
+</section>
+<% end %>

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

@@ -0,0 +1,75 @@
+<%#
+  Publication card — one book rendered as a horizontal card (cover-left,
+  body-right). Same markup and CSS hooks used in two contexts so the
+  styling stays consistent everywhere a publication is listed:
+    - publications-index (the /books/ or /publications/ listing)
+    - bundle.html.erb's "What's included" section
+
+  Required locals:
+    pub             Hash with normalized fields:
+                      :slug, :title, :cover, :description, :price,
+                      :isbn, :pages, :published, :position
+                    All optional except :slug + :title. When :position
+                    is set (e.g. on a series page), a small `#N` prefix
+                    renders before the title.
+    idx             Integer — used to cycle through the 4-tint placeholder
+                    classes so each cover-wrap holds its 2:3 shape before
+                    the image bytes arrive.
+    pubs_prefix     URL prefix for the publication link (honors
+                    `publications.slug:` aliasing — e.g. "/books/").
+
+  Optional locals (all default to the publications collection's
+  index.* config; override per-call if needed):
+    heading_level   Heading tag for the title (default 2). Set to 3
+                    when the partial sits inside a section that
+                    already has its own h2 (e.g. bundle's
+                    "What's included").
+    show_description, show_price, show_isbn, show_pages, show_published
+    truncate_at     Character limit for the description (default 200).
+%>
+<%
+  cfg = (site.collection_config('publications')['index'] || {})
+  level = defined?(heading_level) && heading_level ? heading_level : 2
+  _show_description = defined?(show_description) ? show_description : cfg.fetch('show_description', true)
+  _show_price       = defined?(show_price)       ? show_price       : cfg.fetch('show_price',       true)
+  _show_isbn        = defined?(show_isbn)        ? show_isbn        : cfg.fetch('show_isbn',        false)
+  _show_pages       = defined?(show_pages)       ? show_pages       : cfg.fetch('show_pages',       false)
+  _show_published   = defined?(show_published)   ? show_published   : cfg.fetch('show_published',   false)
+  _truncate_at      = defined?(truncate_at)      ? truncate_at      : cfg.fetch('description_truncate', 200)
+  tint = "publications-index__cover--tint-#{(idx % 4) + 1}"
+  heading_open  = "<h#{level} class=\"publications-index__title\">"
+  heading_close = "</h#{level}>"
+%>
+<li class="publications-index__item">
+  <a href="<%= pubs_prefix %><%= pub[:slug] %>/">
+    <div class="publications-index__cover <%= tint %>">
+      <% if pub[:cover] %>
+        <img src="<%= sanitized_url(pub[:cover]) %>"
+             alt="<%= pub[:title] %> cover"
+             width="600" height="900"
+             loading="lazy"
+             decoding="async">
+      <% end %>
+    </div>
+    <div class="publications-index__body">
+      <%== heading_open %><% if pub[:position] %><span class="publications-index__position">#<%= pub[:position] %></span> <% end %><%= pub[:title] %><%== heading_close %>
+      <% if _show_description && pub[:description] && !pub[:description].to_s.empty? %>
+        <p class="publications-index__description"><%= truncate(pub[:description].to_s, length: _truncate_at) %></p>
+      <% end %>
+      <% if _show_price && pub[:price] %>
+        <p class="publications-index__price"><%= pub[:price] %></p>
+      <% end %>
+      <% if _show_isbn && pub[:isbn] %>
+        <p class="publications-index__isbn">ISBN <%= pub[:isbn] %></p>
+      <% end %>
+      <% if _show_pages && pub[:pages] %>
+        <p class="publications-index__pages"><%= pluralize(pub[:pages], 'page') %></p>
+      <% end %>
+      <% if _show_published && pub[:published] %>
+        <p class="publications-index__published">
+          Published <time datetime="<%= pub[:published] %>"><%= local_time(pub[:published]) %></time>
+        </p>
+      <% end %>
+    </div>
+  </a>
+</li>

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

@@ -0,0 +1,61 @@
+<%#
+  Publication detail header — cover image (left) + title/metadata /
+  buy buttons (right), on a single 2-column grid on tablet and up.
+
+  Reads canonical fields from `page.frontmatter` directly (see
+  docs/publications.md). Whether the page is a manual content file
+  or an externally-sourced entry, the field names are the same —
+  no source-aware branching here.
+
+  Toggles come from `collections.publications.show.*` in config.
+%>
+<%
+  fm   = page.frontmatter
+  show = (site.collection_config('publications')['show'] || {})
+%>
+<header class="publication__header">
+  <% if (cover = fm['cover_url']) %>
+    <img class="publication__cover" src="<%= sanitized_url(cover) %>" alt="<%= fm['cover_alt'] || "#{page.title} cover" %>">
+  <% end %>
+
+  <div class="publication__intro">
+    <h1><%= page.title %></h1>
+
+    <% if show.fetch('show_tagline', true) && (tagline = fm['tagline']) %>
+      <p class="publication__tagline"><%= tagline %></p>
+    <% end %>
+
+    <%# Optional metadata fields — ISBN, pages, published date —
+        rendered as a small muted block of detail lines. %>
+    <% if show.fetch('show_isbn', true) && (isbn = fm['isbn']) %>
+      <p class="publication__isbn">ISBN <%= isbn %></p>
+    <% end %>
+
+    <% if show.fetch('show_pages', true) && (pages = fm['pages']) %>
+      <p class="publication__pages"><%= pluralize(pages, 'page') %></p>
+    <% end %>
+
+    <% if show.fetch('show_published', true) && (published = fm['published_at']) %>
+      <p class="publication__published">First published <time datetime="<%= published %>"><%= local_time(published) %></time></p>
+    <% end %>
+
+    <%# Pre-order / availability banner — optional fields, harmless
+        when absent. %>
+    <% if fm['preorder'] && fm['release_date'] %>
+      <p class="publication__preorder">Pre-order — releases <time datetime="<%= fm['release_date'] %>"><%= local_time(fm['release_date']) %></time></p>
+    <% end %>
+
+    <%# Purchase area — price sits adjacent to the buy buttons so
+        they read as a single unit (e-commerce convention). %>
+    <% if show.fetch('show_price', true) && (price = fm.dig('price', 'formatted')) %>
+      <p class="publication__price"><%= price %></p>
+    <% end %>
+
+    <%# Buy / cart buttons. Generic — render whenever the
+        corresponding URL field is set, regardless of source. %>
+    <p class="publication__buttons">
+      <%== buy_button(fm, label: fm['buy_label'] || 'Buy now') %>
+      <%== cart_button(fm) %>
+    </p>
+  </div>
+</header>

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

@@ -0,0 +1,68 @@
+<!--
+  Single related-style card. Cover-on-top, title and date below.
+
+  Used by:
+    - `_related_items` — the grid below show views (posts, photos,
+      publications, workshops).
+    - `_next_item` and `_next_in_series` — single emphasized card
+      with the same look, so the show-view tail reads as one
+      coherent run of related-style cards rather than a "different
+      card shape per section" jumble.
+
+  Locals (all optional unless noted):
+    item              — the page to render (required)
+    show_image        — bool, default true
+    is_workshop       — bool, default false; flips workshop-specific
+                        meta (date_from/date_to or duration; location)
+                        instead of the generic `item.date` line
+    ws_show_dates     — bool, default true (only when is_workshop)
+    ws_show_location  — bool, default true (only when is_workshop)
+-->
+<%
+  _show_image       = defined?(show_image)       ? show_image       : true
+  _is_workshop      = defined?(is_workshop)      ? is_workshop      : false
+  _ws_show_dates    = defined?(ws_show_dates)    ? ws_show_dates    : true
+  _ws_show_location = defined?(ws_show_location) ? ws_show_location : true
+%>
+<li class="related__item">
+  <a href="<%= item.url %>">
+    <% if _show_image %>
+      <%# Cover key varies by collection — `image:` is the bundle-
+          relative hero used by posts / photos / workshops;
+          `cover_url:` is the canonical key for publications,
+          bundles, and series (per docs/publications.md). Try
+          `image` first so the bundle convention wins when both
+          happen to be set, then fall through to `cover_url`. %>
+      <% cover = item.frontmatter['image'] || item.frontmatter['cover_url'] %>
+      <div class="related__cover<%= ' related__cover--placeholder' unless cover %>">
+        <% if cover %>
+          <img src="<%= sanitized_url(bundle_asset_url_for(item, cover)) %>"
+               alt="<%= item.frontmatter['caption'] || item.title %>"
+               loading="lazy"
+               decoding="async">
+        <% end %>
+      </div>
+    <% end %>
+    <span class="related__title"><%= item.title %></span>
+    <% if _is_workshop %>
+      <% fm = item.frontmatter %>
+      <% if _ws_show_dates && (df = fm['date_from']) %>
+        <span class="related__date">
+          <time datetime="<%= to_time(df).iso8601 %>"><%= local_time(df) %></time>
+          <% if (dt = fm['date_to']) && dt != df %>
+            &ndash; <time datetime="<%= to_time(dt).iso8601 %>"><%= local_time(dt) %></time>
+          <% end %>
+        </span>
+      <% elsif _ws_show_dates && fm['duration'] %>
+        <span class="related__date"><%= fm['duration'] %></span>
+      <% end %>
+      <% if _ws_show_location && fm['location'] %>
+        <span class="related__location"><%= fm['location'] %></span>
+      <% end %>
+    <% elsif item.respond_to?(:date) && item.date %>
+      <span class="related__date">
+        <time datetime="<%= item.date.iso8601 %>"><%= local_time(item.date) %></time>
+      </span>
+    <% end %>
+  </a>
+</li>