pandorga 1.7.0 → 1.7.2

data/assets/css/ledger/cv.css

@@ -347,7 +347,7 @@ html[data-theme="light"] .cv-product {
 
 /* A place is prose, not notation, so it reads in the body face rather than
    mono — and on the same left edge as every other line of the card. The pin
-   icon and the indent it sat beNewsreader said nothing the word "France" does not
+   icon and the indent it sat behind said nothing the word "France" does not
    already say, and cost the entry its one straight margin. */
 .cv-entry-place {
   color: var(--color-on-surface-variant);

data/assets/css/ledger/detail.css

@@ -14,7 +14,7 @@
    to beat one are written with two compound parts on purpose. */
 
 /* ══ Reading progress ══
-   Pure UI state, no field beNewsreader it, and no DOM hook to hang it on — the
+   Pure UI state, no field behind it, and no DOM hook to hang it on — the
    runtime owns the detail markup. A scroll-driven animation on a pseudo of
    the detail section gives the mockup's indicator with zero markup, and the
    @supports guard means older engines simply get no bar.

data/assets/css/ledger/footer.css

@@ -230,7 +230,7 @@
 }
 
 /* A middot between items rather than a separator element, so an absent
-   license leaves no orphaned punctuation beNewsreader. */
+   license leaves no orphaned punctuation behind. */
 .site-footer-imprint-item+.site-footer-imprint-item::before {
   content: "·";
   margin-right: var(--space-md);

data/assets/css/ledger/home.css

@@ -49,18 +49,6 @@
   }
 }
 
-/* Structural edge: the short rule the mockup runs along the top-left of the
-   featured band, marking it as the page's first statement after the hero. */
-.home-band--ruled::before {
-  content: "";
-  position: absolute;
-  top: 0;
-  left: 0;
-  width: 6rem;
-  height: 3px;
-  background: var(--color-primary);
-}
-
 /* ── Hero ── */
 /* The band was 3rem above the name and 4.5rem below, which read as the block
    sitting low in its own space. Equal above and below, at 60% of the larger
@@ -117,7 +105,7 @@
   }
 }
 
-/* Ambient pool beNewsreader the hero.
+/* Ambient pool behind the hero.
  *
  * Same weight as the earlier primary-container bloom, but keyed to neutral
  * ink/outline so it stays grey paper depth instead of a blue spotlight. */
@@ -418,7 +406,7 @@ html[data-theme="light"] .home-hero-plate {
   box-shadow: none;
 }
 
-/* Silk facet beNewsreader the portrait — restored; the Borders pass had hidden it. */
+/* Silk facet behind the portrait — restored; the Borders pass had hidden it. */
 .home-hero-shard {
   top: -2.25rem;
   right: -2rem;
@@ -576,8 +564,7 @@ html[data-theme="light"] .home-hero-plate {
    was the piece the band leads with, and a reader scanning down met four
    equal entries. It now takes the card rung of the surface ladder, is fenced
    by the same hairline every other panel on the site carries, and opens on a
-   rule in the primary — the structural edge this page already uses on
-   `.home-band--ruled` — so the eye stops at the top of it. The image inside is
+   rule in the primary, so the eye stops at the top of it. The image inside is
    inset by the panel's own padding rather than running to the band edge, which
    is the other half of the promotion: the lead contains its picture, the cards
    below are contained by theirs.
@@ -646,7 +633,7 @@ html[data-theme="light"] .home-hero-plate {
    cubist half of the identity.
 
    The pair is placed around the poster rather than across the card, because
-   the poster is opaque and a shard beNewsreader it is a shard nobody sees. The
+   the poster is opaque and a shard behind it is a shard nobody sees. The
    alpha takes the top-left, over the index column, where there is nothing but
    chrome and air. The beta takes the bottom-right and comes out from *under*
    the poster into the strip below it, which is the same move the index band
@@ -1050,8 +1037,8 @@ html[data-theme="light"] .home-hero-plate {
   box-sizing: border-box;
 }
 
-/* The triad top rule (`.ledger-card--edge-primary`), restated at a weight
-   that beats the light-paper hairline reset on `.ledger-system-card`. */
+/* A primary top rule, at a weight that beats the light-paper hairline
+   reset on `.ledger-system-card`. */
 :root .home-projects-bench .home-project-specimen,
 :root .home-projects-bench .home-project-specimen:hover {
   border-top: 2px solid var(--color-primary);
@@ -1568,11 +1555,11 @@ button.home-project-inventory-row {
    The figure is hidden until the markup lands, so a plate that never arrives
    leaves the panel with its title and its link rather than an empty frame. */
 
-/* Ambient pool beNewsreader the pair. Dark palette only, for the reason set out
+/* Ambient pool behind the pair. Dark palette only, for the reason set out
    above the hero's.
  *
- * The two panels sat side by side with a visible seam and nothing beNewsreader
- * them. One pool centred on that seam, beNewsreader both, lights the pair as a
+ * The two panels sat side by side with a visible seam and nothing behind
+ * them. One pool centred on that seam, behind both, lights the pair as a
  * single object rather than giving each panel an opening of its own. Held at
  * 5% against the hero's 7%: at equal strength the page reads as having two
  * openings, and only one of them is where it starts.
@@ -1580,7 +1567,7 @@ button.home-project-inventory-row {
  * Centred is right here and nowhere else — the seam is the thing being lit,
  * so the offset is vertical instead, which is what keeps the pool partly
  * outside the band it backs. `.home-band` already carries `position:
- * relative`; `isolation: isolate` is what stops `z-index: -1` escaping beNewsreader
+ * relative`; `isolation: isolate` is what stops `z-index: -1` escaping behind
  * the page background. */
 .home-band--index {
   isolation: isolate;
@@ -1642,7 +1629,7 @@ button.home-project-inventory-row {
    the set, rotating hue the way every other shard on the site does.
  *
  * They sit in the foot of the panel, under the title and the link: the plate
- * above carries an opaque background, so a shard beNewsreader it would be a shard
+ * above carries an opaque background, so a shard behind it would be a shard
  * nobody sees. `overflow: hidden` on the panel above keeps the negative
  * offsets out of the document scroll width, and the shared utility already
  * unmounts both below 640px. */
@@ -1663,21 +1650,12 @@ button.home-project-inventory-row {
   background: var(--color-primary);
 }
 
-.home-index-shard--gamma {
-  right: -3rem;
-  bottom: -3.5rem;
-  width: 11rem;
-  height: 11rem;
-  background: var(--color-tertiary);
-}
-
 /* Between the shard cut-off and the layout each panel is the full
    band wide on small screens, so a shard sized for half of it stops being a corner accent. */
 @media (max-width: 899px) {
 
   .home-index-shard,
-  .home-index-shard--beta,
-  .home-index-shard--gamma {
+  .home-index-shard--beta {
     width: 8rem;
     height: 8rem;
     bottom: -2.5rem;
@@ -1688,7 +1666,7 @@ button.home-project-inventory-row {
   padding-top: var(--space-xl);
 }
 
-/* The title and the link have to sit clear of the shard beNewsreader them. The
+/* The title and the link have to sit clear of the shard behind them. The
    plate is excluded because it is the one child that must stay full-bleed,
    and the shard because it is the thing being sat clear of. */
 .home-index-panel> :not(.home-index-plate):not(.shard-accent) {
@@ -1697,13 +1675,6 @@ button.home-project-inventory-row {
   margin-inline: var(--space-lg);
 }
 
-.home-index-note {
-  margin: 0;
-  font-size: var(--type-body);
-  line-height: 1.5;
-  flex: 1 1 auto;
-}
-
 .home-index-title {
   margin: 0;
   font-size: var(--type-card);

data/assets/css/ledger/projects.css

@@ -183,7 +183,7 @@
   position: relative;
   display: block;
   text-decoration: none;
-  /* Empty blueprint as texture beNewsreader the plate — not a second view mode. */
+  /* Empty blueprint as texture behind the plate — not a second view mode. */
   background-color: var(--color-panel-contrast);
   background-image:
     linear-gradient(color-mix(in srgb, var(--color-outline) 10%, transparent) 1px, transparent 1px),
@@ -350,7 +350,7 @@
 
 /* ══ Repositories ══
    The mockup closed on a source-code ledger. Its licence stamp, spec
-   download and commit hashes have nothing beNewsreader them; the repository rows
+   download and commit hashes have nothing behind them; the repository rows
    do — `github` is set on five of the seven projects. */
 .projects-page .projects-repos {
   margin-top: var(--space-3xl);

data/assets/css/ledger/sources.css

@@ -9,7 +9,7 @@
 
 /* ── Shards ──
    The page had no depth treatment of any kind, and it is the wrong shape for
-   the ambient pool the home bands carry: a pool beNewsreader a grid of many small
+   the ambient pool the home bands carry: a pool behind a grid of many small
    cards only darkens one corner of it. Shards instead, the two canonical
    polygons from base.css, one at each end of the run — top right above the
    grid, bottom left below it, the diagonal pair the CV dossier uses inside
@@ -56,7 +56,7 @@
 }
 
 /* A card is not positioned, so without this the shard — which is — would be
-   painted over the bottom row rather than beNewsreader it. The rule the whole
+   painted over the bottom row rather than behind it. The rule the whole
    family answers to is that a backdrop never touches the object in front of
    it. */
 .sources-body>.listing-card-grid,
@@ -65,7 +65,7 @@
   z-index: 1;
 }
 
-/* The foot of the page, beside the pagination. It reaches up beNewsreader the last
+/* The foot of the page, beside the pagination. It reaches up behind the last
    row of cards. In dark those cards are opaque again, so what shows is the
    wedge in the gutter and the band across the pagination strip. */
 .sources-foot-shard {

data/assets/css/ledger/writing.css

@@ -70,7 +70,7 @@
    The alpha sits bottom left, under the foot of the copy, the one corner the
    plate never reaches at any width. The beta is a true corner accent at the
    top right: it is offset far enough up that its visible part is the triangle
-   above the plate's top edge, and it tucks beNewsreader the plate as it descends
+   above the plate's top edge, and it tucks behind the plate as it descends
    rather than fighting it. Neither corner repeats the home panel's pair, and
    the hues are the only two this page has — `.page-accent--green` rebinds
    primary onto secondary, so green and ochre is the whole palette here. */

data/lib/pandorga/detail_routes.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pandorga
+  # Detail URLs that used to be 200-rewritten onto a listing shell.
+  # Cloudflare follows `_redirects` even when a static file exists, so the
+  # built file must drop those splat lines or the generated page is never
+  # served. The source file is left alone.
+  module DetailRoutes
+    SPLAT_LINE = %r{\A/(?:articles|posts|blog|projects|products)/(?::slug|\*)/?\s+\S+\s+200\s*\z}
+
+    module_function
+
+    def strip_splat_rewrites(text)
+      text.to_s.lines.reject { |line| SPLAT_LINE.match?(line.strip) }.join
+    end
+
+    def static_index?(root, path)
+      root = root.to_s
+      return false if root.empty?
+
+      clean = path.to_s.split("?").first.to_s
+      relative = clean.sub(%r{\A/}, "").sub(%r{/\z}, "")
+      return false if relative.empty? || relative.include?("..")
+
+      File.file?(File.join(root, relative, "index.html")) ||
+        File.file?(File.join(root, "#{relative}.html"))
+    end
+  end
+end

data/lib/pandorga/jekyll/plugins/detail_documents.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+require "jekyll"
+require "pathname"
+
+require_relative "../../detail_routes"
+require_relative "lib/writing_entry"
+
+module Pandorga
+  module Jekyll
+    # One static page per published article, post, project, and product.
+    # The listing layout stays, so the client still opens the entry from
+    # the URL. `listing_path` stays the listing URL. The permalink is the
+    # detail URL, which is what the sitemap and the static canonical use.
+    class DetailDocumentsGenerator < ::Jekyll::Generator
+      safe true
+      priority :low
+
+      COLLECTION_FOR_TYPE = {
+        "article" => "articles",
+        "post" => "posts",
+        "project" => "projects",
+        "product" => "products"
+      }.freeze
+
+      DETAIL_PATTERN = {
+        "article" => "/articles/:slug/",
+        "post" => "/posts/:slug/",
+        "project" => "/projects/:slug/",
+        "product" => "/products/:slug/"
+      }.freeze
+
+      SCHEMA = {
+        "article" => "Article",
+        "post" => "BlogPosting"
+      }.freeze
+
+      def generate(site)
+        return if site.config["shell_content_agnostic"]
+
+        root = Pathname.new(site.source)
+        COLLECTION_FOR_TYPE.each do |type, collection|
+          listing = listing_page(site, type)
+          next unless listing
+          next if listing.data["listing_path"].to_s.empty?
+
+          directory = root.join(ContentKeys::CONTENT_PATHS.fetch(type))
+          next unless directory.directory?
+
+          Dir.glob(directory.join("*.{md,markdown}")).sort.each do |absolute|
+            emit(site, listing, type, collection, absolute, root)
+          end
+        end
+      end
+
+      private
+
+      def emit(site, listing, type, collection, absolute, root)
+        relative = Pathname.new(absolute).relative_path_from(root.join("content"))
+        repo_relative = Pathname.new("content").join(relative).to_s
+        record = WritingEntry.build(absolute, collection, repo_relative)
+        return if record.nil?
+
+        detail_path = record["url"].to_s
+        return if detail_path.empty?
+        return if taken?(site, detail_path)
+
+        front_matter, = ContentKeys.split_front_matter(File.read(absolute))
+        dir = detail_path.sub(%r{\A/}, "").sub(%r{/\z}, "")
+        page = ::Jekyll::PageWithoutAFile.new(site, site.source, dir, "index.html")
+        page.data["layout"] = listing.data["layout"]
+        page.data["permalink"] = detail_path
+        page.data["canonical_url"] = detail_path
+        page.data["listing_path"] = listing.data["listing_path"]
+        page.data["collection"] = collection
+        page.data["detail"] = listing.data["detail"].to_s
+        page.data["detail"] = DETAIL_PATTERN.fetch(type) if page.data["detail"].empty?
+        page.data["detail_document"] = true
+        page.data["accent"] = listing.data["accent"] if listing.data["accent"]
+        title = record["title"].to_s.strip
+        title = record["key"].to_s if title.empty?
+        page.data["title"] = title unless title.empty?
+        description = record["description"].to_s.strip
+        description = record["excerpt"].to_s.strip if description.empty?
+        page.data["description"] = description unless description.empty?
+        page.data["date"] = record["date"] unless record["date"].to_s.empty?
+        page.data["last_updated"] = record["last_updated"] unless record["last_updated"].to_s.empty?
+        thumbnail = record["thumbnail"].to_s.strip
+        page.data["thumbnail"] = thumbnail unless thumbnail.empty?
+        lang = front_matter["language"] || front_matter["lang"] || listing.data["lang"]
+        page.data["lang"] = lang if lang
+        if SCHEMA.key?(type)
+          page.data["og_type"] = "article"
+          page.data["schema_type"] = SCHEMA.fetch(type)
+        end
+        page.content = ""
+        site.pages << page
+      end
+
+      def taken?(site, detail_path)
+        site.pages.any? do |page|
+          page.data["permalink"].to_s == detail_path || page.url.to_s == detail_path
+        end
+      end
+
+      def listing_page(site, type)
+        entry = registry_entry(site, type)
+        return nil unless entry
+
+        site.pages.find do |page|
+          page.data["detail_document"] != true && page.data["key"].to_s == entry["key"].to_s
+        end
+      end
+
+      def registry_entry(site, type)
+        pages = site.data["pandorga_pages"]
+        return nil unless pages.is_a?(Array)
+
+        pages.find { |entry| entry.is_a?(Hash) && registry_match?(entry, type) }
+      end
+
+      def registry_match?(entry, type)
+        case type
+        when "article"
+          entry["template"].to_s == "articles" || entry["collection"].to_s == "articles"
+        when "post"
+          entry["template"].to_s == "blog" || entry["collection"].to_s == "posts"
+        when "project"
+          entry["template"].to_s == "portfolio" || entry["collection"].to_s == "projects"
+        when "product"
+          cols = entry["collections"]
+          entry["template"].to_s == "cv" ||
+            (cols.is_a?(Hash) && !cols["products"].to_s.empty?)
+        else
+          false
+        end
+      end
+    end
+  end
+end
+
+Jekyll::Hooks.register :site, :post_write do |site|
+  # Jekyll skips underscore files, so a source `_redirects` never reaches
+  # the output unless the site lists it under `include`. The published
+  # file has to be the one Cloudflare reads.
+  dest = File.join(site.dest, "_redirects")
+  source = File.join(site.source, "_redirects")
+  File.write(dest, File.read(source)) if !File.file?(dest) && File.file?(source)
+  next unless File.file?(dest)
+
+  original = File.read(dest)
+  stripped = Pandorga::DetailRoutes.strip_splat_rewrites(original)
+  File.write(dest, stripped) if stripped != original
+end

data/lib/pandorga/jekyll/plugins/lib/writing_entry.rb

@@ -15,7 +15,7 @@ require_relative "text_excerpt"
 # (standalone, for scripts/content/export-content-json.rb). They differ only in how
 # they derive the repo-relative path used for Git chronology, so each passes
 # its own. Everything downstream lives here, because a field added or a bug
-# fixed in one copy used to leave the other silently beNewsreader.
+# fixed in one copy used to leave the other silently behind.
 module WritingEntry
   XCITE_RE = /\{%-?\s*include\s+xcite\.html\s+key=["']([^"']+)["'][^%]*-?%\}/
 

data/lib/pandorga/jekyll/plugins/local_detail_rewrites.rb

@@ -6,6 +6,14 @@ require "net/http"
 require "uri"
 require_relative "content_detail_paths"
 
+# The gem copy and the _plugins copy stay the same file. Either path can
+# resolve the shared helper.
+detail_routes = [
+  File.expand_path("../../../detail_routes", __dir__),
+  File.expand_path("../lib/pandorga/detail_routes", __dir__)
+].find { |path| File.file?("#{path}.rb") }
+require detail_routes if detail_routes
+
 # Mirrors Cloudflare _redirects detail rewrites during `jekyll serve` so
 # /posts/:slug/ and /articles/:slug/ work locally without per-slug HTML files.
 # Also handles the local dev re-export endpoint and proxies /api/studio/* to
@@ -115,7 +123,8 @@ module Jekyll
           end
 
           target = ContentDetailPaths.rewrite_path(req.path)
-          if target
+          root = instance_variable_get(:@root)
+          if target && !Pandorga::DetailRoutes.static_index?(root, req.path)
             req.instance_variable_set(:@path, target)
             req.instance_variable_set(:@path_info, target)
           end

data/lib/pandorga/version.rb

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

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

@@ -269,7 +269,7 @@ def prune_stale_output_files!
   end
 
   stale.each(&:delete)
-  # Remove empty directories left beNewsreader by unpublish/rename.
+  # Remove empty directories left behind by unpublish/rename.
   OUTPUT_ROOT.find.sort.reverse_each do |path|
     next unless path.directory?
     next if path == OUTPUT_ROOT

data/scripts/test/render-parity/load-runtime.mjs

@@ -5,7 +5,7 @@
 // and a Jekyll build never executes them, which is how a block that renders
 // an element with no backing field ships green. This loader concatenates the
 // partials in the exact order _includes/page/content-runtime.html includes
-// them, evaluates the result beNewsreader a deliberately thin DOM shim, and hands
+// them, evaluates the result behind a deliberately thin DOM shim, and hands
 // back the same object 90-bootstrap.html returns to the browser.
 //
 // The shim is small on purpose: createElement, className, setAttribute,

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

@@ -72,6 +72,26 @@ sheets.each do |path|
   if source.include?("home-profile-summary")
     errors << "#{relative}: .home-profile-summary is unused"
   end
+
+  # Selectors that matched no template, runtime string, or current content.
+  # A comment may still name one; a ruleset may not.
+  retired = %w[
+    page-title
+    ledger-marker--primary
+    ledger-card--edge-primary
+    ledger-card--edge-secondary
+    ledger-card--edge-tertiary
+    ledger-section-rule
+    home-band--ruled
+    home-index-shard--gamma
+    home-index-note
+    post-content
+  ]
+  retired.each do |name|
+    next unless cleaned.match?(/[.#]#{Regexp.escape(name)}\b/)
+
+    errors << "#{relative}: .#{name} is unused"
+  end
 end
 
 fail!("CSS structure problems:\n  - #{errors.join("\n  - ")}") unless errors.empty?

data/scripts/test/test-discovery.rb

@@ -3,9 +3,13 @@
 
 # Portrait sources and discovery documents (PLT-AC-20, PLT-AC-21).
 
+require "fileutils"
 require "pathname"
 
+require "tmpdir"
+
 require_relative "../../lib/pandorga/discovery"
+require_relative "../../lib/pandorga/detail_routes"
 
 ROOT = Pathname.new(__dir__).join("..", "..").expand_path
 
@@ -41,6 +45,38 @@ fail!("portrait srcset is not read") unless runtime.include?("record.srcset = sr
 fail!("portrait sources are not applied") unless runtime.include?("applyHeroPortraitSources")
 shell = ROOT.join("_layouts/shell.html").read
 fail!("shell missing JSON-LD") unless shell.include?("theme/json-ld.html")
+og_images = shell.scan(/property="og:image"/)
+fail!("shell emits #{og_images.size} og:image properties; one page, one image") unless og_images.size == 1
+image_meta = shell[/<meta name="image"[^>]*>/]
+fail!("shell missing name=image") unless image_meta
+fail!("name=image also sets property=og:image") if image_meta.include?("property=")
 fail!("discovery generator is not loaded from the plugin dir") unless ROOT.join("lib/pandorga/jekyll/plugins/discovery.rb").file?
+fail!("detail pages are not generated from the plugin dir") unless ROOT.join("lib/pandorga/jekyll/plugins/detail_documents.rb").file?
+
+redirects = <<~TXT
+  /legacy /articles/2026-01-01-welcome/ 301
+  /articles/:slug /pages/articles/ 200
+  /posts/:slug/ /pages/blog/ 200
+  /blog/:slug /pages/blog/ 200
+  /projects/:slug /pages/projects/ 200
+  /products/* /pages/cv/ 200
+  /keep /pages/articles/ 301
+TXT
+stripped = Pandorga::DetailRoutes.strip_splat_rewrites(redirects)
+fail!("splat 200 rewrite survived") if stripped.match?(%r{/(?:articles|posts|blog|projects|products)/(?::slug|\*)})
+fail!("a 301 was stripped with the splats") unless stripped.include?("/legacy /articles/2026-01-01-welcome/ 301")
+fail!("a listing 301 was stripped") unless stripped.include?("/keep /pages/articles/ 301")
+
+Dir.mktmpdir("detail-static") do |dir|
+  FileUtils.mkdir_p(File.join(dir, "articles", "welcome"))
+  File.write(File.join(dir, "articles", "welcome", "index.html"), "<p>welcome</p>")
+  fail!("a built detail page must not be rewritten") unless Pandorga::DetailRoutes.static_index?(dir, "/articles/welcome/")
+  fail!("a missing detail page must still be rewritten") if Pandorga::DetailRoutes.static_index?(dir, "/articles/missing/")
+end
+
+json_ld = ROOT.join("_includes/theme/json-ld.html").read
+fail!("detail pages have no Article schema") unless json_ld.include?('page.schema_type == "Article"')
+fail!("detail pages have no BlogPosting schema") unless json_ld.include?('page.schema_type == "BlogPosting"')
+fail!("detail schema omits datePublished") unless json_ld.include?("datePublished")
 
 puts "PASS test-discovery"