abqari 1.1.0

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

@@ -0,0 +1,80 @@
+---
+layout: application
+---
+<!--
+  Posts index — listing of all posts. Theme-neutral structure; themes
+  style via `themes/<name>/css/app.css`.
+
+  Title and description both come from the page's frontmatter:
+
+      ---
+      title: Stories
+      description: Standalone glimpses into the assassin's world…
+      ---
+
+  The frontmatter `description:` doubles as the SEO meta description
+  AND the visible lede shown below the h1. Omit to hide the lede;
+  the page falls back to the site-wide description for the meta tag.
+  The page's markdown body (if any) renders below the lede.
+
+  Per-card display in the listing is controlled by
+  `collections.posts.index.show_*` toggles; see
+  partials/_post_list.html.erb for the full list.
+-->
+<%
+  description = page.frontmatter['description']
+
+  cfg          = site.collection_config('posts')
+  index_cfg    = cfg['index']    || {}
+  archive_cfg  = cfg['archive']  || {}
+  series_cfg   = index_cfg['series'] || {}
+  archive_on   = archive_cfg.fetch('enabled', true)
+  latest_count = index_cfg.fetch('latest_count', 8).to_i
+
+  if archive_on
+    # Archive mode — finite front index, no pagination. Show the latest
+    # N posts as full cards, link out to the archive for the rest.
+    all_posts     = site.collection('posts')
+    visible_posts = all_posts.first(latest_count)
+    total_posts   = all_posts.size
+    archive_url   = "#{collection_index_url('posts')}archive/"
+  else
+    # Classic paginated mode — page.paginator handles slicing.
+    visible_posts = page.paginator&.posts || site.collection('posts')
+  end
+%>
+<article>
+  <header>
+    <h1><%= page.title %></h1>
+    <% if description && !description.to_s.empty? %>
+      <p class="lede"><%= description %></p>
+    <% end %>
+  </header>
+  <% if page.content && !page.content.to_s.strip.empty? %>
+    <div class="index-intro"><%== page.content %></div>
+  <% end %>
+
+  <%== render 'partials/post_list', posts: visible_posts %>
+
+  <%# Post-series previews — stacked-cover row showing each series
+      with its post-hero images fanned out. Toggle with
+      `collections.posts.index.series.enabled`. Renders nothing when
+      no post in the collection has `series:` set, regardless of
+      the toggle. %>
+  <% if series_cfg.fetch('enabled', true) %>
+    <%== render 'partials/post_series_previews',
+                heading: 'Series',
+                limit:   series_cfg['limit'],
+                all_url: series_cfg['all_url'] %>
+  <% end %>
+
+  <% if archive_on %>
+    <% if total_posts > latest_count %>
+      <p class="posts-index__more">
+        <a href="<%= sanitized_url(archive_url) %>">View all <%= total_posts %> posts &rarr;</a>
+      </p>
+    <% end %>
+  <% else %>
+    <%== render 'partials/pagination', paginator: page.paginator %>
+  <% end %>
+</article>

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

@@ -0,0 +1,116 @@
+---
+layout: application
+---
+<!--
+  Publication detail page. One layout, one data source: the page's
+  frontmatter, in canonical shape (see docs/publications.md). Whether
+  the page is a manual `content/publications/<slug>/index.md` or
+  auto-generated from an external publisher, the field names are
+  the same.
+
+  Driven by `collections.publications.show.*` config toggles:
+
+    Metadata fields:
+      show_description, show_tagline, show_price,
+      show_isbn, show_pages, show_published
+
+    Hero image (between header and body, driven by `hero_image:`
+    frontmatter):
+      show_hero
+
+    Section toggles:
+      testimonials       filter data/testimonials.yml by slug
+      related_books      other publications in the series
+      related_bundles    bundles this publication is part of
+-->
+<%
+  fm    = page.frontmatter
+  show  = (site.collection_config('publications')['show'] || {})
+
+  show_description = show.fetch('show_description', true)
+  show_hero        = show.fetch('show_hero',        true)
+%>
+
+<article class="publication">
+  <%== render 'partials/draft_banner' %>
+  <%== render 'partials/future_banner' %>
+  <%== render 'partials/back_to_index' %>
+
+  <%== render 'partials/publication_header' %>
+
+  <%# Hero image — wide banner image placed between the header
+      metadata and the body description. Driven by frontmatter
+      `hero_image:` (and optional `hero_alt:`). Renders nothing when
+      absent or `show_hero` is false. %>
+  <% if show_hero && (hero_image = fm['hero_image']) %>
+    <figure class="publication__hero">
+      <img src="<%= sanitized_url(hero_image) %>"
+           alt="<%= fm['hero_alt'] || page.title %>"
+           loading="lazy">
+    </figure>
+  <% end %>
+
+  <%# Description — Folio's `excerpt_html` (pre-rendered) when present,
+      otherwise the `excerpt` source escaped. Both fields are in
+      canonical shape. The selected source is exposed as
+      `data-source="…"` so you can see in DevTools which path the
+      data came from. %>
+  <%
+    description_source, description_content =
+      if (html = fm['excerpt_html']) && !html.to_s.strip.empty?
+        [:excerpt_html, html]
+      elsif (excerpt = fm['excerpt']) && !excerpt.to_s.strip.empty?
+        [:excerpt, h(excerpt)]
+      else
+        [nil, nil]
+      end
+  %>
+  <% if show_description && description_source %>
+    <div class="publication__description" data-source="<%= description_source %>">
+      <%== description_content %>
+    </div>
+  <% end %>
+
+  <%# Markdown body — additional content (CTAs, related-content links,
+      etc.) that is NOT in the excerpt. Synopsis prose belongs in
+      `excerpt:`, not here. %>
+  <%== page.content %>
+
+  <%# Series — canonical `in_series` Hash. Reads from frontmatter
+      whether the source is manual or Folio. %>
+  <% if (in_series = fm['in_series']).is_a?(Hash) && in_series['slug'] %>
+    <p class="publication__series">
+      Part of the
+      <a href="/series/<%= in_series['slug'] %>/"><%= in_series['name'] || in_series['slug'] %></a>
+      series<% if in_series['position'] %> (#<%= in_series['position'] %>)<% end %>.
+    </p>
+  <% end %>
+
+  <% if show.fetch('testimonials', true) %>
+    <%== render 'partials/testimonials', subject: page %>
+  <% end %>
+
+  <% if show.fetch('related_books', true) %>
+    <%== render 'partials/book_related' %>
+  <% end %>
+
+  <%# Bundle CTAs — derive from canonical `in_bundles` (Folio supplies
+      it directly) AND from the inverse lookup (bundles that list
+      this publication's slug, native or Folio). %>
+  <% if show.fetch('related_bundles', true) %>
+    <%
+      explicit_bundles = Array(fm['in_bundles']).map { |b| b.is_a?(Hash) ? b['slug'] : b.to_s }
+      inverse_bundles  = site.collection('bundles').select do |b|
+        Array(b.frontmatter['publications']).map { |x| x.is_a?(Hash) ? x['slug'] : x.to_s }.include?(page.slug)
+      end.map(&:slug)
+      bundle_slugs = (explicit_bundles + inverse_bundles).uniq
+    %>
+    <% bundle_slugs.each do |bundle_slug| %>
+      <%== render 'partials/bundle_cta', bundle_slug: bundle_slug %>
+    <% end %>
+  <% end %>
+
+  <%== render 'partials/book_jsonld' %>
+</article>
+
+<%== render 'partials/related_items' %>

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

@@ -0,0 +1,89 @@
+---
+layout: application
+---
+<!--
+  Publications archive — the canonical full grid of every publication
+  in the `publications` collection, paginated. Pairs with
+  `publications_index.html.erb`: when
+  `collections.publications.archive.enabled: true`, the front page is
+  a curated landing (showcase + latest N + bundles + series), and
+  this page holds the full list.
+
+  After the canonical-schema migration (docs/publications.md),
+  `site.collection('publications')` returns BOTH manual content
+  pages AND Folio-sourced entries — the paginator slices the merged
+  list automatically. Folio-only publications appear here without
+  needing a manual override page.
+
+  Wire it up by creating `content/publications-archive.md` (NOT
+  inside `content/publications/` — that would make the page a
+  publication itself) with:
+
+      ---
+      title: Publications archive
+      description: Every book on the site, newest first.
+      layout: publications_archive
+      permalink: /publications/archive/
+      paginate: true
+      paginate_collection: publications
+      ---
+
+  `paginate: true` reads the page count from
+  `collections.publications.pagination.per_page` in config/site.yml.
+  `paginate_collection: publications` is **required** — without it
+  the paginator falls back to the default `'posts'` collection.
+-->
+<%
+  cfg       = (site.collection_config('publications') || {})
+  index_cfg = cfg['index'] || {}
+  description      = page.frontmatter['description']
+  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)
+  truncate_at      = index_cfg.fetch('description_truncate', 200)
+
+  # URL prefix for individual publication pages — honors `slug:` aliasing.
+  pubs_prefix = cfg['slug'].to_s.empty? ?
+    cfg['permalink'].to_s.sub(':slug/', '').sub(':slug', '') :
+    "/#{cfg['slug']}/"
+  pubs_prefix = '/publications/' if pubs_prefix.empty?
+
+  # Paginator carries this page's slice of the collection;
+  # fall back to the full collection if pagination is disabled.
+  pubs = page.paginator&.posts || site.collection('publications')
+%>
+<article>
+  <header>
+    <h1><%= page.title || 'Publications archive' %></h1>
+    <% if description && !description.to_s.empty? %>
+      <p class="lede"><%= description %></p>
+    <% end %>
+  </header>
+  <% if page.content && !page.content.to_s.strip.empty? %>
+    <div class="index-intro"><%== page.content %></div>
+  <% end %>
+
+  <% if pubs.any? %>
+    <ul class="publications-index">
+      <% pubs.each_with_index do |pub_page, idx| %>
+        <%# `publication_card_data(slug)` returns the normalised hash
+            the `_publication_card` partial expects — reads canonical
+            frontmatter fields directly. %>
+        <%== render 'partials/publication_card',
+                   pub: publication_card_data(pub_page.slug),
+                   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>
+    <%== render 'partials/pagination', paginator: page.paginator %>
+  <% end %>
+</article>

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

@@ -0,0 +1,246 @@
+---
+layout: application
+---
+<!--
+  Publications index — lists every publication in the `publications`
+  collection. `site.collection('publications')` already includes BOTH
+  manual content pages AND any externally-sourced entries a publisher
+  integration has added — no merge loop needed here (see
+  docs/publications.md for the canonical schema).
+
+  Sites that want /books/ URLs set `publications.slug: books` in
+  config — the URL prefix below follows the slug.
+-->
+<%
+  cfg = (site.collection_config('publications') || {})
+  index_cfg   = cfg['index']   || {}
+  archive_cfg = cfg['archive'] || {}
+  description      = page.frontmatter['description']
+  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)
+  truncate_at      = index_cfg.fetch('description_truncate', 200)
+  display_showcase = index_cfg.fetch('display_showcase',  false)
+  archive_on       = archive_cfg.fetch('enabled', true)
+  latest_count     = index_cfg.fetch('latest_count', 8).to_i
+
+  # URL prefix for individual publication pages — honors `slug:` aliasing.
+  pubs_prefix = cfg['slug'].to_s.empty? ?
+    cfg['permalink'].to_s.sub(':slug/', '').sub(':slug', '') :
+    "/#{cfg['slug']}/"
+  pubs_prefix = '/publications/' if pubs_prefix.empty?
+  archive_url = "#{pubs_prefix}archive/"
+
+  # The collection merges manual + externally-sourced entries
+  # automatically (see Site#collection). We just filter out the index
+  # page itself.
+  publications = site.collection('publications').reject { |p| p.url == page.url }
+
+  # Normalise each entry into the shape `_publication_card` expects.
+  # All fields read from canonical frontmatter — no source-aware
+  # branching.
+  items = publications.map do |pub|
+    fm = pub.frontmatter
+    {
+      slug:        pub.slug,
+      title:       pub.title,
+      cover:       fm['cover_url'],
+      description: fm['excerpt'] || fm['tagline'],
+      tagline:     fm['tagline'],
+      price:       fm.dig('price', 'formatted'),
+      isbn:        fm['isbn'],
+      pages:       fm['pages'],
+      published:   fm['published_at'],
+      sort_pos:    fm.dig('in_series', 'position') || fm['order'] || 999
+    }
+  end
+
+  items.sort_by! { |item| [item[:sort_pos], item[:title].to_s] }
+
+  # Showcase book — surfaced at the top of the page when
+  # `display_showcase: true` AND a publication's frontmatter declares
+  # `showcase: true`. Showcased book is removed from the items list
+  # below so it doesn't appear twice. First match wins.
+  showcase = nil
+  if display_showcase
+    showcase_page = publications.find { |p| p.frontmatter['showcase'] == true }
+    if showcase_page
+      showcase = items.find { |it| it[:slug] == showcase_page.slug }
+      items.reject! { |it| it[:slug] == showcase_page.slug } if showcase
+    end
+  end
+
+  # Bundle / series previews. Each preview is a row of overlapping
+  # covers linking to the bundle/series detail page. The cap stops
+  # large groupings from dominating the row.
+  preview_cover_cap = 3
+
+  build_preview = lambda do |item|
+    fm   = item.frontmatter
+    pubs = Array(fm['publications']).map { |e| e.is_a?(Hash) ? e['slug'] : e.to_s }.compact
+    {
+      slug:   item.slug,
+      url:    item.url,
+      title:  item.title,
+      price:  fm.dig('price', 'formatted'),
+      sort:   fm['order'] || Float::INFINITY,
+      count:  pubs.size,
+      covers: pubs.first(preview_cover_cap).map { |s| publication_card_data(s) }
+    }
+  end
+
+  bundle_previews = site.collection('bundles').reject { |b| b.url == page.url }
+                        .map { |b| build_preview.call(b) }
+                        .select { |p| p[:covers].any? { |c| c[:cover] } }
+                        .sort_by { |p| [p[:sort], p[:title].to_s] }
+  series_previews = site.collection('series').reject { |s| s.url == page.url }
+                        .map { |s| build_preview.call(s) }
+                        .select { |p| p[:covers].any? { |c| c[:cover] } }
+                        .sort_by { |p| [p[:sort], p[:title].to_s] }
+%>
+<article>
+  <header>
+    <h1><%= page.title || 'Publications' %></h1>
+    <% if description && !description.to_s.empty? %>
+      <p class="lede"><%= description %></p>
+    <% end %>
+  </header>
+  <% if page.content && !page.content.to_s.strip.empty? %>
+    <div class="index-intro"><%== page.content %></div>
+  <% end %>
+
+  <%# Showcase block — opt-in via `display_showcase` + a single
+      publication's `showcase: true` frontmatter. Renders nothing when
+      either is missing. Cover-left / body-right on wider screens. %>
+  <% if showcase %>
+    <section class="publication-showcase" aria-label="Featured publication">
+      <a class="publication-showcase__link" href="<%= pubs_prefix %><%= showcase[:slug] %>/">
+        <% if showcase[:cover] %>
+          <div class="publication-showcase__cover">
+            <img src="<%= sanitized_url(showcase[:cover]) %>" alt="<%= showcase[:title] %> cover" loading="eager">
+          </div>
+        <% end %>
+        <div class="publication-showcase__body">
+          <p class="publication-showcase__eyebrow">Featured</p>
+          <h2 class="publication-showcase__title"><%= showcase[:title] %></h2>
+          <% if (tagline = showcase[:tagline]) && !tagline.to_s.empty? %>
+            <p class="publication-showcase__tagline"><%= tagline %></p>
+          <% end %>
+          <% if show_description && (desc = showcase[:description].to_s) && !desc.empty? %>
+            <p class="publication-showcase__description"><%= truncate(desc, length: truncate_at) %></p>
+          <% end %>
+          <% if show_price && showcase[:price] %>
+            <p class="publication-showcase__price"><%= showcase[:price] %></p>
+          <% end %>
+        </div>
+      </a>
+    </section>
+  <% end %>
+
+  <%# Catalogue — primary list, sits directly under the page header.
+      Each book rendered by the shared `_publication_card` partial;
+      same markup is reused on bundle pages' "What's included"
+      section. Bundles + series sit below as supplementary groupings.
+
+      When `archive.enabled: true` (the default), the landing shows
+      only `index.latest_count` items as full cards, then links out
+      to /publications/archive/ for the canonical full list. %>
+  <%
+    # `archive_total` counts the full collection (including the
+    # showcased book, which was extracted from `items` above) so the
+    # "View all N publications" link is honest about what the archive
+    # page will show. `visible_items` is the subset that renders as
+    # cards on this landing.
+    archive_total = publications.size
+    visible_items = archive_on ? items.first(latest_count) : items
+    show_more     = archive_on && archive_total > visible_items.size
+  %>
+  <ul class="publications-index">
+    <% visible_items.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>
+
+  <% if show_more %>
+    <p class="publications-index__more">
+      <a href="<%= sanitized_url(archive_url) %>">View all <%= archive_total %> publications &rarr;</a>
+    </p>
+  <% end %>
+
+  <%# Bundles — each rendered as a stack of covers at slight angles,
+      linking through to the bundle detail page. Renders nothing when
+      no bundles exist. %>
+  <% if bundle_previews.any? %>
+    <section class="pubs-grouping pubs-grouping--bundles" aria-labelledby="bundles-heading">
+      <h2 id="bundles-heading" class="pubs-grouping__heading">Bundles</h2>
+      <ul class="bundle-previews">
+        <% bundle_previews.each do |b| %>
+          <li class="bundle-preview">
+            <a class="bundle-preview__link" href="<%= sanitized_url(b[:url]) %>">
+              <span class="bundle-preview__stack" aria-hidden="true">
+                <% b[:covers].reverse.each_with_index do |c, i| %>
+                  <% layer = ['back', 'mid', 'front'][b[:covers].size - 1 - i] || 'back' %>
+                  <% if c[:cover] %>
+                    <img class="bundle-preview__cover bundle-preview__cover--<%= layer %>"
+                         src="<%= sanitized_url(c[:cover]) %>" alt="" loading="lazy">
+                  <% end %>
+                <% end %>
+              </span>
+              <span class="bundle-preview__body">
+                <span class="bundle-preview__title"><%= b[:title] %></span>
+                <span class="bundle-preview__meta">
+                  <%= b[:count] %> <%= b[:count] == 1 ? 'book' : 'books' %>
+                  <% if b[:price] %> &middot; <%= b[:price] %><% end %>
+                </span>
+              </span>
+            </a>
+          </li>
+        <% end %>
+      </ul>
+    </section>
+  <% end %>
+
+  <%# Series — each rendered as a row of overlapping covers at slight
+      alternating angles, linking through to the series detail page.
+      Renders nothing when no series exist. %>
+  <% if series_previews.any? %>
+    <section class="pubs-grouping pubs-grouping--series" aria-labelledby="series-heading">
+      <h2 id="series-heading" class="pubs-grouping__heading">Series</h2>
+      <ul class="series-previews">
+        <% series_previews.each do |s| %>
+          <li class="series-preview">
+            <a class="series-preview__link" href="<%= sanitized_url(s[:url]) %>">
+              <span class="series-preview__row" aria-hidden="true" data-n="<%= s[:covers].size %>">
+                <% s[:covers].each do |c| %>
+                  <% if c[:cover] %>
+                    <img class="series-preview__cover"
+                         src="<%= sanitized_url(c[:cover]) %>" alt="" loading="lazy">
+                  <% end %>
+                <% end %>
+              </span>
+              <span class="series-preview__body">
+                <span class="series-preview__title"><%= s[:title] %></span>
+                <span class="series-preview__meta">
+                  <%= s[:count] %> <%= s[:count] == 1 ? 'book' : 'books' %>
+                  <% if s[:price] %> &middot; <%= s[:price] %><% end %>
+                </span>
+              </span>
+            </a>
+          </li>
+        <% end %>
+      </ul>
+    </section>
+  <% end %>
+</article>

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

@@ -0,0 +1,48 @@
+---
+layout: application
+---
+<!--
+  Auto-generated index of all related items for a source page. Lives at
+  /<source url>related/ — e.g. /posts/writing-in-markdown/related/. Only
+  generated when the show-view's related block has overflow (more matches
+  than the visible `limit`). Driven by Site#generate_related_pages and
+  the RelatedIndexPage class.
+
+  Uses the same .related__* CSS as the show-view block, plus a
+  --full modifier for the wider grid that suits a dedicated page.
+-->
+<article>
+  <header>
+    <h1>Related to
+      <a href="<%= sanitized_url(page.source_page.url) %>"><%= page.source_page.title %></a>
+    </h1>
+    <p class="lede"><%= pluralize(page.related_items.size, 'related item') %>, ranked by overlap.</p>
+  </header>
+
+  <ul class="related__list related__list--full">
+    <% page.related_items.each do |item| %>
+      <li class="related__item">
+        <a href="<%= sanitized_url(item.url) %>">
+          <% if (cover = item.frontmatter['image'] || item.frontmatter['cover']) %>
+            <div class="related__cover">
+              <img src="<%= sanitized_url(cover) %>"
+                   alt="<%= item.frontmatter['caption'] || item.title %>"
+                   loading="lazy"
+                   decoding="async">
+            </div>
+          <% end %>
+          <span class="related__title"><%= item.title %></span>
+          <% if item.respond_to?(:date) && item.date %>
+            <span class="related__date">
+              <time datetime="<%= item.date.iso8601 %>"><%= local_time(item.date) %></time>
+            </span>
+          <% end %>
+        </a>
+      </li>
+    <% end %>
+  </ul>
+
+  <p class="related__back">
+    <a href="<%= sanitized_url(page.source_page.url) %>">&larr; Back to <%= page.source_page.title %></a>
+  </p>
+</article>