pandorga 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96a7bd991685c2ae92de18f572112e692d02b211e134be12f0838247da013ade
-  data.tar.gz: 3f23ff94186ed6931a4f947efd18858cb16908a7db3c294a0eb9d92e244fc6f6
+  metadata.gz: 8ae9f3cb8f8c39b2e9af7ee8b582a35cdc389f61302704888d3c85adb88de394
+  data.tar.gz: 0d313d288d44e2d249751ceda633d6f58d981c42561a116c3faad0aac8e2cd9b
 SHA512:
-  metadata.gz: 8e924c057f9e70fdbea5e2b5ca40c3499ee18d482ce580ab091ff72e368bd4fc931c5ef7fb4a099155c04328a2ac2d98c93a36d5c3f1c0961e998c3e1a9edeb5
-  data.tar.gz: e8c7c19029b08a5cd20c6f5c109872b40c2d26877ffa8946ae01b6ab5c2d0c53dc6aad0eae0adf65ba23003fca69f18942dc3171e82ce44f7f7513d97c286ec4
+  metadata.gz: 91f82a29a1d5b7890fc2955ba3522d35f5c992a57dfda3b2f6e815e7ca613278aa1910be945170351d82ce5675045994070c6a6c8e9a8e20c3bf8d7b2448736d
+  data.tar.gz: 7478438f607e96460805455bf6873b0a97ccf35804a215f0d5422a168eb91228a91ef6907d9240b8d63f173e1cebc031c45070d0c8dfa4ae09b3ab8bf05ac088

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [2.0.1] — 2026-10-24
+
+### Fixed
+
+- Home article cards set their tags and "Read" on one row, like the featured card, and every card's top rule uses the Articles accent instead of rotating through the palette, which drew the second card in the secondary hue (PLT-AC-52).
+- A home band header whose kicker, title and note are all saved empty is removed with its rule instead of leaving an empty ruled strip; the band keeps an `aria-label` (PLT-AC-52).
+
 ## [2.0.0] — 2026-10-24
 
 ### Added

data/_includes/content-runtime/43-blocks.html

@@ -275,10 +275,14 @@
         html += '<p class="ledger-card-copy font-body">' +
           escapeHtml(f.preview) + '</p>';
       }
-      html += renderTagChips(f.tags, { hrefFor: options.tagHref, limit: options.tagLimit });
+      var chips = renderTagChips(f.tags, { hrefFor: options.tagHref, limit: options.tagLimit });
+      // `tagsInFoot` sets the chips on the call to action's row, as the home
+      // featured card does (PLT-AC-52); otherwise they sit above the foot.
+      if (!options.tagsInFoot) html += chips;
       // The meta strip above already carries the date, so the footer copy is
       // opt-in rather than the default — printing it twice is the common bug.
       var foot = '';
+      if (options.tagsInFoot) foot += chips;
       if (options.showFooterDates) {
         foot += renderCardFooterDates(f.date, f.lastUpdated, locale);
       }

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

@@ -431,6 +431,13 @@
       ['green', 'ochre'].forEach(function (name) {
         band.classList.toggle('page-accent--' + name, accent === name);
       });
+      /* A header left with no text and no link goes with its rule, and the
+       * band keeps a name from its data-home-label (PLT-AC-52). */
+      if (!root.querySelector('[data-content-section-kicker], [data-content-section-title], [data-content-section-note], .home-section-aside')) {
+        var label = band.getAttribute('data-home-label');
+        if (label && !band.hasAttribute('aria-label')) band.setAttribute('aria-label', label);
+        root.remove();
+      }
     }
 
     function yieldToMain() {

data/_includes/home/band-index.html

@@ -2,14 +2,35 @@
   Grouped index band (sources / network / bibliography). Expects `band` with
   kind=index and a pages array from PandorgaRegistry.home_bands.
 {%- endcomment -%}
+{%- comment -%}
+  The band's name when its header is gone: the panels' default titles. A
+  header whose kicker, title and note are all blank in headers.yml is not
+  emitted at all, so no empty ruled strip is left (PLT-AC-52).
+{%- endcomment -%}
+{%- assign _band_label = "" -%}
+{%- for panel in band.pages -%}
+{%- assign _label_page = site.pages | where: "key", panel.key | first -%}
+{%- assign _label = panel.title | default: _label_page.title | default: panel.key -%}
+{%- if _band_label != "" -%}{%- assign _band_label = _band_label | append: ", " -%}{%- endif -%}
+{%- assign _band_label = _band_label | append: _label -%}
+{%- endfor -%}
+{%- assign _hide_banner = false -%}
+{%- if site.data.page_headers -%}
+{%- assign _band_head = site.data.page_headers[band.section_key] -%}
+{%- assign _band_text = _band_head.kicker | append: _band_head.title | append: _band_head.note | strip -%}
+{%- if _band_text == "" -%}{%- assign _hide_banner = true -%}{%- endif -%}
+{%- endif -%}
 <section
   id="home-{{ band.group }}"
   class="home-band home-band--contrast home-band--index"
   data-home-band
   data-home-kind="index"
   data-home-group="{{ band.group }}"
+  data-home-label="{{ _band_label | escape }}"
+  {%- if _hide_banner %} aria-label="{{ _band_label | escape }}"{% endif %}
 >
   <div class="home-band-inner">
+    {%- unless _hide_banner -%}
     <div class="ledger-section-banner" data-content-home-section="{{ band.section_key }}">
       <div class="ledger-section-lead">
         <span class="ledger-kicker" data-content-section-kicker></span>
@@ -17,6 +38,7 @@
         <p class="home-section-note font-body" data-content-section-note></p>
       </div>
     </div>
+    {%- endunless -%}
     <div class="home-index-split">
       {%- for panel in band.pages -%}
       {%- assign _panel_page = site.pages | where: "key", panel.key | first -%}

data/_layouts/home.html

@@ -483,6 +483,7 @@ layout: shell
           locale: locale,
           ctaLabel: 'Read',
           tagHref: articleTagHref,
+          tagsInFoot: true,
           metaParts: [runtime.formatDate(entry.date, locale)]
         });
       }, 'Articles could not be loaded right now.');

data/assets/css/ledger/home.css

@@ -763,26 +763,23 @@ html[data-theme="light"] .home-hero-plate {
   display: none;
 }
 
+/* Tags and "Read" share the last row, as on the featured card (PLT-AC-52). */
 .home-card-grid .ledger-card-foot {
-  justify-content: flex-end;
+  justify-content: space-between;
+}
+
+.home-card-grid .ledger-card-foot .ledger-cta {
+  margin-left: auto;
 }
 
-/* A top rule per card, rotating through the palette triad, is what gives the
-   grid its ledger rhythm in the mockup. */
+/* Every card's top rule is the band accent, which `page-accent--<accent>`
+   sets on the section (PLT-AC-52). */
 .home-card-grid .ledger-card {
   border-top-width: 2px;
   border-top-style: solid;
   border-top-color: var(--color-primary);
 }
 
-.home-card-grid .ledger-card:nth-child(2) {
-  border-top-color: var(--color-secondary);
-}
-
-.home-card-grid .ledger-card:nth-child(3) {
-  border-top-color: var(--color-tertiary);
-}
-
 /* ── Rascunhos: dropped sheets ──
    Four compact cards rather than four full-width text rows: the poster is
    visible at every breakpoint now (it used to hide below 640px), each card

data/lib/pandorga/commands/new.rb

@@ -24,7 +24,7 @@ module Pandorga
 
         gem "pandorga", "~> 2.0"
         # Local checkout: gem "pandorga", path: "../pandorga"
-        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v2.0.0"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v2.0.1"
         gem "csv"
         gem "base64"
       RUBY

data/lib/pandorga/version.rb

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

data/scripts/test/test-home-article-cards.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# PLT-AC-52. Home article cards keep tags and "Read" on one row, all use the
+# band accent, and a band header whose texts are all empty is removed.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+
+def fail!(message)
+  warn "FAIL test-home-article-cards: #{message}"
+  exit 1
+end
+
+blocks = ROOT.join("_includes/content-runtime/43-blocks.html").read
+home_layout = ROOT.join("_layouts/home.html").read
+css = ROOT.join("assets/css/ledger/home.css").read
+band_index = ROOT.join("_includes/home/band-index.html").read
+fragments = ROOT.join("_includes/content-runtime/60-fragments.html").read
+
+# 1. Foot row.
+card = blocks[/function renderArchiveCard\(.*?\n    \}\n/m] or fail!("renderArchiveCard not found")
+fail!("renderArchiveCard has no tagsInFoot option") unless card.include?("options.tagsInFoot")
+chips_at = card.index("renderTagChips(")
+foot_at = card.index("'<div class=\"ledger-card-foot\">'")
+fail!("tag chips are not built before the foot") unless chips_at && foot_at && chips_at < foot_at
+fail!("chips are not put inside the foot when tagsInFoot") unless card =~ /tagsInFoot[^\n]*\n?[^\n]*foot\s*\+?=\s*chips|foot\s*=\s*\(?options\.tagsInFoot/m
+callers = Dir[ROOT.join("{_layouts,_includes}/**/*.html").to_s].select { |f| File.read(f).include?("tagsInFoot: true") }
+fail!("tagsInFoot must be set by the home layout only, found #{callers.inspect}") unless callers.map { |f| File.basename(f) } == ["home.html"]
+foot_rule = css[/^\.home-card-grid \.ledger-card-foot \{[^}]*\}/m] or fail!("no .home-card-grid .ledger-card-foot rule")
+fail!(".home-card-grid .ledger-card-foot must space-between") unless foot_rule.include?("justify-content: space-between")
+cta_rule = css[/^\.home-card-grid \.ledger-card-foot \.ledger-cta \{[^}]*\}/m]
+fail!(".home-card-grid .ledger-card-foot .ledger-cta must take margin-left: auto") unless cta_rule&.include?("margin-left: auto")
+
+# 2. One accent.
+css.scan(/^([^{}\n]*\.home-card-grid[^{}\n]*)\{([^}]*)\}/m).each do |sel, body|
+  if body =~ /border-top-color:\s*var\(--color-(secondary|tertiary)\)/
+    fail!("#{sel.strip} rotates the card rule to --color-#{$1}")
+  end
+  fail!("#{sel.strip} keys a colour to :nth-child") if sel.include?("nth-child") && body =~ /color/
+end
+base = css[/^\.home-card-grid \.ledger-card \{[^}]*\}/m] or fail!("no .home-card-grid .ledger-card rule")
+fail!("card top rule is not var(--color-primary)") unless base.include?("border-top-color: var(--color-primary)")
+
+# 3. Build time.
+fail!("band-index does not set data-home-label") unless band_index.include?("data-home-label=")
+fail!("band-index does not guard the banner on empty header texts") unless band_index =~ /\{%-?\s*unless _hide_banner\s*-?%\}\s*<div class="ledger-section-banner"/m
+fail!("band-index does not label the section when the banner is hidden") unless band_index =~ /_hide_banner\s*%\}\s*aria-label=/
+
+# 4. Runtime.
+apply = fragments[/function applyHomeSection\(.*?\n    \}\n/m] or fail!("applyHomeSection not found")
+fail!("applyHomeSection does not drop an emptied banner") unless apply.include?("root.remove()") &&
+  apply.include?("home-section-aside") && apply.include?("data-home-label")
+
+puts "PASS test-home-article-cards"

data/scripts/validate.sh

@@ -77,6 +77,7 @@ TESTS=(
   scripts/test/test-timeline-pan.rb
   scripts/test/test-v3-layout.rb
   scripts/test/test-studio-section-texts.rb
+  scripts/test/test-home-article-cards.rb
 )
 
 failed=0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -439,6 +439,7 @@ files:
 - scripts/test/test-hero-portraits.rb
 - scripts/test/test-hero-summary.rb
 - scripts/test/test-highlighter-pills.rb
+- scripts/test/test-home-article-cards.rb
 - scripts/test/test-home-articles.rb
 - scripts/test/test-home-band-art.rb
 - scripts/test/test-home-band-intro.rb