abqari 1.1.0

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

@@ -0,0 +1,81 @@
+<!--
+  Schema.org CollectionPage JSON-LD for a collection index page
+  (/posts/, /photos/, /publications/, /workshops/, /posts/archive/).
+
+  Picks a more-specific @type based on the collection:
+    posts        → Blog          (with `blogPosts`)
+    photos       → ImageGallery  (with `image` items)
+    publications → ItemList      (no Books on the index per Google guidance)
+    workshops    → ItemList      (no Events on the index — too noisy)
+    default      → CollectionPage
+
+  Helps Google Discover / news surfaces categorise the page and pick
+  the right rich-result template. Skipped when the page isn't a
+  collection index (the partial guards via `collection_index_name`).
+-->
+<%
+  site_url  = site.config['url'].to_s.sub(%r{/\z}, '')
+  coll_name = site.collection_index_name(page) if page.respond_to?(:source_path)
+%>
+<% if !site_url.empty? && coll_name %>
+<%
+  jsonld_type = case coll_name
+                when 'posts'        then 'Blog'
+                when 'photos'       then 'ImageGallery'
+                when 'publications', 'workshops', 'bundles', 'series'
+                                    then 'CollectionPage'
+                else                     'CollectionPage'
+                end
+
+  jsonld = {
+    "@context"   => "https://schema.org",
+    "@type"      => jsonld_type,
+    "name"       => page.title,
+    "url"        => "#{site_url}#{page.url}",
+    "inLanguage" => site.config['locale'] || 'en'
+  }
+  jsonld["description"] = page.description if page.description
+
+  # Item listing — capped at 20 to keep JSON-LD payload modest.
+  # Google parses the first ~20 anyway and ignores the rest.
+  items = (site.collection(coll_name) rescue []) || []
+  items_to_emit = items.first(20)
+  if items_to_emit.any?
+    list_items = items_to_emit.each_with_index.map do |item, idx|
+      entry = { "@type" => "ListItem",
+                "position" => idx + 1,
+                "url" => "#{site_url}#{item.url}",
+                "name" => item.title.to_s }
+      entry
+    end
+
+    # For Blog, use `blogPost` instead of generic ItemList.
+    if jsonld_type == 'Blog'
+      jsonld["blogPost"] = items_to_emit.map do |item|
+        {
+          "@type"         => "BlogPosting",
+          "headline"      => item.title.to_s,
+          "url"           => "#{site_url}#{item.url}",
+          "datePublished" => (item.respond_to?(:date) && item.date ? item.date.iso8601 : nil)
+        }.compact
+      end
+    elsif jsonld_type == 'ImageGallery'
+      jsonld["image"] = items_to_emit.map do |item|
+        img = item.frontmatter['image']
+        next nil unless img
+        url = img.to_s.start_with?('http') ? img :
+              img.to_s.start_with?('/') ? "#{site_url}#{img}" :
+              "#{site_url}#{bundle_asset_url_for(item, img)}"
+        { "@type" => "ImageObject", "contentUrl" => url, "name" => item.title.to_s }
+      end.compact
+    else
+      jsonld["mainEntity"] = {
+        "@type"           => "ItemList",
+        "numberOfItems"   => items.size,
+        "itemListElement" => list_items
+      }
+    end
+  end
+%>
+<script type="application/ld+json"><%== script_safe_json(jsonld.compact) %></script>
+<% end %>

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

@@ -0,0 +1,42 @@
+<!--
+  Spam-resistant contact button. Reads `contact:` from config/site.yml.
+
+  Anti-harvest technique:
+    - The email is split at the `@` into `data-user` and `data-domain`
+      attributes; the rendered HTML never contains a single string with `@`
+      in it, so naive scrapers can't reconstruct the address.
+    - There's no `mailto:` prefix in the HTML and no JS-readable string
+      that combines both halves until the user clicks.
+    - On click, contact-button.js joins the halves and opens mailto:.
+    - Without JS, the button does nothing — graceful degradation; the
+      partial intentionally does NOT fall back to a plain mailto:.
+
+  Renders nothing when the config block is missing or `enabled: false`.
+  Place anywhere by calling `<%%= render 'partials/contact_button' %%>`
+  from any layout. Already wired into the default about layout.
+
+  Default styling: `.btn .btn-outline-secondary` from _common.css.
+  Override with `css_class:` to swap the variant — e.g.
+      <%%= render 'partials/contact_button', css_class: 'btn btn-success' %%>
+      <%%= render 'partials/contact_button', css_class: 'btn btn-primary rounded-pill' %%>
+-->
+<%
+  cfg = site.config['contact'] || {}
+  email = cfg['email'].to_s
+  enabled = cfg.fetch('enabled', !email.empty?)
+%>
+<% if enabled && email.include?('@') %>
+  <% user, domain = email.split('@', 2) %>
+  <% label = cfg['label'] || 'Contact' %>
+  <% subject = cfg['subject'] %>
+  <% button_class = defined?(css_class) ? css_class.to_s : 'btn btn-outline-secondary' %>
+  <p class="contact-button-wrapper">
+    <button type="button" class="<%= button_class %>"
+            data-user="<%= user %>"
+            data-domain="<%= domain %>"
+            <%= subject ? %(data-subject="#{h(subject)}") : '' %>>
+      <%= label %>
+    </button>
+  </p>
+  <script src="<%= asset_path('js/contact-button.js') %>" defer></script>
+<% end %>

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

@@ -0,0 +1,95 @@
+<!--
+  Schema.org Course + CourseInstance JSON-LD for the workshops
+  collection. Workshops are simultaneously Events AND Courses —
+  emitting both lets the same page win rich results in either
+  surface (event carousel OR course directory). Google rolled out
+  the Course rich result in 2023; it's now well-supported.
+
+  Reads the same workshop frontmatter as `_event_jsonld`:
+    title, description, date_from, date_to, duration, location,
+    format, instructors, price, registration_url, image.
+
+  Renders nothing when frontmatter has no `date_from` AND no
+  `duration` — without either, the page isn't a real course offering.
+
+  Wire from `workshop.html.erb`:
+      <%%= render 'partials/course_jsonld' %>
+-->
+<%
+  fm = page.frontmatter
+%>
+<% if fm['date_from'] || fm['duration'] %>
+<%
+  site_url   = site.config['url'].to_s.sub(%r{/\z}, '')
+  page_url   = site_url.empty? ? page.url : "#{site_url}#{page.url}"
+
+  course = {
+    "@context"  => "https://schema.org",
+    "@type"     => "Course",
+    "name"      => page.title,
+    "provider"  => { "@type" => "Organization", "name" => site.config['title'], "sameAs" => "#{site_url}/" }.compact
+  }
+  course["description"] = fm['description'] if fm['description']
+  course["url"]         = page_url
+
+  if (img = fm['image'])
+    resolved = if img.to_s.start_with?('http://', 'https://')
+                 img
+               elsif img.to_s.start_with?('/')
+                 "#{site_url}#{img}"
+               else
+                 "#{site_url}#{bundle_asset_url_for(page, img)}"
+               end
+    course["image"] = resolved
+  end
+
+  fmt = fm['format'].to_s.downcase
+  course_mode = case
+                when fmt.include?('hybrid')                                then 'Blended'
+                when %w[remote online virtual].any? { |k| fmt.include?(k) } then 'Online'
+                else                                                            'Onsite'
+                end
+
+  instance = { "@type" => "CourseInstance", "courseMode" => course_mode }
+  if fm['date_from']
+    start_iso = to_time(fm['date_from']).iso8601
+    instance["startDate"] = start_iso
+    instance["endDate"]   = to_time(fm['date_to']).iso8601 if fm['date_to']
+  elsif fm['duration']
+    instance["courseWorkload"] = fm['duration'].to_s
+  end
+  instance["location"] = { "@type" => "Place", "name" => fm['location'].to_s } if fm['location']
+  instructors = Array(fm['instructors']).reject { |i| i.to_s.strip.empty? }
+  if instructors.any?
+    instance["instructor"] = instructors.map { |n| { "@type" => "Person", "name" => n.to_s } }
+  end
+
+  # Google's Course rich-result requirement: at least one
+  # `hasCourseInstance`. The instance carries dates / mode / location;
+  # the parent Course carries the title / description / provider.
+  course["hasCourseInstance"] = instance
+
+  # Offers — same parsing path as the Event partial.
+  if (price_str = fm['price']) && fm['registration_url']
+    digits = price_str.to_s.gsub(/[^\d.]/, '')
+    if !digits.empty?
+      currency = case price_str.to_s
+                 when /\A\$/                 then 'USD'
+                 when /\A£/                  then 'GBP'
+                 when /\A€/                  then 'EUR'
+                 when /\A¥/                  then 'JPY'
+                 when /\AS\$/, /SGD/         then 'SGD'
+                 else                             'USD'
+                 end
+      course["offers"] = {
+        "@type"         => "Offer",
+        "category"      => "Paid",
+        "price"         => digits,
+        "priceCurrency" => currency,
+        "url"           => fm['registration_url']
+      }
+    end
+  end
+%>
+<script type="application/ld+json"><%== script_safe_json(course.compact) %></script>
+<% end %>

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

@@ -0,0 +1,20 @@
+<!--
+  Draft notice. Renders only on pages where `page.draft?` is true (i.e.
+  front matter has `published: false`). The banner is for the author's
+  benefit during preview — production builds exclude drafts entirely
+  (unless `ABQARI_INCLUDE_DRAFTS=true` is set), so this only ever appears
+  in development.
+
+  The visual styling lives in each theme's `css/app.css` under `.draft-banner`.
+  `role="note"` + `aria-label` give screen-reader users the same context
+  sighted users get from the colour.
+-->
+<% if page.respond_to?(:draft?) && page.draft? %>
+<aside class="draft-banner" role="note" aria-label="Draft notice">
+  <p>
+    <strong>Draft</strong> — this post is hidden from production builds.
+    To publish it, change <code>published: false</code> to <code>published: true</code>
+    in the front matter at the top of this file.
+  </p>
+</aside>
+<% end %>

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

@@ -0,0 +1,122 @@
+<!--
+  Schema.org Event JSON-LD. Designed for the workshops collection
+  (or any layout that surfaces a dated event). Reads the same
+  frontmatter the workshops index + show view use:
+
+      layout: workshop
+      title: Crisis Response Foundations
+      description: A two-day workshop on …
+      date_from: 2026-06-15
+      date_to:   2026-06-16
+      duration:  2 days            # fallback when no specific dates
+      location:  Singapore         # city / country / "Remote"
+      format:    In-person         # In-person / Remote / Hybrid
+      instructors:
+        - Ada Lovelace
+      price:     $1,495
+      registration_url: https://...
+      image:     hero.svg
+
+  Then in the layout: <%%= render 'partials/event_jsonld' %>
+
+  Renders nothing when `date_from` is missing — the schema requires
+  a `startDate`, and dateless evergreen workshops aren't real events
+  in Google's eyes. Safe to render unconditionally; the partial guards.
+-->
+<%
+  fm = page.frontmatter
+  date_from = fm['date_from']
+%>
+<% if date_from %>
+<%
+  start_iso = to_time(date_from).iso8601
+  end_iso   = fm['date_to'] ? to_time(fm['date_to']).iso8601 : nil
+
+  jsonld = {
+    "@context"  => "https://schema.org",
+    "@type"     => "Event",
+    "name"      => page.title,
+    "startDate" => start_iso
+  }
+  jsonld["endDate"]     = end_iso          if end_iso
+  jsonld["description"] = fm['description'] if fm['description']
+
+  if site.config['url']
+    jsonld["url"] = "#{site.config['url'].sub(%r{/\z}, '')}#{page.url}"
+  end
+
+  # Image — workshops use bundled `image:` (relative) or absolute paths.
+  if (img = fm['image'])
+    resolved = if img.to_s.start_with?('http://', 'https://')
+                 img
+               elsif img.to_s.start_with?('/')
+                 "#{site.config['url'].to_s.sub(%r{/\z}, '')}#{img}"
+               else
+                 "#{site.config['url'].to_s.sub(%r{/\z}, '')}#{bundle_asset_url_for(page, img)}"
+               end
+    jsonld["image"] = resolved
+  end
+
+  # Location — workshops use a simple string. We model it as a Place
+  # with the string as the locality. Pure-online workshops (format:
+  # Remote / Online) get a VirtualLocation instead, with the URL
+  # pointing at the registration link (Google's recommended pattern).
+  fmt = fm['format'].to_s.downcase
+  if (loc = fm['location'])
+    jsonld["location"] = if %w[remote online virtual].any? { |k| fmt.include?(k) }
+                          { "@type" => "VirtualLocation",
+                            "url"   => fm['registration_url'] }.compact
+                        else
+                          { "@type"   => "Place",
+                            "name"    => loc.to_s,
+                            "address" => { "@type"           => "PostalAddress",
+                                           "addressLocality" => loc.to_s } }
+                        end
+  elsif %w[remote online virtual].any? { |k| fmt.include?(k) }
+    jsonld["location"] = { "@type" => "VirtualLocation",
+                           "url"   => fm['registration_url'] }.compact
+  end
+
+  # Event attendance mode — required by Google for events since 2020.
+  jsonld["eventAttendanceMode"] = if fmt.include?('hybrid')
+                                    'https://schema.org/MixedEventAttendanceMode'
+                                  elsif %w[remote online virtual].any? { |k| fmt.include?(k) }
+                                    'https://schema.org/OnlineEventAttendanceMode'
+                                  else
+                                    'https://schema.org/OfflineEventAttendanceMode'
+                                  end
+  jsonld["eventStatus"] = 'https://schema.org/EventScheduled'
+
+  # Offers — workshop prices are display strings like "$1,495". Parse
+  # leading currency symbol + digits, fall back to skipping the offer.
+  if (price_str = fm['price']) && fm['registration_url']
+    digits = price_str.to_s.gsub(/[^\d.]/, '')
+    if !digits.empty?
+      currency = case price_str.to_s
+                 when /\A\$/                              then 'USD'
+                 when /\A£/                               then 'GBP'
+                 when /\A€/                               then 'EUR'
+                 when /\A¥/                               then 'JPY'
+                 when /\AS\$/, /SGD/                      then 'SGD'
+                 else                                          'USD'
+                 end
+      jsonld["offers"] = {
+        "@type"         => "Offer",
+        "price"         => digits,
+        "priceCurrency" => currency,
+        "url"           => fm['registration_url'],
+        "availability"  => 'https://schema.org/InStock'
+      }
+    end
+  end
+
+  # Performers — workshop instructors. Each rendered as a Person.
+  instructors = Array(fm['instructors']).reject { |i| i.to_s.strip.empty? }
+  if instructors.any?
+    jsonld["performer"] = instructors.map { |name| { "@type" => "Person", "name" => name.to_s } }
+  end
+
+  jsonld["organizer"] = { "@type" => "Person", "name" => site.config['author'] } if site.config['author']
+%>
+<script type="application/ld+json"><%== script_safe_json(jsonld.compact) %></script>
+<% end %>

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

@@ -0,0 +1,88 @@
+<%#
+  Site footer. Site#footer_links resolves the same three-layer cascade as nav:
+
+    1. data/footer.yml `links:` array — explicit, used as-is.
+    2. Pages with `footer: { order: N, label: "…" }` in front matter, sorted.
+    3. Empty → no footer-link row.
+
+  Site#social_links emits one icon per `social:` entry in config/site.yml,
+  resolved against app/icons/<key>.svg.
+
+  Signature line ("Built with Abqari · 2026" by default):
+    footer:
+      signature: false                   # hide entirely
+      signature: "© 2026 Acme"           # custom text
+      signature: "© {year} Acme"         # `{year}` substitutes the
+                                         #   current year at build time
+      # (unset)                          # default "Built with Abqari · <year>"
+
+  Copyright — off by default. When enabled, REPLACES the year portion
+  of the default signature, so "Built with Abqari · <year>" becomes
+  "Built with Abqari · © <year> <author>". Has no effect when the
+  signature is set to a custom string (you're being explicit) or to
+  false (no signature line to extend):
+    footer:
+      copyright: false                   # default — signature stays "· <year>"
+      copyright: true                    # signature becomes
+                                         #   "Built with Abqari · © <year> <site.author>"
+      copyright: "© {year} Acme Ltd."    # custom text in the same slot
+
+  Layout:
+    [footer-links row, when present]
+    [signature on the left] -------- [social icons on the right]
+%>
+<%
+  # Resolve the copyright slot first — it feeds into the default
+  # signature below. Three states:
+  #   false / nil → nil (signature uses bare year)
+  #   true        → "© <year> <site.author>"
+  #   string      → custom text with `{year}` substitution
+  current_year  = local_time(Time.now, format: '%Y')
+  copyright_cfg = site.config.dig('footer', 'copyright')
+  copyright = case copyright_cfg
+              when true       then "© #{current_year} #{site.config['author']}".strip
+              when false, nil then nil
+              else                 copyright_cfg.to_s.gsub('{year}', current_year)
+              end
+
+  # Resolve the signature line. Three states match `nav.brand`:
+  #   false  → omit the line
+  #   string → use as-is (with `{year}` substitution)
+  #   nil    → default "Built with Abqari · <year-or-copyright>"
+  signature_cfg = site.config.dig('footer', 'signature')
+  default_tail  = copyright || current_year
+  signature = case signature_cfg
+              when false then nil
+              when nil   then "Built with Abqari · #{default_tail}"
+              else            signature_cfg.to_s.gsub('{year}', current_year)
+              end
+%>
+<footer>
+  <%# `<footer>` stays full-width so a top border / background extends
+      edge-to-edge; the inner `.container` is what gets centred at the
+      responsive content width (matching the header and main). %>
+  <div class="container">
+    <% footer_links = site.footer_links %>
+    <% if footer_links.any? %>
+    <p class="footer-links">
+      <% footer_links.each_with_index do |link, i| %>
+        <%= ' · ' if i.positive? %><%== link_to link['label'], link['url'] %>
+      <% end %>
+    </p>
+    <% end %>
+
+    <div class="footer-bar">
+      <% if signature %>
+      <p class="footer-meta"><%= signature %></p>
+      <% end %>
+      <% socials = site.social_links %>
+      <% if socials.any? %>
+      <p class="footer-social">
+        <% socials.each do |entry| %>
+          <a href="<%= entry['url'] %>" aria-label="<%= entry['label'] %>" rel="me"><%== icon entry['icon'], width: '20', height: '20' %></a>
+        <% end %>
+      </p>
+      <% end %>
+    </div>
+  </div>
+</footer>

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

@@ -0,0 +1,25 @@
+<!--
+  Scheduled-post notice. Renders only on posts where `page.future?` is
+  true (the post's date is later than `Time.now`). Like the draft banner,
+  this only appears in development — production builds exclude future
+  posts entirely unless ABQARI_INCLUDE_FUTURE=true is set.
+
+  Why a banner: future-dated posts can sit in your repo for weeks. A
+  visible reminder ("scheduled for…") prevents the surprise of "why is
+  this post not appearing on prod yet?" — the answer is on the page.
+
+  The displayed time always includes the timezone (`Z`/abbreviation)
+  so the author sees Abqari's interpretation of their date string and
+  can tell whether they wrote it in UTC, local, or with an explicit
+  offset.
+-->
+<% if page.respond_to?(:future?) && page.future? && page.respond_to?(:date) && page.date %>
+<aside class="future-banner" role="note" aria-label="Scheduled post notice">
+  <p>
+    <strong>Scheduled</strong> — this post will publish at
+    <time datetime="<%= page.date.iso8601 %>"><%= page.date.strftime('%B %-d, %Y at %H:%M %Z') %></time>
+    (<%= time_until(page.date) %>).
+    Production builds skip future-dated posts; this preview only shows in development.
+  </p>
+</aside>
+<% end %>