pandorga 1.7.3 → 1.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5c04a8266084060b4aa4810ef57d5d9c25a29302ebd8d946183ba2b95a2daeb
-  data.tar.gz: b0aceffe59d1febefc9a308db429f7da42856463b1b7143bdb23f125729de192
+  metadata.gz: 50cefbd5818ff3cacd667823f637d8dd3aca3a0dd06fb78a01f44d68954b8a28
+  data.tar.gz: a602af73319ba4acc679ffdc30d75b555663dfb0ce54febf32823ce8e213cc03
 SHA512:
-  metadata.gz: 22939efa0329adbf9cc11e0ba771a9fd11d0e154777df7918a1a7bbf821295f3592f4ca1233e43448578deb8a9c69955696f3df282c9f435389e371c69815c1d
-  data.tar.gz: 70590f4574d43b101ce9e4148d53df33fc1f6f6e2225df5368d0b11a636d425b1300a10d150038c8d2494e004aaa78f7efd495d56a5cadadee1f671f6ae58158
+  metadata.gz: 97f05ec16f99648f22c74146bb9f8ce497e3afa759727b8cc5d09f50dcdceee955e3c993e1ada003cd1492a5cd0c9975dbfa9d05bd56668aaf97eec945236425
+  data.tar.gz: a6a9494a944b8807f594e1f3c1dd6bc8337aade5ba8c53a7b29e3a905575d39f6b5fd310ad99ac00d7d017d44b182e1d78db85e52c218057d430848455d0135f

data/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## [1.7.5] — 2026-10-12
+
+### Fixed
+
+- A display equation scrolls inside the article column. On a 390px
+  viewport a MathJax display box about 455px wide was stretching the
+  document to a scrollWidth of 667, so the page moved sideways and the
+  sticky header scrolled with it. `mjx-container[display="true"]` and
+  `mjx-container[jax][display="true"]` are `max-width: 100%` with
+  `overflow-x: auto` and `overflow-y: hidden`. Tables, figures, and
+  article SVG are bounded to the column. Mermaid still scrolls inside
+  `.mermaid`. `html` and `body` do not set overflow, so the sticky
+  header still sticks.
+- A detail URL served by the listing shell had two `h1` elements: the
+  listing title (Articles, Rascunhos, Projects, Curriculum) and the
+  entry title. While the entry is showing, the listing heading is not
+  an `h1`. The document title is the entry title, and `html` `lang`
+  follows the entry (`en`, `pt-BR`, `fr`, `es`). Articles, posts,
+  projects, and products.
+
+No `pandorga:` config keys were added or renamed. Font roles and the
+ledger fallbacks are unchanged.
+
+## [1.7.4] — 2026-10-12
+
+### Fixed
+
+- The footer imprint separator uses `outline` on the panel step.
+  `outline-variant` on that panel is 1.80:1 in light (`#b8b8b8` on
+  `#f4f4f4`) and 1.93:1 in dark (`#45454c` on `#141418`). `outline`
+  on the same panels is 6.08:1 and 5.95:1.
+
+### Changed
+
+- Unused selectors are gone. `assets/css/ledger/home.css` drops
+  `.home-hero-pandorga-svg` (25 bytes). The hero SVG uses
+  `home-hero-art-svg`. `assets/css/ledger/detail.css` drops 916 bytes:
+  the author byline suppressor and the `.table-csv` companions. No
+  template or runtime emits either class. 941 bytes in all.
+- The one-shot key backfill is gone (`scripts/content/backfill-content-keys.rb`,
+  3,432 bytes). Nothing called it.
+- The watch-path test that read `docs/ops/cloudflare.md` is gone
+  (1,230 bytes). That path is not in the tree.
+- Deploy notes pin `~> 1.3` and tag `v1.7.4`. The Pages watch paths
+  include `*` and exclude `content/*` and `docs/*`.
+
+No `pandorga:` config keys were added or renamed. Font roles and the
+ledger fallbacks are unchanged.
+
 ## [1.7.3] — 2026-10-12
 
 ### Fixed

data/_includes/content-runtime/50-detail.html

@@ -526,11 +526,71 @@
       el.setAttribute('href', url);
     }
 
+    /* The listing shell is one document for the index and every detail URL.
+       The static h1 is the index title ("Articles"). The runtime then paints
+       the entry title as a second h1. Demote the index heading while a detail
+       is showing so the document has one h1, and put it back for the index. */
+    var listingDocumentSnapshot = null;
+
+    function rememberListingDocument() {
+      if (listingDocumentSnapshot) return;
+      listingDocumentSnapshot = {
+        title: document.title,
+        lang: document.documentElement.getAttribute('lang') || ''
+      };
+    }
+
+    function concealListingHeader() {
+      var header = document.querySelector('[data-content-page-header]');
+      if (!header) return;
+      header.setAttribute('hidden', '');
+      var heading = header.querySelector('h1');
+      if (!heading) return;
+      var replacement = document.createElement('p');
+      replacement.className = heading.className;
+      replacement.setAttribute('data-listing-heading', 'demoted');
+      while (heading.firstChild) replacement.appendChild(heading.firstChild);
+      heading.replaceWith(replacement);
+    }
+
+    function restoreListingDocument() {
+      var header = document.querySelector('[data-content-page-header]');
+      if (header) {
+        header.removeAttribute('hidden');
+        var demoted = header.querySelector('[data-listing-heading="demoted"]');
+        if (demoted) {
+          var heading = document.createElement('h1');
+          heading.className = demoted.className;
+          while (demoted.firstChild) heading.appendChild(demoted.firstChild);
+          demoted.replaceWith(heading);
+        }
+      }
+      if (!listingDocumentSnapshot) return;
+      document.title = listingDocumentSnapshot.title;
+      document.documentElement.lang = listingDocumentSnapshot.lang;
+      listingDocumentSnapshot = null;
+    }
+
+    /* Site codes (enus, ptbr, en_us, pt_br) are not BCP-47. The html lang
+       attribute has to be. */
+    function htmlLangFromContent(language) {
+      var compact = String(language || '').trim().toLowerCase().replace(/[_-]/g, '');
+      if (!compact) return '';
+      var primary = compact.slice(0, 2);
+      if (primary === 'en') return 'en';
+      if (primary === 'pt') return 'pt-BR';
+      if (primary === 'fr') return 'fr';
+      if (primary === 'es') return 'es';
+      return '';
+    }
+
     function applyDocumentMeta(meta) {
       meta = meta || {};
       var siteSuffix = (window.ContentRuntimeConfig && window.ContentRuntimeConfig.siteSuffix) || '';
       var title = meta.title ? String(meta.title) + siteSuffix : document.title;
       document.title = title;
+      var htmlLang = htmlLangFromContent(meta.lang);
+      if (htmlLang) document.documentElement.lang = htmlLang;
       if (meta.description) setMetaTag('description', meta.description);
       setMetaTag('og:title', title, 'property');
       if (meta.description) setMetaTag('og:description', meta.description, 'property');
@@ -736,12 +796,15 @@
 
     async function renderRuntimeDetailSection(options) {
       var fm = options.frontMatter || {};
+      rememberListingDocument();
+      concealListingHeader();
       if (options.documentMeta !== false) {
         applyDocumentMeta({
           title: fm.title,
           description: fm.description,
           url: window.location.pathname,
-          image: fm.og_image || fm.thumbnail
+          image: fm.og_image || fm.thumbnail,
+          lang: fm.language || ((fm.layout === 'post' || options.detailAttribute === 'data-dynamic-post-detail') ? 'ptbr' : '')
         });
       }
       var section = document.createElement('section');

data/_includes/content-runtime/60-fragments.html

@@ -385,7 +385,7 @@
     }
 
     /* The home page's reference band opens each panel with a plate drawn from
-     * that section's own content by the export (docs/features/home-band-art.md).
+     * that section's own content by the export (docs/deploy/cloudflare.md).
      * The markup arrives as an SVG document and is injected inline, never as an
      * <img>: every stroke and fill in it is a custom property, and an external
      * document cannot see the palette the page is currently wearing.

data/_includes/content-runtime/90-bootstrap.html

@@ -39,6 +39,7 @@
       insertRuntimeBackLink: insertRuntimeBackLink,
       removeRuntimeBackLink: removeRuntimeBackLink,
       renderRuntimeDetailSection: renderRuntimeDetailSection,
+      restoreListingDocument: restoreListingDocument,
       reportDetailLoadError: reportDetailLoadError,
       buildDetailActions: buildDetailActions,
       buildTextSidebar: buildTextSidebar,

data/_layouts/articles.html

@@ -434,6 +434,7 @@ layout: shell
       if (detailSidebar) detailSidebar.innerHTML = '';
       runtime.removeRuntimeBackLink();
       runtime.removeArticleToc();
+      runtime.restoreListingDocument();
     }
 
     async function renderArticleDetail(article, articles) {

data/_layouts/blog.html

@@ -425,6 +425,7 @@ layout: shell
       if (detailSidebar) detailSidebar.innerHTML = '';
       runtime.removeRuntimeBackLink();
       runtime.removeArticleToc();
+      runtime.restoreListingDocument();
     }
 
     async function renderPostDetail(post, posts) {

data/_layouts/cv.html

@@ -280,6 +280,7 @@ layout: shell
             if (detailMain) detailMain.innerHTML = '';
             if (detailSidebar) detailSidebar.innerHTML = '';
             runtime.removeRuntimeBackLink();
+            runtime.restoreListingDocument();
         }
 
         async function renderProductDetail(item) {

data/_layouts/projects.html

@@ -354,6 +354,7 @@ layout: shell
       if (detailHero) detailHero.innerHTML = '';
       runtime.removeArticleToc();
       runtime.removeRuntimeBackLink();
+      runtime.restoreListingDocument();
     }
 
     function renderListing(projects) {

data/assets/css/article.css

@@ -112,44 +112,58 @@
    which outranks `.article-content mjx-container[display="true"]` on
    specificity. The 0.5rem this file asked for was never what the page drew.
 
-   So the wrapper owns the gap, the scroll and the padding; the container
-   inside it owns none of them. */
+   The wrapper owns the paragraph gap. The container owns the scroll. */
 .article-content .math-display {
   display: block;
+  max-width: 100%;
   /* The bottom gap is the paragraph gap `.article-content p` sets in
      ledger/detail.css; the top gap is left to the previous block, exactly as
      it is between two paragraphs. The negative top margin hands back the
-     padding below, which a margin collapse cannot absorb — the two are one
-     number, so change them together or the rhythm moves. */
+     container padding below, which a margin collapse cannot absorb. The two
+     are one number, so change them together or the rhythm moves. */
   margin: -1.25rem 0 calc(1.15em - 1.25rem);
-  /* overflow-x lets an over-wide equation scroll sideways. CSS forces
-     overflow-y to auto alongside it, so a bracket, radical or matrix rule that
-     MathJax draws past its own line box gets clipped, or grows a vertical
-     scrollbar it has no use for. The padding is the allowance for that
-     overshoot: 1.25rem clears the worst case on the object-centric article
-     (a 3-row bmatrix, measured at 12px past a 0.5rem allowance). It costs
-     nothing visually, because the margin above gives it straight back. */
-  padding: 1.25rem 0;
+  padding: 0;
   overflow-x: auto;
+  overflow-y: hidden;
   text-align: center;
 }
 
-/* `[jax]` is redundant as a selector — every MathJax container carries it —
-   but it lifts this rule past MathJax's own injected margin, which is the
-   whole point of the rule. */
+/* `[jax]` lifts this rule past MathJax's injected margin
+   (`mjx-container[jax="CHTML"][display="true"]`). The container is the clip
+   edge: on a 390px phone a display `mjx-math` about 455px wide was stretching
+   the document to a scrollWidth of 667, because this rule was
+   `overflow: visible`. The page then scrolled sideways and the sticky header
+   moved with it. `max-width: 100%` plus `overflow-x: auto` and
+   `overflow-y: hidden` scroll the equation inside the column, the way `pre`
+   already scrolls code. `overflow-y: hidden` is stated so a radical does not
+   grow a vertical scrollbar, and so a specified `visible` cannot let the
+   equation's min-content widen the column. The 1.25rem padding is the
+   allowance for a bracket, radical, or matrix rule MathJax draws past its
+   line box (a 3-row bmatrix, measured at 12px past a 0.5rem allowance).
+   Do not move this overflow onto `html` or `body`. That scrollport breaks
+   `position: sticky` on the header. */
 .article-content .math-display mjx-container[jax][display="true"] {
+  display: block;
   margin: 0;
-  padding: 0;
-  overflow: visible;
+  padding: 1.25rem 0;
+  max-width: 100%;
+  overflow-x: auto;
+  overflow-y: hidden;
+  text-align: center;
 }
 
 /* Display math the wrapper regex cannot reach, because the `$$` sits inside a
    list item or a table cell rather than alone in a paragraph. It still has to
    break the line; its vertical margin stays MathJax's own 1em, which lands
-   within a pixel of the paragraph gap. */
-.article-content mjx-container[display="true"] {
+   within a pixel of the paragraph gap. `[jax]` names the same box. Every
+   MathJax container carries it, and the attribute keeps this rule ahead of
+   the injected stylesheet. */
+.article-content mjx-container[display="true"],
+.article-content mjx-container[jax][display="true"] {
   display: block;
+  max-width: 100%;
   overflow-x: auto;
+  overflow-y: hidden;
   text-align: center;
 }
 
@@ -248,7 +262,9 @@
 :is(.article-content, .article-cite-block) pre {
   background: var(--color-surface-container);
   padding: 1rem;
+  max-width: 100%;
   overflow-x: auto;
+  overflow-y: hidden;
   margin-bottom: 1rem;
   font-family: var(--font-code);
 }
@@ -359,11 +375,30 @@
   margin: 1.5rem auto;
   text-align: center;
   width: 100%;
+  max-width: 100%;
   display: block;
   background: var(--color-surface-container-low);
   padding: var(--space-md);
 }
 
+/* A wide SVG, video, or iframe must stay inside the plate. Cut-in plates
+   and YouTube shorts set a narrower max-width on a more specific rule.
+   Mermaid and display-math SVG opt back out below so those boxes scroll
+   instead of shrinking the drawing. Iframes keep their own height: `height:
+   auto` collapses a YouTube or Plotly frame that has no intrinsic ratio. */
+.article-content figure svg,
+.article-content svg {
+  max-width: 100%;
+  height: auto;
+}
+
+.article-content figure video,
+.article-content figure iframe,
+.article-content figure canvas,
+.article-content iframe {
+  max-width: 100%;
+}
+
 .article-content figure img {
   margin-inline: auto;
 }
@@ -554,7 +589,9 @@ body.figure-lightbox-open {
   padding: var(--space-xl) var(--space-lg);
   background: var(--color-surface-container);
   text-align: center;
+  max-width: 100%;
   overflow-x: auto;
+  overflow-y: hidden;
   -webkit-overflow-scrolling: touch;
 }
 
@@ -567,6 +604,15 @@ body.figure-lightbox-open {
   height: auto;
 }
 
+/* SVG output of a display equation keeps its own width and scrolls inside
+   `mjx-container`. Inline math is not included: `display: block` here would
+   pull an inline equation out of the line. */
+.article-content mjx-container[display="true"] svg {
+  max-width: none;
+  width: auto;
+  height: auto;
+}
+
 /* Captions are sentences. The include centres the whole figure, and a centred
    paragraph of provenance is harder to read than a left-set one; the rule on
    the element itself beats the `text-center` utility the runtime emits. The
@@ -628,6 +674,7 @@ body.figure-lightbox-open {
 /* ── Tables ── */
 .article-content table {
   width: 100%;
+  max-width: 100%;
   border-collapse: collapse;
   margin-bottom: 1.5rem;
   font-size: var(--type-dek);

data/assets/css/ledger/detail.css

@@ -323,6 +323,17 @@ a.back-link .material-symbols-outlined {
 
    Every detail page uses this one rule, including the projects page, which
    only differs in holding the split back to 1024px (ledger/projects.css). */
+/* A grid item's automatic minimum is its widest child. A display equation
+   used to be that child, so the column grew past the viewport, the document
+   scrolled sideways, and the sticky header scrolled with it. The track is
+   already allowed to shrink (`minmax(0, 1fr)` from 768px, and `grid-cols-1`
+   below that). The item has to be allowed to shrink with it. Wide children
+   scroll inside their own boxes; this does not put overflow on `html` or
+   `body`. */
+.grid.text-detail-grid > * {
+  min-width: 0;
+}
+
 @media (min-width: 768px) {
   .grid.text-detail-grid {
     --detail-column-gap: 2rem;
@@ -485,11 +496,9 @@ aside:has(> .text-detail-sidebar) {
   font-variant-numeric: tabular-nums;
 }
 
-/* Projects and products can carry no meta at all, and on articles and posts
-   the byline below is the block's only child. Either way an all-empty meta
+/* Projects and products can carry no meta at all. An all-empty meta
    block must not hang a stub of padding off the bottom of the panel. */
-.text-detail-sidebar .article-meta:has(> div:empty),
-.text-detail-sidebar .article-meta:has(> div > span.text-secondary:not(.font-bold):only-child) {
+.text-detail-sidebar .article-meta:has(> div:empty) {
   display: none;
 }
 
@@ -497,14 +506,6 @@ aside:has(> .text-detail-sidebar) {
   gap: var(--space-sm);
 }
 
-/* Author byline. Dropped: single-author site. The runtime still emits it, so
-   it is suppressed here until `buildTextSidebar` stops rendering it — see the
-   runtime-change note in this branch's commit message. The product/company
-   line is the same colour but carries `font-bold`, hence the :not(). */
-.text-detail-sidebar .article-meta>div>span.text-secondary:not(.font-bold) {
-  display: none;
-}
-
 .text-detail-sidebar .article-meta .text-tertiary,
 .text-detail-sidebar .article-meta span.font-bold {
   font-family: var(--font-label);
@@ -861,8 +862,7 @@ aside:has(> .text-detail-sidebar) {
    header, and figures that line up. */
 /* No table surface: the header band and the hover row are the only fills, so
    both read against the page canvas in either palette. */
-.article-content table,
-.article-content .table-csv {
+.article-content table {
   margin: var(--space-xl) 0;
   font-size: var(--type-dek);
   font-variant-numeric: tabular-nums;
@@ -870,9 +870,7 @@ aside:has(> .text-detail-sidebar) {
 }
 
 .article-content th,
-.article-content td,
-.article-content .table-csv th,
-.article-content .table-csv td {
+.article-content td {
   border: 0;
   border-bottom: 1px solid var(--border-gentle-subtle);
   padding: var(--space-sm) var(--space-md);
@@ -899,8 +897,7 @@ aside:has(> .text-detail-sidebar) {
   font-variant-numeric: tabular-nums;
 }
 
-.article-content thead th,
-.article-content .table-csv thead th {
+.article-content thead th {
   background: var(--color-surface-container);
   font-family: var(--font-body);
   font-size: var(--type-body);
@@ -910,13 +907,11 @@ aside:has(> .text-detail-sidebar) {
 }
 
 /* Zebra striping fights the row rules; the hover row is the reading aid. */
-.article-content tbody tr:nth-child(even),
-.article-content .table-csv tbody tr:nth-child(even) td {
+.article-content tbody tr:nth-child(even) {
   background: transparent;
 }
 
-.article-content tbody tr:hover,
-.article-content .table-csv tbody tr:hover {
+.article-content tbody tr:hover {
   background: var(--color-surface-container-low);
 }
 
@@ -1131,18 +1126,16 @@ nav.text-page-nav:not(:has(a)) {
      too wide then scrolls inside the table rather than moving the page. The
      runtime emits the table with no wrapper, so the table itself has to be the
      scroll container. */
-  .article-content table,
-  .article-content .table-csv {
+  .article-content table {
     display: block;
     width: 100%;
     max-width: 100%;
     overflow-x: auto;
+    overflow-y: hidden;
   }
 
   .article-content th,
-  .article-content td,
-  .article-content .table-csv th,
-  .article-content .table-csv td {
+  .article-content td {
     padding: var(--space-xs) var(--space-sm);
   }
 }

data/assets/css/ledger/footer.css

@@ -230,11 +230,14 @@
 }
 
 /* A middot between items rather than a separator element, so an absent
-   license leaves no orphaned punctuation behind. */
+   license leaves no orphaned punctuation behind. outline-variant is the
+   hairline token: #b8b8b8 on #f4f4f4 is 1.80:1, and #45454c on #141418
+   is 1.93:1. outline clears 4.5:1 on the same panel (6.08:1 light,
+   5.95:1 dark). */
 .site-footer-imprint-item+.site-footer-imprint-item::before {
   content: "·";
   margin-right: var(--space-md);
-  color: var(--color-outline-variant);
+  color: var(--color-outline);
 }
 
 .site-footer-imprint-link {

data/assets/css/ledger/home.css

@@ -91,8 +91,7 @@
   opacity: 0.42;
 }
 
-.home-hero-art-svg,
-.home-hero-pandorga-svg {
+.home-hero-art-svg {
   width: 100%;
   height: 100%;
   display: block;

data/lib/pandorga/commands/new.rb

@@ -24,7 +24,7 @@ module Pandorga
 
         gem "pandorga", "~> 1.3"
         # Local checkout: gem "pandorga", path: "../pandorga"
-        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.5.0"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.7.5"
         gem "csv"
         gem "base64"
       RUBY

data/lib/pandorga/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pandorga
-  VERSION = "1.7.3"
+  VERSION = "1.7.5"
 end

data/scripts/content/band_art.rb

@@ -27,7 +27,7 @@
 # because the plates went stale otherwise. Cloudflare Pages excludes `content/*`
 # from its build watch paths, so a Studio save never rebuilds the shell, and art
 # committed into a layout is art that stops counting the day it is written. See
-# docs/features/home-band-art.md.
+# docs/deploy/cloudflare.md.
 #
 # The output is SVG whose every stroke and fill is a custom property, because the
 # site has two complete palettes and switches between them on a `data-theme`

data/scripts/content/export-content-json.rb

@@ -653,7 +653,7 @@ def export_derived_data(content_root, output_root)
 end
 
 # The home page's reference band, drawn from the corpus this run just exported
-# rather than from committed markup. See docs/features/home-band-art.md for why
+# rather than from committed markup. See docs/deploy/cloudflare.md for why
 # it lives here: a Studio save never rebuilds the shell, so art baked into a
 # layout stops counting the day it is written.
 def export_band_art(output_root, writing_index)

data/scripts/test/test-css-structure.rb

@@ -86,7 +86,12 @@ sheets.each do |path|
     home-index-shard--gamma
     home-index-note
     post-content
+    home-hero-pandorga-svg
+    table-csv
   ]
+  if cleaned.include?("span.text-secondary:not(.font-bold)")
+    errors << "#{relative}: author byline suppressor matches no markup"
+  end
   retired.each do |name|
     next unless cleaned.match?(/[.#]#{Regexp.escape(name)}\b/)
 
@@ -94,6 +99,111 @@ sheets.each do |path|
   end
 end
 
+# PLT-AC-36. A display equation scrolls inside the article column. Overflow
+# on html or body would scroll the sticky header off the viewport.
+def declaration_bodies(css, selector)
+  wanted = selector.gsub(/\s+/, " ").strip
+  bodies = []
+  css.scan(/([^{}]+)\{([^{}]*)\}/m) do |sel, body|
+    parts = sel.split(",").map { |part| part.gsub(/\s+/, " ").strip }
+    bodies << body if parts.include?(wanted)
+  end
+  bodies
+end
+
+def declarations(body)
+  body.downcase.gsub(/\s+/, "")
+end
+
+def require_declarations(errors, label, css, selector, required)
+  bodies = declaration_bodies(css, selector)
+  if bodies.empty?
+    errors << "#{label}: missing #{selector}"
+    return
+  end
+
+  blob = bodies.map { |body| declarations(body) }.join(";")
+  required.each do |decl|
+    needle = decl.downcase.gsub(/\s+/, "")
+    next if blob.include?(needle)
+
+    errors << "#{label}: #{selector} missing #{decl}"
+  end
+end
+
+def strip_comments(source)
+  source.gsub(%r{/\*.*?\*/}m, "")
+end
+
+article_sheet = strip_comments(File.read(CSS_ROOT.join("article.css")))
+detail_sheet = strip_comments(File.read(CSS_ROOT.join("ledger/detail.css")))
+math_box = ["max-width: 100%", "overflow-x: auto", "overflow-y: hidden"]
+
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  ".article-content .math-display", math_box
+)
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  '.article-content .math-display mjx-container[jax][display="true"]', math_box
+)
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  '.article-content mjx-container[display="true"]', math_box
+)
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  '.article-content mjx-container[jax][display="true"]', math_box
+)
+
+if article_sheet.match?(/mjx-container[^{]*\{[^}]*overflow\s*:\s*visible/m)
+  errors << "assets/css/article.css: display math sets overflow: visible"
+end
+
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  ".article-content figure", ["max-width: 100%"]
+)
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  ".article-content svg", ["max-width: 100%"]
+)
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  ".article-content .mermaid", math_box
+)
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  ".article-content .mermaid svg", ["max-width: none"]
+)
+require_declarations(
+  errors, "assets/css/article.css", article_sheet,
+  ".article-content table", ["max-width: 100%"]
+)
+require_declarations(
+  errors, "assets/css/ledger/detail.css", detail_sheet,
+  ".article-content table", ["max-width: 100%", "overflow-x: auto", "overflow-y: hidden"]
+)
+require_declarations(
+  errors, "assets/css/ledger/detail.css", detail_sheet,
+  ".grid.text-detail-grid > *", ["min-width: 0"]
+)
+
+sheets.each do |path|
+  relative = Pathname.new(path).relative_path_from(REPO_ROOT)
+  cleaned = strip_noise(File.read(path))
+  cleaned.scan(/([^{}]+)\{([^{}]*)\}/m) do |sel, body|
+    next unless body.match?(/overflow/i)
+
+    sel.split(",").each do |part|
+      name = part.gsub(/\s+/, " ").strip
+      next unless name == "html" || name == "body" || name == "html body"
+
+      errors << "#{relative}: #{name} sets overflow and would break the sticky header"
+    end
+  end
+end
+
 fail!("CSS structure problems:\n  - #{errors.join("\n  - ")}") unless errors.empty?
 
 puts "  #{sheets.size} stylesheet(s) balanced, no conflict markers."

data/scripts/test/test-home-band-art.rb

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-# Home band art (docs/features/home-band-art.md).
+# Home band art. Watch paths: docs/deploy/cloudflare.md.
 #
 # AC-BAND-01 the export writes both plates under data/
 # AC-BAND-03 a second export with no content change reports them unchanged

data/scripts/test/test-new.rb

@@ -32,6 +32,46 @@ if readme.include?("once 1.1 is on RubyGems")
   exit 1
 end
 
+version = ROOT.join("lib/pandorga/version.rb").read[/VERSION = "([^"]+)"/, 1]
+unless version
+  warn "FAIL test-new: Pandorga::VERSION missing"
+  exit 1
+end
+
+deploy = ROOT.join("docs/deploy/cloudflare.md").read
+upgrading = ROOT.join("docs/upgrading.md").read
+scaffold = ROOT.join("lib/pandorga/commands/new.rb").read
+[
+  [deploy, "docs/deploy/cloudflare.md"],
+  [upgrading, "docs/upgrading.md"],
+  [scaffold, "lib/pandorga/commands/new.rb"]
+].each do |text, label|
+  if text.include?("v1.0.0") || text.include?("v1.3.11") || text.include?("v1.5.0")
+    warn "FAIL test-new: #{label} still names a stale release pin"
+    exit 1
+  end
+end
+unless deploy.include?('~> 1.3') && deploy.include?(%(tag: "v#{version}"))
+  warn "FAIL test-new: deploy doc must pin ~> 1.3 and tag v#{version}"
+  exit 1
+end
+unless deploy.include?("content/*") && deploy.include?("docs/*") && deploy.include?("Gemfile.lock")
+  warn "FAIL test-new: deploy doc lost the watch-path include and excludes"
+  exit 1
+end
+unless deploy.include?("3.4.4") && deploy.include?("SKIP_DEPENDENCY_INSTALL")
+  warn "FAIL test-new: deploy doc lost the Pages Ruby pin or SKIP_DEPENDENCY_INSTALL"
+  exit 1
+end
+unless upgrading.include?(%(tag: "v#{version}")) && upgrading.include?("pandorga-#{version}.gem")
+  warn "FAIL test-new: upgrading examples are not v#{version}"
+  exit 1
+end
+unless scaffold.include?(%(tag: "v#{version}"))
+  warn "FAIL test-new: scaffold comment is not tag v#{version}"
+  exit 1
+end
+
 FileUtils.rm_rf(DEST)
 
 stdout, stderr, status = run_new(DEST.to_s)

data/scripts/test/test-r2-config-consistency.rb

@@ -36,7 +36,7 @@ end
 
 if ContentStorageConfig.placeholder?(base)
   puts "SKIP: R2 URL alignment checks (content_api_base_url is still placeholder: #{base})"
-  puts "      Fill the URL per docs/ops/cloudflare.md before production cutover."
+  puts "      Fill the URL per docs/deploy/cloudflare.md before production cutover."
   exit 0
 end
 

data/scripts/test/test-shell-a11y.rb

@@ -54,4 +54,20 @@ ICON_FILES.each do |path|
   end
 end
 
+# PLT-AC-37. The listing shell keeps its index h1 in the document. A detail
+# URL then adds the entry title, so the page has two h1 elements. The runtime
+# demotes the index heading and sets the document title and lang from the entry.
+DETAIL = ROOT.join("_includes/content-runtime/50-detail.html").read
+BOOT = ROOT.join("_includes/content-runtime/90-bootstrap.html").read
+fail!("detail runtime does not demote the listing h1") unless DETAIL.include?("data-listing-heading") && DETAIL.include?("concealListingHeader")
+fail!("detail runtime does not restore the listing document") unless DETAIL.include?("function restoreListingDocument")
+fail!("detail runtime does not set html lang") unless DETAIL.include?("document.documentElement.lang")
+fail!("detail runtime dropped the entry title h1") unless DETAIL.include?('<h1 class="text-title">')
+fail!("restoreListingDocument is not on the runtime") unless BOOT.include?("restoreListingDocument: restoreListingDocument")
+
+%w[articles blog projects cv].each do |layout|
+  source = ROOT.join("_layouts/#{layout}.html").read
+  fail!("#{layout} listing does not restore the document") unless source.include?("restoreListingDocument()")
+end
+
 puts "PASS test-shell-a11y"

data/scripts/test/test-theme-contrast.rb

@@ -40,4 +40,24 @@ fail!("dark tertiary container moved") unless background.casecmp("#6a684f").zero
 ratio = contrast(foreground, background)
 fail!("#{foreground} on #{background} is #{ratio.round(2)}:1") unless ratio >= 4.5
 
-puts "PASS test-theme-contrast (#{foreground} on #{background} = #{ratio.round(2)}:1)"
+# Footer imprint middot. outline-variant is a hairline and fails as ink
+# on the panel step. The separator uses outline, which clears 4.5:1.
+footer = ROOT.join("assets/css/ledger/footer.css").read
+fail!("footer imprint separator still uses outline-variant") if footer.include?("color: var(--color-outline-variant)")
+fail!("footer imprint separator lost outline") unless footer.include?("color: var(--color-outline)")
+
+light = YAML.safe_load(ROOT.join("_data/themes/light.yml").read) || {}
+pairs = {
+  "light" => [light.dig("neutrals", "outline"), light.dig("neutrals", "panel_contrast")],
+  "dark" => [dark.dig("neutrals", "outline"), dark.dig("neutrals", "panel_contrast")]
+}
+reports = []
+pairs.each do |name, (ink, panel)|
+  fail!("#{name} outline or panel missing") if ink.to_s.empty? || panel.to_s.empty?
+
+  pair_ratio = contrast(ink, panel)
+  fail!("#{name} outline #{ink} on panel #{panel} is #{pair_ratio.round(2)}:1") unless pair_ratio >= 4.5
+  reports << "#{name} #{ink} on #{panel} = #{pair_ratio.round(2)}:1"
+end
+
+puts "PASS test-theme-contrast (#{foreground} on #{background} = #{ratio.round(2)}:1; #{reports.join('; ')})"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.7.3
+  version: 1.7.5
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -328,7 +328,6 @@ files:
 - lib/pandorga/version.rb
 - scripts/cdn-allowlist.json
 - scripts/check_home_lists.mjs
-- scripts/content/backfill-content-keys.rb
 - scripts/content/band_art.rb
 - scripts/content/export-content-json.rb
 - scripts/content/flatten-ansi-capture.mjs
@@ -405,7 +404,6 @@ files:
 - scripts/test/render-parity/youtube.json
 - scripts/test/test-absent-field-absent-element.rb
 - scripts/test/test-cdn-pins.rb
-- scripts/test/test-cloudflare-watch-paths-doc.rb
 - scripts/test/test-configuration-doc.rb
 - scripts/test/test-content-backend.rb
 - scripts/test/test-content-detail-urls.rb

data/scripts/content/backfill-content-keys.rb

@@ -1,99 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-require "yaml"
-
-require_relative "../../_plugins/content_keys"
-require_relative "../../_plugins/content_detail_paths"
-require_relative "../../_plugins/git_chronology"
-
-REPO_ROOT = Pathname.new(__dir__).join("..", "..").expand_path
-CONTENT_ROOT = REPO_ROOT.join("content")
-
-KEY_OVERRIDES = {
-  "content/collections/posts/2026-03-06-horse-auto-follow.md" => "horse-auto-follow-pt",
-  "content/collections/posts/2026-03-02-mcmc.md" => "mcmc-pt"
-}.freeze
-
-def split_front_matter(text)
-  ContentKeys.split_front_matter(text)
-end
-
-def write_front_matter(path, front_matter, body)
-  yaml = front_matter.to_yaml.sub(/\A---\n/, "").strip
-  path.write("---\n#{yaml}\n---\n\n#{body}")
-end
-
-def infer_key(entry)
-  override = KEY_OVERRIDES[entry["repo_relative_path"]]
-  return override if override
-
-  key = ContentKeys.normalize_key(entry["key"])
-  return key unless key.empty?
-
-  ContentKeys.infer_key_from_filename(entry["path"], entry["type"])
-end
-
-def legacy_detail_path(type, legacy_segment)
-  case type
-  when "article" then ContentDetailPaths.article_detail_path(legacy_segment)
-  when "post" then ContentDetailPaths.post_detail_path(legacy_segment)
-  when "project" then ContentDetailPaths.project_detail_path(legacy_segment)
-  when "product" then ContentDetailPaths.product_detail_path(legacy_segment)
-  else
-    raise "unknown type #{type}"
-  end
-end
-
-def migrate_redirect_fields!(front_matter)
-  redirects = ContentKeys.normalize_redirects(front_matter)
-  front_matter.delete("redirect_from")
-  front_matter["redirects"] = redirects unless redirects.empty?
-  front_matter
-end
-
-def ensure_legacy_redirect!(front_matter, type, legacy_segment, canonical_path)
-  redirects = ContentKeys.normalize_redirects(front_matter)
-  legacy = legacy_detail_path(type, legacy_segment).chomp("/")
-  canonical = canonical_path.chomp("/")
-  redirects << legacy unless legacy == canonical
-  redirects = redirects.map { |path| ContentKeys.normalize_redirect_path(path) }.compact.uniq
-  front_matter["redirects"] = redirects unless redirects.empty?
-  front_matter.delete("redirects") if redirects.empty?
-  front_matter
-end
-
-updated = 0
-ContentKeys::CONTENT_PATHS.each do |type, relative_dir|
-  directory = CONTENT_ROOT.join(relative_dir.sub(%r{\Acontent/}, ""))
-  next unless directory.directory?
-
-  Dir.glob(directory.join("*.{md,markdown}")).sort.each do |absolute_path|
-    entry = ContentKeys.load_entry(absolute_path, type, repo_root: REPO_ROOT)
-    text = File.read(absolute_path).sub(/\A\xEF\xBB\xBF/, "")
-    front_matter, body = split_front_matter(text)
-    original_yaml = front_matter.to_yaml
-
-    key = infer_key(entry)
-    front_matter["key"] = key
-    migrate_redirect_fields!(front_matter)
-
-    if %w[article post].include?(type)
-      GitChronology.apply!(front_matter, entry["repo_relative_path"], type)
-    end
-
-    canonical = ContentKeys.detail_path(type, key, date: front_matter["date"])
-    ensure_legacy_redirect!(front_matter, type, entry["legacy_segment"], canonical)
-
-    next if front_matter.to_yaml == original_yaml
-
-    write_front_matter(Pathname(absolute_path), front_matter, body.sub(/\A\n+/, ""))
-    updated += 1
-    puts "updated #{entry['repo_relative_path']} (key=#{key})"
-  end
-end
-
-ContentKeys.validate!(REPO_ROOT)
-ContentKeys.sync_redirects_file!(REPO_ROOT)
-puts "Backfill complete (#{updated} file(s) updated). Redirects synced to _redirects."

data/scripts/test/test-cloudflare-watch-paths-doc.rb

@@ -1,31 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-
-ROOT = Pathname.new(__dir__).join("..", "..").expand_path
-DOC = ROOT.join("docs/ops/cloudflare.md")
-
-def check!(condition, message = "condition was false")
-  raise "Assertion failed: #{message}" unless condition
-end
-
-text = DOC.read
-
-puts "Testing Cloudflare watch paths documentation..."
-
-check! text.include?("`*`"), "missing include pattern `*`"
-check! text.include?("`content/*`"), "missing exclude pattern content/*"
-check! text.include?("`docs/*`"), "missing exclude pattern docs/*"
-check! text.include?("Settings → Build → Build watch paths"),
-       "missing dashboard navigation path"
-check! text.include?("SKIP_DEPENDENCY_INSTALL"),
-       "missing SKIP_DEPENDENCY_INSTALL (avoids Pages pip install of study deps)"
-check! text.include?("bundle install") && text.include?("jekyll build"),
-       "missing lean Pages build command with explicit bundle install"
-check! text.include?("pandorga install-functions"),
-       "missing pandorga install-functions in Pages build command (PLT-0.2)"
-check! text.include?("3.4.4"),
-       "missing Pages v3 Ruby 3.4.4 pin (avoids compiling Ruby from source)"
-
-puts "Cloudflare watch paths documentation OK."