pandorga 1.5.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eab1ea9696bdf99c28026f135762061c5a627ea398df5ddd8080f2d10dd9abc7
-  data.tar.gz: 89b13dcd397f666cf5660845d7ffece69478d6275b1d821d9500a4bf08046e5b
+  metadata.gz: c33cb11f60569d5280aa7079b6f59ad7776f90705f54f67d958d8b149390714d
+  data.tar.gz: 4a52dcb27be1f4d2a809417bc9b98e89e3c8aa8d92e642fca9ebab156942a192
 SHA512:
-  metadata.gz: e83aceb1f79cdd9f3ab201315b19532f3182cad64ed34ac4ed285be49f4257e4038a672aada1e6b7ce6b2ce7fb837749fc3eeb4347b99687f07fc2a33a8a6367
-  data.tar.gz: 7d987a05926fa2d9653faf04fc66585219430e57cd12d5383421aa9a32fcb6b1a52831fa4576f321e5392e482d6128bf4755cb36e237eb6ae8a1788f086848e3
+  metadata.gz: ecf8762ab684b723db57bb8d291609a3decf8ecae02f21b0158c3fd34afce67b9a34347255e790e26d480e8ef0b2eaab577dbe3d6ed571a02ce713cc5a2e09d9
+  data.tar.gz: 0c30da38132b4b87f2caf982a73f7c8eea1cf157600ecffb9b6f87e24fe289a47952fe3f9c8291c11719531a90cabd0149db89ba13b076c341a4eafabd6577b5

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # 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

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/shell.html

@@ -83,8 +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 %}
@@ -98,7 +100,7 @@
   <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">{{ _nav_name.wordmark }}</span>
         </a>
@@ -190,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

@@ -1498,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/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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pandorga
-  VERSION = "1.5.0"
+  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-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

@@ -55,12 +55,15 @@ TESTS=(
   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.5.0
+  version: 1.5.1
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -410,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
@@ -425,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