pandorga 1.4.9 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b29a2005613455748e1e0a7dce5e7938b00e1482b8ae003f1b836252eb869695
-  data.tar.gz: 435e4bbb834478e0e5b7b5f337297b06c85ecec4dede4decbf35142d092e3b9d
+  metadata.gz: c33cb11f60569d5280aa7079b6f59ad7776f90705f54f67d958d8b149390714d
+  data.tar.gz: 4a52dcb27be1f4d2a809417bc9b98e89e3c8aa8d92e642fca9ebab156942a192
 SHA512:
-  metadata.gz: 34677acf3f620cbc6084c8424516c568081013d0c97d9d0ac3376b1cf5e39b0306c41d254428c52c3c88d185a13cc4d8fb64571e6c4e0a7823e4ac112c2f4c9c
-  data.tar.gz: ade0e7ec4632f9113ce3fde3e6f35d282f05870efda7bf9149c28708a5ac2cc8410d6de62cde76c0f4fcce80c219d02ab41f9b75042f300162006cf7c22d3181
+  metadata.gz: ecf8762ab684b723db57bb8d291609a3decf8ecae02f21b0158c3fd34afce67b9a34347255e790e26d480e8ef0b2eaab577dbe3d6ed571a02ce713cc5a2e09d9
+  data.tar.gz: 0c30da38132b4b87f2caf982a73f7c8eea1cf157600ecffb9b6f87e24fe289a47952fe3f9c8291c11719531a90cabd0149db89ba13b076c341a4eafabd6577b5

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [1.5.1] — 2026-10-10
+
+### Fixed
+
+- The shell has a "Skip to content" link. When `site.author` is blank, the
+  home link's accessible name uses `pandorga.identity.name`, then the top-bar
+  wordmark, instead of a bare dash. The footer wordmark uses the same
+  fallback. A site that sets `site.author` is unchanged.
+- `pandorga doctor` says when `pandorga.pages` is missing, and says when the
+  list is empty.
+- `./scripts/validate.sh` fails if a listed gate file is missing.
+
+### Changed
+
+- Getting started and the README name the scaffold pin `~> 1.3`.
+- `pandorga new` comments the `v1.5.0` tag.
+- Home CSS drops an empty `@media (min-width: 768px)` block and the unused
+  `.home-profile-summary` rules.
+- Chord chart and transcript include comments are English. The visible
+  transcript labels are unchanged.
+
+No `pandorga:` config keys were added or renamed.
+
+## [1.5.0] — 2026-10-10
+
+### Added
+
+- Optional `pandorga.identity.first_name` and `pandorga.identity.last_name`.
+  The home hero uses them as the given name and the family name. The top
+  bar shows `first_name`. `last_name` is kept whole, spaces included.
+  Omit either key and that part still comes from splitting `identity.name`
+  on the first space, as in 1.4.9. `identity.name` stays required.
+
+### Changed
+
+- The home hero subtitle uses `--type-body`, the same size as the summary
+  under the name.
+- Below 768px the hero name is 3pt larger, and a wrap breaks only between
+  the given name and the family name.
+
 ## [1.4.9] — 2026-10-09
 
 ### Changed

data/README.md

@@ -17,7 +17,7 @@ An aesthetic Jekyll publishing platform for creative and technical writing. The
 Scaffold a site (Ada Example defaults, `content.backend: static`):
 
 ```bash
-gem install pandorga   # once 1.1 is on RubyGems; or use a local checkout
+gem install pandorga   # or use a local checkout
 pandorga new my-site
 cd my-site
 bundle install

data/_includes/chord-tab.html

@@ -1,14 +1,14 @@
 {% comment %}
 chord-tab.html
-Exibe uma cifra estruturada em N colunas monoespaçadas, usando toda a largura disponível.
-Cada coluna respeita o limite de 79 caracteres por linha.
-Uso: {% include chord-tab.html tab=tab_data %}
-Onde tab_data tem:
-intro: "linha de acordes do intro (opcional)"
+Renders a chord chart in N monospaced columns, using the full available width.
+Each column stays within 79 characters per line.
+Use: {% include chord-tab.html tab=tab_data %}
+tab_data has:
+intro: "intro chord line (optional)"
 sections:
-- label: "rótulo da seção (opcional)"
+- label: "section label (optional)"
 content: |
-linhas de cifra/letra
+chord and lyric lines
 {% endcomment %}
 
 <div class="chord-tab-container mt-16 mb-8"

data/_includes/page/site-footer.html

@@ -29,6 +29,7 @@
 {%- endcomment -%}
 
 {%- assign footer_active = include.nav_active -%}
+{%- assign footer_name = site.author | default: site.pandorga.identity.name -%}
 {%- assign footer_license = site.content_license -%}
 
 <footer class="site-footer">
@@ -39,9 +40,9 @@
     <div class="site-footer-grid">
 
       <div class="site-footer-block site-footer-masthead">
-        <a href="/" class="site-footer-wordmark-link" aria-label="{{ site.author }} – Home">
+        <a href="/" class="site-footer-wordmark-link" aria-label="{% if footer_name != blank %}{{ footer_name }} – Home{% else %}Home{% endif %}">
           {% include theme/site-logo.html %}
-          <span class="site-footer-wordmark">{{ site.author }}</span>
+          <span class="site-footer-wordmark">{{ footer_name }}</span>
         </a>
         {%- comment -%}
           The same fragment the home hero mounts, so the line the site opens

data/_includes/transcription.html

@@ -1,11 +1,11 @@
 {% comment %}
   transcription.html
-  Exibe uma transcrição estruturada, com até 4 personagens (cores definidas por ordem de aparição).
-  Uso: {% include transcription.html transcription=page.transcription youtube_id='fpmZiY24U0k' %}
-  Ou para usar um arquivo em _data:
+  Renders a structured transcript, with up to 4 speakers (colors follow order of appearance).
+  Use: {% include transcription.html transcription=page.transcription youtube_id='fpmZiY24U0k' %}
+  Or to load a file from _data:
   {% assign transcription_data = site.data.transcriptions[page.transcription].transcription %}
   {% include transcription.html transcription=transcription_data youtube_id='fpmZiY24U0k' %}
-  Também suporta url e image para thumbnail:
+  Also accepts url and image for a thumbnail:
   {% include transcription.html transcription=transcription_data url='https://...' image='https://...' %}
 
   Speaker labels are title-cased at render time (Patrícia, not PATRÍCIA) so
@@ -26,7 +26,7 @@
   <hr class="border-t border-gentle-divider mb-6">
   {% if include.youtube_id %}
     <div class="mb-2">
-      {% include youtube.html id=include.youtube_id %} <!-- Exibe o vídeo do YouTube -->  
+      {% include youtube.html id=include.youtube_id %} <!-- YouTube video -->  
       <span class="font-label text-xs text-on-surface-variant">Transcrição do vídeo</span>
     </div>
   {% elsif include.url and include.image %}

data/_layouts/home.html

@@ -5,7 +5,8 @@ layout: shell
 {%- comment -%}
   Home — composition from the page registry (PLT §5.4).
 
-  The hero reads identity plus content fragments. Decorative art is a slot
+  The hero reads identity (first_name and last_name, or a split of name)
+  plus content fragments. Decorative art is a slot
   (`pandorga.home.hero_art`, default page/hero-default.html). Listing and
   index bands come from site.data.pandorga_home_bands in registry order.
   Band copy (kicker, title, note) arrives from content/pages/headers.yml
@@ -13,10 +14,7 @@ layout: shell
   in this layout.
 {%- endcomment -%}
 
-{%- assign _identity_name = site.pandorga.identity.name | default: site.author -%}
-{%- assign _name_parts = _identity_name | split: " " -%}
-{%- assign _name_given = _name_parts | first -%}
-{%- assign _name_family = _name_parts | slice: 1, 8 | join: " " -%}
+{%- assign _hero_name = site.pandorga.identity | pandorga_hero_name: site.author, site.title -%}
 {%- assign _cv_page = site.pages | where: "key", "cv" | first -%}
 {%- assign _hero_art = site.pandorga.home.hero_art | default: "page/hero-default.html" -%}
 {%- assign _home_bands = site.data.pandorga_home_bands -%}
@@ -33,7 +31,7 @@ layout: shell
           <div id="home-subtitle-content" class="home-hero-tagline font-label"
             data-content-fragment="home/subtitle"></div>
           <h1 class="home-hero-title">
-            <span class="home-hero-given">{{ _name_given }}</span>{%- if _name_family != "" %} <span class="home-hero-family">{{ _name_family }}</span>{%- endif %}
+            <span class="home-hero-given">{{ _hero_name.given }}</span>{%- if _hero_name.family != "" %} <span class="home-hero-family">{{ _hero_name.family }}</span>{%- endif %}
           </h1>
           <div id="home-cv-summary" class="home-hero-summary font-body"
             data-content-fragment="cv/summary"></div>

data/_layouts/shell.html

@@ -83,7 +83,10 @@
 </head>
 
 <body class="bg-background text-on-surface">
+  <a class="skip-link" href="#page-content">Skip to content</a>
 
+  {% assign _nav_name = site.pandorga.identity | pandorga_hero_name: site.author, site.title %}
+  {% assign _home_label = site.author | default: site.pandorga.identity.name | default: _nav_name.wordmark %}
   {% assign nav_active = nil %}
   {% if page.collection == "articles" %}{% assign nav_active = "articles" %}{% endif %}
   {% if page.collection == "posts" %}{% assign nav_active = "blog" %}{% endif %}
@@ -97,9 +100,9 @@
   <nav class="sticky top-0 z-50 bg-surface">
     <div class="flex justify-between items-center w-full px-6 sm:px-8 md:px-10 pt-5 pb-3.5 leading-none max-w-7xl mx-auto">
       <div class="flex items-center gap-3 sm:gap-4 min-w-0">
-        <a href="/" aria-label="{{ site.author }} – Home" class="shrink-0 inline-flex items-center gap-3 site-wordmark-link">
+        <a href="/" aria-label="{% if _home_label != blank %}{{ _home_label }} – Home{% else %}Home{% endif %}" class="shrink-0 inline-flex items-center gap-3 site-wordmark-link">
           {% include theme/site-logo.html %}
-          <span class="site-wordmark">{{ site.author | default: site.title | split: " " | first }}</span>
+          <span class="site-wordmark">{{ _nav_name.wordmark }}</span>
         </a>
       </div>
 
@@ -189,7 +192,9 @@
 
   {% include page/content-runtime.html %}
 
+  <div id="page-content" tabindex="-1">
   {{ content }}
+  </div>
 
   {% include page/figure-lightbox.html %}
 

data/assets/css/ledger/chrome.css

@@ -6,6 +6,29 @@
    one source of navigation; only the presentation changes. The Explore menu
    stays for narrow viewports, where six links do not fit. */
 
+.skip-link {
+  position: absolute;
+  left: 0.75rem;
+  top: 0.75rem;
+  z-index: 80;
+  padding: 0.45rem 0.75rem;
+  background: var(--color-surface);
+  color: var(--color-on-surface);
+  border: 1px solid var(--color-outline);
+  text-decoration: none;
+  font-family: var(--font-label);
+  font-size: var(--type-label);
+  transform: translateY(-150%);
+}
+
+.skip-link:focus {
+  transform: none;
+}
+
+#page-content:focus {
+  outline: none;
+}
+
 .site-wordmark-link {
   display: inline-flex;
   align-items: center;

data/assets/css/ledger/home.css

@@ -219,19 +219,14 @@
   margin: 0 0 var(--space-sm);
   color: var(--color-on-surface);
   font-family: var(--font-label);
-  font-size: var(--type-label-lg);
+  /* Same size as the summary under the name, which inherits --type-body. */
+  font-size: var(--type-body);
   font-weight: var(--weight-label);
   letter-spacing: 0.03em;
   line-height: 1.35;
   max-width: 100%;
 }
 
-@media (min-width: 1024px) {
-  .home-hero-tagline {
-    font-size: calc(var(--type-label-lg) + 2pt);
-  }
-}
-
 .home-hero-tagline::after {
   content: "";
   flex: 1 1 auto;
@@ -262,10 +257,13 @@
   max-width: 100%;
 }
 
-@media (max-width: 767px) {
-  .home-hero-title {
-    white-space: normal;
-  }
+.home-hero-given,
+.home-hero-family {
+  display: inline;
+}
+
+.home-hero-family {
+  color: var(--color-primary);
 }
 
 @media (min-width: 640px) {
@@ -274,19 +272,34 @@
   }
 }
 
-@media (min-width: 768px) {
+/* Below 768px the name is 3pt larger than the clamp above, and the only
+   wrap point is the gap between the given name and the family name. */
+@media (max-width: 639px) {
   .home-hero-title {
-    white-space: nowrap;
+    white-space: normal;
+    font-size: calc(clamp(var(--type-section), calc(100cqi * 0.92 / 14.5), var(--type-page-lg)) + 3pt);
   }
 }
 
-.home-hero-given,
-.home-hero-family {
-  display: inline;
+@media (min-width: 640px) and (max-width: 767px) {
+  .home-hero-title {
+    white-space: normal;
+    font-size: calc(clamp(var(--type-section-lg), calc(100cqi * 0.92 / 14.5), var(--type-page-lg)) + 3pt);
+  }
 }
 
-.home-hero-family {
-  color: var(--color-primary);
+@media (max-width: 767px) {
+  .home-hero-given,
+  .home-hero-family {
+    display: inline-block;
+    white-space: nowrap;
+  }
+}
+
+@media (min-width: 768px) {
+  .home-hero-title {
+    white-space: nowrap;
+  }
 }
 
 .home-hero-summary {
@@ -1485,26 +1498,6 @@ html[data-theme="light"] .home-hero-plate {
   }
 }
 
-@media (min-width: 768px) {}
-
-/* ── Profile band, hero plate scale, section action order ──
-   Appended after the parallel page work; see the redesign PR. */
-
-/* The portrait sits at the end of its grid column so its right edge meets
-   the edge every band below aligns to. Cap lives on the earlier
-   `.home-hero-portrait` rule (Borders Edition). */
-.home-profile-summary {
-  max-width: var(--reading-measure);
-}
-
-.home-profile-summary p {
-  margin-bottom: var(--space-md);
-}
-
-.home-profile-summary p:last-child {
-  margin-bottom: 0;
-}
-
 /* ── Reference band: Sources + Network of Ideas ──────────────────────────
    Two destinations in one band, each a card whose poster is a plate drawn
    from that section's own content by the export and fetched at runtime.

data/examples/full/_config.yml

@@ -8,6 +8,8 @@ plugins:
 pandorga:
   identity:
     name: "Ada Example"
+    first_name: "Ada"
+    last_name: "Example"
     short_name: "A. Example"
     url: "https://example.org"
     locale: en

data/lib/pandorga/commands/doctor.rb

@@ -30,7 +30,9 @@ module Pandorga
           end
           pages = pandorga["pages"]
           if pages.nil?
-            warnings << "pandorga.pages is empty — no pages will be generated"
+            warnings << "pandorga.pages is missing; no pages will be generated"
+          elsif pages.is_a?(Array) && pages.empty?
+            warnings << "pandorga.pages is empty; no pages will be generated"
           elsif !pages.is_a?(Array)
             errors << "pandorga.pages must be an array"
           else

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.3.11"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.5.0"
         gem "csv"
         gem "base64"
       RUBY

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# Spec: docs/features/hero-name.md
+# Refs: PLT-AC-14
+module Pandorga
+  # Given name, family name, and top-bar wordmark for the home hero.
+  module IdentityName
+    module_function
+
+    # identity may use string or symbol keys. author and title are the
+    # Jekyll site.author and site.title fallbacks.
+    def resolve(identity, author: nil, title: nil)
+      fields = normalize(identity)
+      given_field = explicit(fields, "first_name")
+      family_field = explicit(fields, "last_name")
+      legacy = tokens(text(fields["name"]).empty? ? author : fields["name"])
+
+      given = present(given_field) ? given_field : legacy.first.to_s
+      family = present(family_field) ? family_field : legacy.drop(1).take(8).join(" ")
+      wordmark = if present(given_field)
+                   given_field
+                 else
+                   source = [fields["name"], author, title].map { |value| text(value) }.find { |value| !value.empty? }
+                   tokens(source).first.to_s
+                 end
+
+      { "given" => given, "family" => family, "wordmark" => wordmark }
+    end
+
+    def normalize(identity)
+      raw = case identity
+            when Hash then identity
+            else identity.respond_to?(:to_hash) ? identity.to_hash : {}
+            end
+      raw.each_with_object({}) { |(key, value), out| out[key.to_s] = value }
+    end
+
+    # :missing when the key is absent or null. Blank is handled by present.
+    def explicit(fields, key)
+      return :missing unless fields.key?(key)
+      return :missing if fields[key].nil?
+
+      fields[key].to_s.strip
+    end
+
+    def present(value)
+      value.is_a?(String) && !value.empty?
+    end
+
+    def text(value)
+      value.to_s.strip
+    end
+
+    def tokens(value)
+      text(value).split(" ")
+    end
+  end
+end
+
+# Liquid filter used by the home hero and the top bar.
+module PandorgaHeroNameFilter
+  def pandorga_hero_name(identity, author = nil, title = nil)
+    Pandorga::IdentityName.resolve(identity, author: author, title: title)
+  end
+end
+
+Liquid::Template.register_filter(PandorgaHeroNameFilter) if defined?(Liquid::Template)

data/lib/pandorga/registry/schema.yml

@@ -8,7 +8,15 @@ identity:
     name:
       type: string
       required: true
-      notes: Title suffix, default author, BibTeX
+      notes: Title suffix, default author, BibTeX. Also the legacy hero name when `first_name` or `last_name` is omitted
+    first_name:
+      type: string
+      required: false
+      notes: Hero given name and top-bar wordmark. Omitted or blank, the first word of `name` is used
+    last_name:
+      type: string
+      required: false
+      notes: Hero family name, kept whole (spaces allowed). Omitted or blank, the remainder of `name` is used
     short_name:
       type: string
       required: false

data/lib/pandorga/version.rb

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

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

@@ -64,6 +64,14 @@ sheets.each do |path|
     errors << "#{relative}: #{depth} unclosed brace(s) — every rule after the " \
               "offending block is swallowed and silently stops applying"
   end
+
+  if cleaned.match?(/\{[ \t\r\n]*\}/)
+    errors << "#{relative}: empty ruleset (a block that matches nothing)"
+  end
+
+  if source.include?("home-profile-summary")
+    errors << "#{relative}: .home-profile-summary is unused"
+  end
 end
 
 fail!("CSS structure problems:\n  - #{errors.join("\n  - ")}") unless errors.empty?

data/scripts/test/test-doctor.rb

@@ -3,6 +3,7 @@
 # Refs: PLT-0.3, PLT-AC-5
 require "pathname"
 require "open3"
+require "fileutils"
 
 ROOT = Pathname.new(__dir__).join("../..").expand_path
 EXAMPLE = ROOT.join("examples/minimal")
@@ -36,4 +37,41 @@ unless err.include?("pandorga:")
   exit 1
 end
 
+missing = ROOT.join("tmp/doctor-missing-pages")
+FileUtils.rm_rf(missing)
+missing.mkpath
+missing.join("_config.yml").write(<<~YAML)
+  pandorga:
+    identity:
+      name: Ada Example
+YAML
+_out, err, st = run_doctor(missing)
+unless st.success?
+  warn "FAIL test-doctor: missing pages should warn, not fail\n#{err}"
+  exit 1
+end
+unless err.include?("pandorga.pages is missing")
+  warn "FAIL test-doctor: expected a missing-pages warning\n#{err}"
+  exit 1
+end
+
+empty = ROOT.join("tmp/doctor-empty-pages")
+FileUtils.rm_rf(empty)
+empty.mkpath
+empty.join("_config.yml").write(<<~YAML)
+  pandorga:
+    identity:
+      name: Ada Example
+    pages: []
+YAML
+_out, err, st = run_doctor(empty)
+unless st.success?
+  warn "FAIL test-doctor: empty pages should warn, not fail\n#{err}"
+  exit 1
+end
+unless err.include?("pandorga.pages is empty")
+  warn "FAIL test-doctor: expected an empty-pages warning\n#{err}"
+  exit 1
+end
+
 puts "PASS test-doctor"

data/scripts/test/test-hero-name.rb

@@ -0,0 +1,165 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Hero name fields and headline size (docs/features/hero-name.md).
+#
+# PLT-AC-13 subtitle uses the body size
+# PLT-AC-14 first_name / last_name, with the 1.4.9 split as fallback
+# PLT-AC-15 phone name is +3pt and wraps only between the two names
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+HOME = ROOT.join("_layouts/home.html")
+SHELL = ROOT.join("_layouts/shell.html")
+CSS = ROOT.join("assets/css/ledger/home.css")
+SCHEMA = ROOT.join("lib/pandorga/registry/schema.yml")
+
+def check!(condition, message)
+  raise "Assertion failed: #{message}" unless condition
+end
+
+puts "Testing hero name..."
+
+# ── PLT-AC-13 ───────────────────────────────────────────────────────────────
+
+css = CSS.read
+tagline = css[/\.home-hero-tagline \{.*?\n\}/m]
+check!(tagline, "missing .home-hero-tagline rule")
+check!(tagline.include?("font-size: var(--type-body);"),
+       "subtitle must use the body size, got:\n#{tagline}")
+check!(!tagline.include?("type-label-lg"),
+       "subtitle must not keep the label size")
+check!(!css.include?("calc(var(--type-label-lg) + 2pt)"),
+       "desktop subtitle must not add 2pt")
+
+summary = css[/\.home-hero-summary \{.*?\n\}/m]
+check!(summary, "missing .home-hero-summary rule")
+check!(!summary.include?("font-size:"),
+       "summary inherits the page body size and must not set its own")
+
+# ── PLT-AC-14 ───────────────────────────────────────────────────────────────
+
+schema = SCHEMA.read
+check!(schema.include?("first_name:"), "schema missing first_name")
+check!(schema.include?("last_name:"), "schema missing last_name")
+check!(schema.include?("name:") && schema.include?("required: true"),
+       "identity.name stays required")
+
+home = HOME.read
+shell = SHELL.read
+check!(home.include?("pandorga_hero_name"),
+       "home hero must resolve the name through pandorga_hero_name")
+check!(home.include?("home-hero-given") && home.include?("home-hero-family"),
+       "hero keeps a given span and a family span")
+check!(shell.include?("pandorga_hero_name"),
+       "top bar must resolve the wordmark through pandorga_hero_name")
+check!(shell.include?(".wordmark"),
+       "top bar prints the wordmark from the resolver")
+check!(!shell.include?('site.author | default: site.title | split: " " | first'),
+       "top bar must not split site.author on its own")
+
+require "liquid"
+require_relative "../../lib/pandorga/jekyll/plugins/identity_name"
+
+template = Liquid::Template.parse(<<~LIQUID)
+  {% assign hero = identity | pandorga_hero_name: author, title %}
+  {{ hero.given }}|{{ hero.family }}|{{ hero.wordmark }}
+LIQUID
+rendered = template.render(
+  "identity" => { "first_name" => "Ada", "last_name" => "Rivera Santos" },
+  "author" => "Other Person",
+  "title" => "Site Title"
+)
+check!(rendered.strip == "Ada|Rivera Santos|Ada",
+       "Liquid filter must keep a multi-word last name, got #{rendered.inspect}")
+
+both = Pandorga::IdentityName.resolve(
+  { "name" => "Ada Rivera Santos", "first_name" => "Ada", "last_name" => "Rivera Santos" },
+  author: "Other Person",
+  title: "Site Title"
+)
+check!(both["given"] == "Ada", "given name, got #{both.inspect}")
+check!(both["family"] == "Rivera Santos", "multi-word family name must stay whole, got #{both.inspect}")
+check!(both["wordmark"] == "Ada", "top bar shows the first name, got #{both.inspect}")
+
+spaced = Pandorga::IdentityName.resolve(
+  { "first_name" => " Mary Ann ", "last_name" => " Rivera Santos " }
+)
+check!(spaced["given"] == "Mary Ann" && spaced["wordmark"] == "Mary Ann",
+       "first_name is kept whole, got #{spaced.inspect}")
+check!(spaced["family"] == "Rivera Santos",
+       "last_name is trimmed but not split, got #{spaced.inspect}")
+
+legacy = Pandorga::IdentityName.resolve(
+  { "name" => "Ada Rivera Santos" },
+  author: "Other Person",
+  title: "Site Title"
+)
+check!(legacy["given"] == "Ada", "legacy given name, got #{legacy.inspect}")
+check!(legacy["family"] == "Rivera Santos", "legacy family name, got #{legacy.inspect}")
+check!(legacy["wordmark"] == "Ada", "legacy wordmark prefers identity.name, got #{legacy.inspect}")
+
+partial_family = Pandorga::IdentityName.resolve(
+  { "name" => "Someone Else", "last_name" => "Rivera Santos" }
+)
+check!(partial_family["given"] == "Someone", "missing first_name uses the first word of name")
+check!(partial_family["family"] == "Rivera Santos", "explicit last_name replaces the remainder")
+check!(partial_family["wordmark"] == "Someone", "missing first_name wordmark is the first word of name")
+
+partial_given = Pandorga::IdentityName.resolve({ "name" => "Ada Example", "first_name" => "Ada" })
+check!(partial_given["family"] == "Example", "missing last_name keeps the remainder of name")
+check!(partial_given["wordmark"] == "Ada", "wordmark uses first_name")
+
+blank_last = Pandorga::IdentityName.resolve({ "name" => "Ada Example", "last_name" => "" })
+check!(blank_last["family"] == "Example", "blank last_name keeps the 1.4.9 remainder")
+
+author_only = Pandorga::IdentityName.resolve({}, author: "Other Person", title: "Site Title")
+check!(author_only["given"] == "Other" && author_only["family"] == "Person",
+       "name falls back to site.author, got #{author_only.inspect}")
+check!(author_only["wordmark"] == "Other", "wordmark falls back to site.author")
+
+title_only = Pandorga::IdentityName.resolve({}, title: "Site Title")
+check!(title_only["given"] == "" && title_only["family"] == "",
+       "hero does not take site.title, got #{title_only.inspect}")
+check!(title_only["wordmark"] == "Site", "wordmark falls back to site.title")
+
+long_name = (["Ada"] + (1..9).map { |index| "Tok#{index}" }).join(" ")
+long = Pandorga::IdentityName.resolve({ "name" => long_name })
+check!(long["family"] == (1..8).map { |index| "Tok#{index}" }.join(" "),
+       "legacy remainder stays eight words, got #{long["family"].inspect}")
+
+symbols = Pandorga::IdentityName.resolve({ first_name: "Ada", last_name: "Rivera Santos" })
+check!(symbols["family"] == "Rivera Santos", "symbol keys work, got #{symbols.inspect}")
+
+# ── PLT-AC-15 ───────────────────────────────────────────────────────────────
+
+hero = css[/\.home-hero-title \{.*?(?=\.home-hero-summary)/m]
+check!(hero, "missing hero title block")
+check!(hero.include?("font-size: clamp(var(--type-section), calc(100cqi * 0.92 / 14.5), var(--type-page-lg));"),
+       "base name size stays the 1.4.9 clamp")
+check!(hero.include?("@media (max-width: 639px)"), "missing phone size query")
+check!(hero.include?("calc(clamp(var(--type-section), calc(100cqi * 0.92 / 14.5), var(--type-page-lg)) + 3pt)"),
+       "below 640px the name must be the current clamp plus 3pt")
+check!(hero.include?("@media (min-width: 640px) and (max-width: 767px)"),
+       "missing 640-767 size query")
+check!(hero.include?("calc(clamp(var(--type-section-lg), calc(100cqi * 0.92 / 14.5), var(--type-page-lg)) + 3pt)"),
+       "from 640px to 767px the name must be the section-lg clamp plus 3pt")
+
+plain = hero.index("@media (min-width: 640px) {")
+banded = hero.index("@media (min-width: 640px) and (max-width: 767px)")
+check!(plain && banded && banded > plain,
+       "the +3pt band must follow the plain 640px clamp so it wins")
+
+phone = hero[/@media \(max-width: 767px\) \{.*?\n\}/m]
+check!(phone && phone.include?("inline-block") && phone.include?("white-space: nowrap"),
+       "on a phone each name is an unbreakable unit, got:\n#{phone}")
+check!(phone.include?(".home-hero-given") && phone.include?(".home-hero-family"),
+       "both name parts are unbreakable")
+
+desktop = hero[/@media \(min-width: 768px\) \{.*?\n\}/m]
+check!(desktop && desktop.include?("white-space: nowrap"),
+       "from 768px the name stays on one line")
+check!(!desktop.include?("3pt"), "the +3pt bump is phone-only")
+
+puts "PASS test-hero-name"

data/scripts/test/test-new.rb

@@ -21,6 +21,17 @@ def run_doctor(dir)
   Open3.capture3(env, "ruby", EXE.to_s, "doctor", dir.to_s)
 end
 
+guide = ROOT.join("docs/getting-started.md").read
+readme = ROOT.join("README.md").read
+unless guide.include?('gem at `~> 1.3`')
+  warn "FAIL test-new: getting-started must document the scaffold pin ~> 1.3"
+  exit 1
+end
+if readme.include?("once 1.1 is on RubyGems")
+  warn "FAIL test-new: README still says the gem is unpublished at 1.1"
+  exit 1
+end
+
 FileUtils.rm_rf(DEST)
 
 stdout, stderr, status = run_new(DEST.to_s)

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

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Shell accessibility (skip link and home-link name).
+# The top bar and footer used site.author alone, so a site with no author
+# exposed the accessible name " – Home" and hid the visible wordmark.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+SHELL = ROOT.join("_layouts/shell.html").read
+FOOTER = ROOT.join("_includes/page/site-footer.html").read
+CSS = ROOT.join("assets/css/ledger/chrome.css").read
+
+def fail!(message)
+  warn "FAIL test-shell-a11y: #{message}"
+  exit 1
+end
+
+fail!("missing skip link") unless SHELL.include?('class="skip-link"') && SHELL.include?('href="#page-content"')
+fail!("missing skip target") unless SHELL.include?('id="page-content"')
+fail!("skip link is not shown on focus") unless CSS.include?(".skip-link:focus")
+
+bare = 'aria-label="{{ site.author }} – Home"'
+fail!("shell home link still uses site.author alone") if SHELL.include?(bare)
+fail!("footer home link still uses site.author alone") if FOOTER.include?(bare)
+fail!("shell home link needs an identity.name fallback") unless SHELL.include?("site.pandorga.identity.name")
+fail!("footer home link needs an identity.name fallback") unless FOOTER.include?("site.pandorga.identity.name")
+
+puts "PASS test-shell-a11y"

data/scripts/test/test-template-packages.rb

@@ -46,6 +46,14 @@ TEMPLATES.each do |name|
   end
 end
 
+%w[_includes/chord-tab.html _includes/transcription.html].each do |rel|
+  text = ROOT.join(rel).read
+  if text.include?("Exibe")
+    warn "FAIL test-template-packages: #{rel} still has a Portuguese comment"
+    failed = true
+  end
+end
+
 exit 1 if failed
 
 puts "PASS test-template-packages"

data/scripts/test/test-validate-allowlist.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# A listed gate that is not on disk must fail the run. Skipping it lets a
+# renamed test disappear from CI while validate.sh still exits 0.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+SCRIPT = ROOT.join("scripts/validate.sh")
+
+def fail!(message)
+  warn "FAIL test-validate-allowlist: #{message}"
+  exit 1
+end
+
+source = SCRIPT.read
+block = source[/if \[\[ ! -f "\$test" \]\]; then.*?fi/m]
+fail!("missing-file branch not found") unless block
+fail!("a missing listed test must set failed=1") unless block.include?("failed=1")
+fail!("a missing listed test must not be skipped") if block.include?("skip")
+
+listed = source.scan(%r{scripts/test/test-[A-Za-z0-9_.-]+})
+fail!("allowlist is empty") if listed.empty?
+
+missing = listed.uniq.reject { |rel| ROOT.join(rel).file? }
+fail!("listed tests are not on disk: #{missing.join(', ')}") unless missing.empty?
+
+puts "PASS test-validate-allowlist"

data/scripts/validate.sh

@@ -51,15 +51,19 @@ TESTS=(
   scripts/test/test-absent-field-absent-element.rb
   scripts/test/test-ledger-blocks.rb
   scripts/test/test-home-band-art.rb
+  scripts/test/test-hero-name.rb
   scripts/test/test-r2-json-sync.rb
   scripts/test/test-writing-slug-limits.rb
   scripts/test/test-examples-build.rb
+  scripts/test/test-validate-allowlist.rb
+  scripts/test/test-shell-a11y.rb
 )
 
 failed=0
 for test in "${TESTS[@]}"; do
   if [[ ! -f "$test" ]]; then
-    echo "-- ${test} (missing, skip)"
+    echo "-- ${test} (missing)"
+    failed=1
     continue
   fi
   echo "-- ${test}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.4.9
+  version: 1.5.1
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -285,6 +285,7 @@ files:
 - lib/pandorga/jekyll/plugins/force_utf8_encoding.rb
 - lib/pandorga/jekyll/plugins/git_chronology.rb
 - lib/pandorga/jekyll/plugins/git_metadata.rb
+- lib/pandorga/jekyll/plugins/identity_name.rb
 - lib/pandorga/jekyll/plugins/job_sections.rb
 - lib/pandorga/jekyll/plugins/lib/content_validators.rb
 - lib/pandorga/jekyll/plugins/lib/resource_validator.rb
@@ -391,6 +392,7 @@ files:
 - scripts/test/test-exported-fields-reach-the-view.rb
 - scripts/test/test-form-control-theming.rb
 - scripts/test/test-git-chronology.rb
+- scripts/test/test-hero-name.rb
 - scripts/test/test-hero-portraits.mjs
 - scripts/test/test-hero-portraits.rb
 - scripts/test/test-home-band-art.rb
@@ -408,6 +410,7 @@ files:
 - scripts/test/test-r2-json-sync.rb
 - scripts/test/test-registry-home.rb
 - scripts/test/test-runtime-js-syntax.rb
+- scripts/test/test-shell-a11y.rb
 - scripts/test/test-slim-writing-index.rb
 - scripts/test/test-studio-api-contract.rb
 - scripts/test/test-studio-content-files.rb
@@ -423,6 +426,7 @@ files:
 - scripts/test/test-text-excerpt.rb
 - scripts/test/test-unwrap-media-src.mjs
 - scripts/test/test-unwrap-media-src.rb
+- scripts/test/test-validate-allowlist.rb
 - scripts/test/test-withdrawn-content-export.rb
 - scripts/test/test-writing-index-export-slugs.rb
 - scripts/test/test-writing-slug-limits.rb