abqari 1.1.0

data/app/views/layouts/series.html.erb

@@ -0,0 +1,110 @@
+---
+layout: application
+---
+<!--
+  Single-series detail page. Reads canonical fields from
+  `page.frontmatter` (see docs/publications.md). Whether the page is
+  a manual `content/series/<slug>/index.md` or auto-generated from
+  an external publisher with `kind: 'series'`, the field names are
+  the same.
+
+  Note on commerce: a publisher integration may or may not attach
+  buy URLs to a series (Folio currently doesn't). A native author
+  CAN set `buy_now_url:` here to point at e.g. a series bundle; the
+  engine renders the button whenever the field is set, regardless
+  of source.
+
+  Frontmatter shape:
+
+      ---
+      layout: series
+      name: Light Notebooks
+      description: A two-volume set on the edges of the working day.
+      tagline: Beginnings and endings.            # optional
+      price: $28.00                               # optional (native only)
+      buy_now_url: https://...                    # optional (native only)
+      publications:
+        - slug: first-light
+          position: 1
+        - slug: last-light
+          position: 2
+      ---
+-->
+<article class="series">
+  <% fm = page.frontmatter %>
+
+  <header>
+    <h1><%= page.title %></h1>
+    <% if (tagline = fm['tagline']) %>
+      <p class="lede series__tagline"><%= tagline %></p>
+    <% end %>
+
+    <% if (price = fm.dig('price', 'formatted')) %>
+      <p class="series__price"><%= price %></p>
+    <% end %>
+
+    <%# Buy button — renders whenever a commerce URL is present. %>
+    <% if fm['buy_now_url'] || fm['add_to_cart_url'] %>
+      <p class="series__buttons">
+        <%== buy_button(fm, label: fm['buy_label'] || 'Buy now') %>
+        <%== cart_button(fm) %>
+      </p>
+    <% end %>
+  </header>
+
+  <%# Description — pre-rendered `description_html` when present,
+      otherwise the markdown `description` source rendered through
+      Commonmarker so inline emphasis, links, and paragraph breaks
+      come through. Canonical shape per docs/publications.md. %>
+  <%
+    description_source, description_content =
+      if (html = fm['description_html']) && !html.to_s.strip.empty?
+        [:description_html, html]
+      elsif (text = fm['description']) && !text.to_s.strip.empty?
+        [:description, markdown(text)]
+      else
+        [nil, nil]
+      end
+  %>
+  <% if description_source %>
+    <div class="series__description" data-source="<%= description_source %>">
+      <%== description_content %>
+    </div>
+  <% end %>
+
+  <%== page.content %>
+
+  <%# Books in this series. `publications:` is an array of slugs or
+      `{slug, position}` Hashes. Cards render with `:position` set so
+      each card shows its series position as a small "#N" prefix. %>
+  <%
+    source_pubs = Array(fm['publications'])
+    pubs_cfg = site.collection_config('publications')
+    pubs_prefix = pubs_cfg['slug'].to_s.empty? ?
+      pubs_cfg['permalink'].to_s.sub(':slug/', '').sub(':slug', '') :
+      "/#{pubs_cfg['slug']}/"
+    pubs_prefix = '/publications/' if pubs_prefix.empty?
+  %>
+  <% if source_pubs.any? %>
+    <section class="series__contents">
+      <h2 class="series__contents-heading">Books in this series</h2>
+      <ul class="publications-index">
+        <% source_pubs.each_with_index do |entry, idx| %>
+          <%
+            entry    = { 'slug' => entry } if entry.is_a?(String)
+            slug     = entry['slug']
+            card_pub = publication_card_data(slug)
+            card_pub[:title]    = entry['title']     if entry['title']
+            card_pub[:cover]    = entry['cover_url'] if entry['cover_url']
+            card_pub[:position] = entry['position']
+          %>
+          <%== render 'partials/publication_card',
+                     pub: card_pub,
+                     idx: idx,
+                     pubs_prefix: pubs_prefix,
+                     heading_level: 3 %>
+        <% end %>
+      </ul>
+    </section>
+  <% end %>
+</article>

data/app/views/layouts/series_index.html.erb

@@ -0,0 +1,202 @@
+---
+layout: application
+---
+<!--
+  Unified series taxonomy page — handles series for any collection.
+  Auto-generated by the engine for each (collection, series-name)
+  pair when an item carries `series:` in its frontmatter.
+
+  URLs are per-collection so naming collisions don't matter:
+    /posts/series/<slug>/        → posts with `series: "<name>"`
+    /photos/series/<slug>/       → photos with `series: "<name>"`
+    /publications/series/<slug>/ → publications with `series: "<name>"`
+                                    (+ Folio publications whose series
+                                    field matches)
+    /workshops/series/<slug>/    → workshops with `series: "<name>"`
+
+  Items are sorted by `series_position` (integer) ascending, then by
+  date descending as a tiebreaker. Items without a position sort to
+  the end of the list — useful when only some entries in a series
+  carry an explicit ordinal.
+
+  Each collection renders with its own card style:
+    - posts        → `_post_list` partial
+    - photos       → inline gallery tiles (same shape as gallery_index)
+    - publications → `_publication_card` partial (Folio + manual)
+    - workshops    → inline workshop summary cards
+-->
+<%
+  series_config = site.taxonomy_config(page.taxonomy)
+  coll          = series_config['collection']
+
+  # Position-then-date sort. nil positions go last; positive ints
+  # land in ascending order; ties resolved by date (newest first).
+  items = page.posts.sort_by do |item|
+    pos = item.frontmatter['series_position']
+    [pos.nil? ? Float::INFINITY : pos.to_i,
+     -(item.respond_to?(:date) && item.date ? item.date.to_i : 0)]
+  end
+
+  # Publication-series: merge Folio publications whose `series` field
+  # matches this term. Folio entries aren't Page instances; we render
+  # them via the same `_publication_card` partial as manual entries
+  # by normalising both shapes to a card-data hash up front.
+  folio_pub_extras = []
+  if coll == 'publications'
+    manual_slugs = items.map { |it| it.respond_to?(:slug) ? it.slug : nil }.compact.to_set
+    (site.data['folio_publications'] || {}).each do |slug, pub|
+      next if manual_slugs.include?(slug)
+      next unless pub['series'].to_s == page.term.to_s
+      folio_pub_extras << pub.merge('_slug' => slug, '_position' => pub.dig('in_series', 'position'))
+    end
+  end
+
+  total = items.size + folio_pub_extras.size
+
+  # Item label for the lede — singular collection name, pluralised
+  # for the count.
+  label = case coll
+          when 'posts'        then 'post'
+          when 'photos'       then 'photo'
+          when 'publications' then 'publication'
+          when 'workshops'    then 'workshop'
+          else                     'item'
+          end
+%>
+<article>
+  <header>
+    <h1><%= page.term %></h1>
+    <p class="lede"><%= pluralize(total, label) %></p>
+  </header>
+
+  <% if coll == 'posts' %>
+    <%== render 'partials/post_list', posts: items %>
+
+  <% elsif coll == 'photos' %>
+    <%
+      photos_cfg     = (site.collection_config('photos')['index'] || {})
+      show_location  = photos_cfg.fetch('show_location', true)
+      show_date      = photos_cfg.fetch('show_date',     true)
+      show_camera    = photos_cfg.fetch('show_camera',   false)
+      show_caption   = photos_cfg.fetch('show_caption',  false)
+      cols           = photos_cfg['cols'].to_i
+      cols           = nil unless [2, 3, 4].include?(cols)
+    %>
+    <ul class="gallery-index<%= " gallery-index--cols-#{cols}" if cols %>">
+      <% items.each_with_index do |photo, idx| %>
+        <% tint = "gallery-index__cover--tint-#{(idx % 4) + 1}" %>
+        <% position = photo.frontmatter['series_position'] %>
+        <li>
+          <a href="<%= sanitized_url(photo.url) %>">
+            <div class="gallery-index__cover <%= tint %>">
+              <% if photo.frontmatter['image'] %>
+                <img src="<%= sanitized_url(bundle_asset_url_for(photo, photo.frontmatter['image'])) %>"
+                     alt="<%= photo.frontmatter['caption'] || photo.title %>"
+                     width="1200" height="1200"
+                     loading="lazy"
+                     decoding="async">
+              <% end %>
+            </div>
+            <span class="gallery-index__title">
+              <% if position %><span class="series-position">#<%= position %></span> <% end %><%= photo.title %>
+            </span>
+            <% if show_location && (photo.frontmatter['city'] || photo.frontmatter['country']) %>
+              <span class="gallery-index__location">
+                <%= [photo.frontmatter['city'], photo.frontmatter['country']].compact.join(', ') %>
+              </span>
+            <% end %>
+            <% if show_date && photo.date %>
+              <span class="gallery-index__date">
+                <time datetime="<%= photo.date.iso8601 %>"><%= local_time(photo.date) %></time>
+              </span>
+            <% end %>
+            <% if show_camera && photo.frontmatter['camera'] %>
+              <span class="gallery-index__camera"><%= photo.frontmatter['camera'] %></span>
+            <% end %>
+            <% if show_caption && photo.frontmatter['caption'] %>
+              <span class="gallery-index__caption"><%= truncate(photo.frontmatter['caption'], length: photos_cfg.fetch('caption_truncate', 100)) %></span>
+            <% end %>
+          </a>
+        </li>
+      <% end %>
+    </ul>
+
+  <% elsif coll == 'publications' %>
+    <%
+      pub_cfg    = site.collection_config('publications')
+      index_cfg  = pub_cfg['index'] || {}
+      truncate_at      = index_cfg.fetch('description_truncate', 200)
+      show_description = index_cfg.fetch('show_description', true)
+      show_price       = index_cfg.fetch('show_price',       true)
+      show_isbn        = index_cfg.fetch('show_isbn',        false)
+      show_pages       = index_cfg.fetch('show_pages',       false)
+      show_published   = index_cfg.fetch('show_published',   false)
+      pubs_prefix      = pub_cfg['slug'].to_s.empty? ?
+        pub_cfg['permalink'].to_s.sub(':slug/', '').sub(':slug', '') :
+        "/#{pub_cfg['slug']}/"
+      pubs_prefix = '/publications/' if pubs_prefix.empty?
+
+      # Merge manual + Folio. publication_card_data fills in fields
+      # for manual entries; the Folio-only extras are built inline so
+      # we can still slot in `:position` from `in_series.position`.
+      merged = items.map do |item|
+        publication_card_data(item.respond_to?(:slug) ? item.slug : nil)
+          .merge(position: item.frontmatter['series_position'])
+      end
+      merged += folio_pub_extras.map do |pub|
+        slug = pub['_slug']
+        publication_card_data(slug).merge(position: pub['_position'])
+      end
+      merged.sort_by! { |it| [it[:position].nil? ? Float::INFINITY : it[:position].to_i, it[:title].to_s] }
+    %>
+    <ul class="publications-index">
+      <% merged.each_with_index do |pub, idx| %>
+        <%== render 'partials/publication_card',
+                   pub: pub,
+                   idx: idx,
+                   pubs_prefix: pubs_prefix,
+                   heading_level: 2,
+                   show_description: show_description,
+                   show_price: show_price,
+                   show_isbn: show_isbn,
+                   show_pages: show_pages,
+                   show_published: show_published,
+                   truncate_at: truncate_at %>
+      <% end %>
+    </ul>
+
+  <% elsif coll == 'workshops' %>
+    <ul class="workshops-series">
+      <% items.each do |w| %>
+        <% fm = w.frontmatter %>
+        <% position = fm['series_position'] %>
+        <li class="workshops-series__item">
+          <a href="<%= sanitized_url(w.url) %>">
+            <h3 class="workshops-series__title">
+              <% if position %><span class="series-position">#<%= position %></span> <% end %><%= w.title %>
+            </h3>
+            <% if (df = fm['date_from']) %>
+              <p class="workshops-series__meta">
+                <time datetime="<%= to_time(df).iso8601 %>"><%= local_time(df) %></time>
+                <% if fm['location'] %> &middot; <%= fm['location'] %><% end %>
+                <% if fm['format'] %> &middot; <%= fm['format'] %><% end %>
+              </p>
+            <% end %>
+            <% if (desc = fm['description'].to_s) && !desc.empty? %>
+              <p class="workshops-series__description"><%= truncate(desc, length: 160) %></p>
+            <% end %>
+          </a>
+        </li>
+      <% end %>
+    </ul>
+
+  <% else %>
+    <%# Unknown collection (e.g. a user-defined collection with a
+        series taxonomy pointed at it). Fall back to a plain list. %>
+    <ul>
+      <% items.each do |item| %>
+        <li><a href="<%= sanitized_url(item.url) %>"><%= item.title %></a></li>
+      <% end %>
+    </ul>
+  <% end %>
+</article>

data/app/views/layouts/tag.html.erb

@@ -0,0 +1,16 @@
+---
+layout: application
+---
+<!--
+  Tag taxonomy page — auto-generated for every tag found in posts'
+  frontmatter. Layout mirrors `posts_index.html.erb`: <article> wrapper
+  with a <header> containing the H1 and a `.lede` count line, then the
+  shared `_post_list` partial.
+-->
+<article>
+  <header>
+    <h1>Posts tagged <em><%= page.term %></em></h1>
+    <p class="lede"><%= pluralize(page.posts.size, 'post') %></p>
+  </header>
+  <%== render 'partials/post_list', posts: page.posts %>
+</article>

data/app/views/layouts/visualization.html.erb

@@ -0,0 +1,32 @@
+---
+layout: application
+---
+<!--
+  Visualization layout — D3 chart with a tooltip overlay. Static-style
+  scaffolding (positioning, sizing, tooltip chrome) lives in CSS via
+  the `.viz-container`, `.viz-loading`, `.viz-tooltip` classes in
+  `_common.css` rather than inline `style=` attributes, so the rendered
+  HTML stays clean under a strict CSP.
+-->
+<article class="viz-article">
+  <header>
+    <h1><%= page.title %></h1>
+    <p class="lede"><%= page.description %></p>
+  </header>
+
+  <div id="viz-container" class="viz-container">
+    <div id="viz-loading" class="viz-loading">Loading&hellip;</div>
+  </div>
+
+  <div id="viz-tooltip" class="viz-tooltip"></div>
+
+  <p class="viz-note">
+    <small>Generated at build time from <code>site.posts</code>. Data file: <a href="/visualizations/<%= page.viz_name %>.json"><code>/visualizations/<%= page.viz_name %>.json</code></a>.</small>
+  </p>
+</article>
+<%# d3 ships in the gem's `vendor/d3/`; Site#copy_d3 copies it to
+    `_site/assets/d3/d3.v7.min.js` so it can be referenced by an
+    absolute path. Not fingerprinted: the file is a frozen vendored
+    dependency that changes only on a deliberate engine update. %>
+<script src="/assets/d3/d3.v7.min.js"></script>
+<script src="<%= asset_path("js/viz-#{page.viz_name}.js") %>"></script>

data/app/views/layouts/workshop.html.erb

@@ -0,0 +1,163 @@
+---
+layout: application
+---
+<!--
+  Workshop detail page — a single training offering / workshop.
+  Reads structured metadata from frontmatter; the body markdown
+  describes the workshop in detail (curriculum, outcomes, format
+  specifics, who it's for, etc.).
+
+  Frontmatter:
+
+      ---
+      layout: workshop
+      title: Crisis Response Foundations
+      description: A two-day workshop on building crisis-response capability.
+      date_from: 2026-06-15            # optional — start date
+      date_to:   2026-06-16            # optional — paired with date_from
+      duration:  2 days                # optional — fallback when dates
+                                       #   aren't fixed (evergreen workshops)
+      location:  Singapore             # optional — city / country / "Remote"
+      format:    In-person             # optional — In-person / Remote / Hybrid
+      instructors:                     # optional — one or many
+        - Ada Lovelace
+        - Jane Doe
+      price:     $1,495                # optional — string or number
+      registration_url: https://...    # optional — CTA button target
+      image:     hero.jpg              # optional — wide hero image,
+                                       #   relative within the bundle
+                                       #   (renders between header and meta)
+      tags: [crisis-management]
+      ---
+
+  All metadata fields are optional. Each `<dl>` row only renders
+  when its frontmatter is set, and the `<dl>` itself is omitted
+  if no metadata fields are present.
+
+  When `date_from` is set, the dates row renders with `<time>`
+  elements (machine-readable + display-formatted). Otherwise
+  `duration` is used as the fallback (useful for evergreen
+  workshop templates offered on request).
+
+  Renders nothing about the workshop when the page lacks all
+  metadata — body markdown still renders, so a workshop page
+  with only title + body works fine.
+
+  Hero rendering is gated by `collections.workshops.show.cover` in
+  config/site.yml — `photo` (default) renders `image:` if set and
+  nothing otherwise; `photo_or_svg` falls back to a decorative
+  initial-tile SVG; `svg` always renders the decorative SVG; `none`
+  suppresses the hero entirely. The matching enum on the index card
+  is `collections.workshops.index.cover` — independent of this one.
+  Per-workshop override via frontmatter `cover:` (boolean `false`
+  for none, or one of the enum strings).
+-->
+<%
+  fm = page.frontmatter
+  date_from        = fm['date_from']
+  date_to          = fm['date_to']
+  duration         = fm['duration']
+  location         = fm['location']
+  format           = fm['format']
+  instructors      = Array(fm['instructors']).reject { |i| i.to_s.strip.empty? }
+  price            = fm['price']
+  registration_url = fm['registration_url']
+
+  has_meta = date_from || duration || location || format || instructors.any? || price
+%>
+<article class="workshop">
+  <%== render 'partials/draft_banner' %>
+  <%== render 'partials/future_banner' %>
+  <%== render 'partials/back_to_index' %>
+
+  <header>
+    <h1><%= page.title %></h1>
+    <% if (description = fm['description']) && !description.to_s.empty? %>
+      <p class="lede"><%= description %></p>
+    <% end %>
+    <%# Hero — `cover_choice_for` resolves frontmatter `cover:` +
+        collection `show.cover` to one of :photo / :placeholder /
+        :svg / :none. We render :photo and :svg; :placeholder maps
+        to "no hero" on the show page (a blank flat-tint banner
+        above the body doesn't read as content). %>
+    <% case cover_choice_for(page, context: :show) %>
+    <% when :photo %>
+      <img class="workshop__hero"
+           src="<%= sanitized_url(bundle_asset_url(fm['image'])) %>"
+           alt="<%= page.title %>"
+           loading="eager">
+    <% when :svg %>
+      <div class="workshop__hero workshop__hero--svg" aria-hidden="true">
+        <%== cover_svg_for(page) %>
+      </div>
+    <% end %>
+  </header>
+
+  <%# Workshop metadata. `<dl>` with each row wrapped in a `<div>` —
+      lets CSS lay each pair out as a flex/grid row without `:has()`
+      gymnastics, same pattern as `.photo__meta`. %>
+  <% if has_meta %>
+    <dl class="workshop__meta">
+      <% if date_from %>
+        <div>
+          <dt>When</dt>
+          <dd>
+            <time datetime="<%= to_time(date_from).iso8601 %>"><%= local_time(date_from) %></time>
+            <% if date_to %>
+              &ndash;
+              <time datetime="<%= to_time(date_to).iso8601 %>"><%= local_time(date_to) %></time>
+            <% end %>
+          </dd>
+        </div>
+      <% elsif duration %>
+        <div><dt>Duration</dt><dd><%= duration %></dd></div>
+      <% end %>
+
+      <% if location %>
+        <div><dt>Location</dt><dd><%= location %></dd></div>
+      <% end %>
+
+      <% if format %>
+        <div><dt>Format</dt><dd><%= format %></dd></div>
+      <% end %>
+
+      <% if instructors.any? %>
+        <div>
+          <dt><%= instructors.size > 1 ? 'Instructors' : 'Instructor' %></dt>
+          <dd><%= instructors.map { |i| h(i) }.join(', ') %></dd>
+        </div>
+      <% end %>
+
+      <% if price %>
+        <div><dt>Price</dt><dd><%= price %></dd></div>
+      <% end %>
+    </dl>
+  <% end %>
+
+  <% if registration_url && (safe_registration_url = sanitized_url(registration_url)) %>
+    <p class="workshop__cta">
+      <a href="<%= safe_registration_url %>" class="btn btn-primary" target="_blank" rel="noopener noreferrer">Register</a>
+    </p>
+  <% end %>
+
+  <%== page.content %>
+</article>
+
+<%# Testimonials about this workshop — pulls from data/testimonials.yml
+    entries where `collection: workshops` matches this page's slug. The
+    partial renders nothing when there are no matches. %>
+<%== render 'partials/testimonials', subject: page, heading: 'What attendees say' %>
+
+<%== render 'partials/related_items' %>
+
+<%# Schema.org Event JSON-LD — renders nothing when `date_from` is
+    absent (evergreen workshops aren't real Events). Otherwise carries
+    startDate/endDate, location (or VirtualLocation for remote), offers,
+    performers (instructors), and organizer for rich-snippet eligibility. %>
+<%== render 'partials/event_jsonld' %>
+
+<%# Schema.org Course + CourseInstance — workshops are both events
+    AND courses semantically, and Google has separate rich-result
+    surfaces for each. Emitting both lets the page win in either
+    carousel. Renders when frontmatter has `date_from:` or `duration:`. %>
+<%== render 'partials/course_jsonld' %>