pandorga 1.6.7 → 1.6.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28483b04968177f92f86ee26292b1bca873db8515dcb0d1735b72be27a564fb8
-  data.tar.gz: d2d20eb68479f49655c122a3948398e8e2719a27be458e27bc6f60aa002729da
+  metadata.gz: 355770a826a6483d7fbc1e014c76fc0ef865d23bba44674cc2153d25ed840a9c
+  data.tar.gz: 6fd8451064d1a3bc58a8ff4ed53b90606183644756c28984018ff20ae485a543
 SHA512:
-  metadata.gz: 89dd79f11d075413daac4ebcda740dc4f36a426a8b11aa608570551a446c79b09fc2223a74d703a36c2cae2fdaf0a14f41b6e3cf0048261c336a3a2a082e0100
-  data.tar.gz: efeaa1c9b49c5884e19b0e778e1a7205eec1dd000dc3c8875fa62747cf3a5df813202310f2cd2092d4d71847d629e6e8d1fedbf63e6bff8c99245f568f1a73f2
+  metadata.gz: 331cf7a4687f241ee1b653e2435986bd511536ac3d1bfd21b65c91deef8969994999d8d65696e54a5725e7be41169d10ff9abac70475844a018480869cb19c1c
+  data.tar.gz: 88fc4c23d1cb5680b054c2e7028e374caab861977114ae235de52547b482de74b0c282957fc5bdf31764c9c3f11e39a65bbd4372ee7ee8fbf397b238b41f1c66

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [1.6.8] — 2026-10-10
+
+### Fixed
+
+- Home bands and the other listing pages fill again. Their scripts sit in
+  the page and used to run before the runtime existed, then return. The
+  titles stayed in the HTML and the lists stayed empty, on the phone and
+  on the desktop. Lighthouse scored that empty document. Those scripts
+  now start when the runtime is assigned. The runtime stays after the
+  page. The static hero summary, the deferred text faces, the deferred
+  markdown library, and the named icon subset stay as they are.
+- CI loads the built example home and fails when the projects, articles,
+  or posts band has no items after load, on a phone viewport and on a
+  desktop viewport.
+- On a phone, the featured card in the home Articles band has more space
+  above its text. The other article cards keep their padding. Article
+  titles in that band are 2pt larger.
+- On the Rascunhos page, the licence sits under the entries again below
+  1024px. The per-page stylesheet split had stopped loading the sheet
+  that ordered it, and the page's own `display: block` put it back on
+  top. The order now lives on the sheet the blog layout always loads.
+
+### Changed
+
+- The site and Studio launcher icons are the same stamp, on the same
+  plate, in the same pastel triad. The stamp is the same size on both,
+  with the same padding, at 512, 192, 180, and 32. Studio adds a small
+  badge inside that stamp. The build writes `/site.webmanifest` and
+  `/studio.webmanifest` with maskable icons, so Android masks both to
+  one shape and one visual size. The shell links the site manifest.
+  Studio links the studio manifest.
+
+No `pandorga:` config keys were added or renamed.
+
 ## [1.6.7] — 2026-10-10
 
 ### Fixed

data/README.md

@@ -85,8 +85,9 @@ and an urgent performance campaign must then bring it back to 90 or above.
 Below 75 is never acceptable for a release. A pull request or a merge may
 score lower when that is unavoidable to keep the work modular. The release
 build publishes at 90 or above. Notes that include `LIGHTHOUSE_BUGFIX=1`
-may publish a bug fix from 75 to 89. Pull requests and merges only warn.
-The checklist is in [CONTRIBUTING.md](CONTRIBUTING.md).
+may publish a bug fix from 75 to 89. Pull requests and merges only warn
+on the score. The same run fails when the loaded example home has no
+project or article items. The checklist is in [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 

data/_includes/page/content-runtime.html

@@ -17,4 +17,7 @@
 {% include content-runtime/43-blocks.html %}
 {% include content-runtime/90-bootstrap.html %}
   })();
+  /* Band and listing scripts sit in the page, so they run before this
+     assignment. They listen for the event and start once the runtime exists. */
+  document.dispatchEvent(new CustomEvent('pandorga:runtime'));
 </script>

data/_includes/page/network-graph.html

@@ -454,11 +454,14 @@
 
 <script src="https://cdn.jsdelivr.net/npm/d3@7.9.0/dist/d3.min.js"></script>
 <script>
-    (function () {
+    (function bootNetwork() {
         'use strict';
 
         var runtime = window.ContentRuntime;
-        if (!runtime || !runtime.ListingFilter) return;
+        if (!runtime || typeof runtime.loadJson !== 'function') {
+            document.addEventListener('pandorga:runtime', bootNetwork, { once: true });
+            return;
+        }
 
         var params = new URLSearchParams(window.location.search);
         var filterRoot = document.querySelector('[data-listing-filter-root]');

data/_includes/page/timeline-section.html

@@ -852,14 +852,26 @@
       var runtime = window.ContentRuntime;
       /* The content base is empty when the JSON is served from the site root
          (local preview), which is a valid source, not a missing one — gate on
-         the loader instead, and let the catch fall back to the inline stub. */
+         the loader instead, and let the catch fall back to the inline stub.
+         The runtime script follows the page, so the first call waits for it. */
       if (runtime && typeof runtime.loadJson === 'function') {
+        loadTimeline.started = true;
         runtime.loadJson('data/timeline.json').then(bootTimeline).catch(function (error) {
           console.error(error);
           if (el) bootTimeline(JSON.parse(el.textContent));
         });
         return;
       }
+      if (!loadTimeline.armed) {
+        loadTimeline.armed = true;
+        document.addEventListener('pandorga:runtime', loadTimeline, { once: true });
+        window.setTimeout(function () {
+          if (loadTimeline.started || !el) return;
+          loadTimeline.started = true;
+          bootTimeline(JSON.parse(el.textContent));
+        }, 0);
+        return;
+      }
       if (el) bootTimeline(JSON.parse(el.textContent));
     }
 

data/_includes/theme/favicons.html

@@ -1,4 +1,6 @@
 <link rel="icon" href="/assets/icons/favicon.svg" type="image/svg+xml" sizes="any" />
 <link rel="icon" href="/assets/icons/favicon-32.png" type="image/png" sizes="32x32" />
-<link rel="apple-touch-icon" href="/assets/icons/apple-touch-icon.png" />
+<link rel="apple-touch-icon" href="/assets/icons/apple-touch-icon.png" sizes="180x180" />
 <link rel="icon" href="/favicon.ico" sizes="16x16 32x32" />
+<link rel="manifest" href="/site.webmanifest" />
+<meta name="theme-color" content="#5e5d59" />

data/_layouts/articles.html

@@ -129,11 +129,14 @@ layout: shell
 {% include mathjax.html %}
 
 <script>
-  (function () {
+  (function bootArticles() {
     'use strict';
 
     var runtime = window.ContentRuntime;
-    if (!runtime || !runtime.ListingFilter) return;
+    if (!runtime || typeof runtime.loadJson !== 'function') {
+      document.addEventListener('pandorga:runtime', bootArticles, { once: true });
+      return;
+    }
 
     var configRoot = document.querySelector('[data-listing-collection]');
     var collection = (configRoot && configRoot.getAttribute('data-listing-collection')) || 'articles';

data/_layouts/bibliography.html

@@ -24,11 +24,14 @@ layout: shell
 </main>
 
 <script>
-  (function () {
+  (function bootBibliography() {
     'use strict';
 
     var runtime = window.ContentRuntime;
-    if (!runtime || !runtime.ListingFilter) return;
+    if (!runtime || typeof runtime.loadJson !== 'function') {
+      document.addEventListener('pandorga:runtime', bootBibliography, { once: true });
+      return;
+    }
 
     var listing = runtime.Listing;
     var params = new URLSearchParams(window.location.search);

data/_layouts/blog.html

@@ -93,11 +93,14 @@ layout: shell
 {% include mathjax.html %}
 
 <script>
-  (function () {
+  (function bootBlog() {
     'use strict';
 
     var runtime = window.ContentRuntime;
-    if (!runtime || !runtime.ListingFilter) return;
+    if (!runtime || typeof runtime.loadJson !== 'function') {
+      document.addEventListener('pandorga:runtime', bootBlog, { once: true });
+      return;
+    }
 
     var configRoot = document.querySelector('[data-listing-collection]');
     var collection = (configRoot && configRoot.getAttribute('data-listing-collection')) || 'posts';

data/_layouts/cv.html

@@ -80,11 +80,14 @@ layout: shell
 </main>
 
 <script>
-    (function () {
+    (function bootCv() {
         'use strict';
 
         var runtime = window.ContentRuntime;
-        if (!runtime) return;
+        if (!runtime || typeof runtime.loadJson !== 'function') {
+            document.addEventListener('pandorga:runtime', bootCv, { once: true });
+            return;
+        }
 
         var experienceList = document.getElementById('cv-experience-list');
         var educationList = document.getElementById('cv-education-list');

data/_layouts/home.html

@@ -63,8 +63,12 @@ layout: shell
     </div>
   </section>
   <script>
-    (function () {
+    (function bootHomePaint() {
       var runtime = window.ContentRuntime;
+      if (!runtime || typeof runtime.renderMarkdown !== 'function') {
+        document.addEventListener('pandorga:runtime', bootHomePaint, { once: true });
+        return;
+      }
       var pre = window.__pandorgaPreload || {};
       function paint(id, path) {
         var el = document.getElementById(id);
@@ -95,11 +99,14 @@ layout: shell
 
 <script>
   {% raw %}
-  (function () {
+  (function bootHomeBands() {
     'use strict';
 
     var runtime = window.ContentRuntime;
-    if (!runtime) return;
+    if (!runtime || typeof runtime.loadJson !== 'function') {
+      document.addEventListener('pandorga:runtime', bootHomeBands, { once: true });
+      return;
+    }
 
     function asItem(entry) {
       return {

data/_layouts/projects.html

@@ -59,11 +59,14 @@ layout: shell
 </main>
 
 <script>
-  (function () {
+  (function bootProjects() {
     'use strict';
 
     var runtime = window.ContentRuntime;
-    if (!runtime) return;
+    if (!runtime || typeof runtime.loadJson !== 'function') {
+      document.addEventListener('pandorga:runtime', bootProjects, { once: true });
+      return;
+    }
 
     var esc = runtime.escapeHtml;
     var escAttr = runtime.escapeAttr;

data/_layouts/resources.html

@@ -34,11 +34,14 @@ layout: shell
 </main>
 
 <script>
-  (function () {
+  (function bootResources() {
     'use strict';
 
     var runtime = window.ContentRuntime;
-    if (!runtime || !runtime.ListingFilter) return;
+    if (!runtime || typeof runtime.loadJson !== 'function') {
+      document.addEventListener('pandorga:runtime', bootResources, { once: true });
+      return;
+    }
 
     var configRoot = document.querySelector('[data-listing-collection]');
     var collection = (configRoot && configRoot.getAttribute('data-listing-collection')) || 'resources';

data/_layouts/shell.html

@@ -85,7 +85,12 @@
     {%- assign _ledger = "writing|detail" | split: "|" -%}
     {%- assign _article_css = true -%}
   {%- when "blog" -%}
-    {%- assign _ledger = "rascunhos|detail" | split: "|" -%}
+    {%- comment -%}
+      writing.css holds the rail, and it has to follow rascunhos.css. The
+      body rule in rascunhos.css is `display: block`, which would put the
+      licence back above the entries if it won the cascade.
+    {%- endcomment -%}
+    {%- assign _ledger = "rascunhos|writing|detail" | split: "|" -%}
     {%- assign _article_css = true -%}
   {%- when "cv" -%}
     {%- assign _ledger = "cv|detail" | split: "|" -%}

data/assets/css/ledger/home.css

@@ -740,6 +740,26 @@ html[data-theme="light"] .home-hero-plate {
   line-height: var(--home-featured-title-line);
 }
 
+/* Articles band only. Two points over the size the title already uses,
+   the same point step as the phone hero name. The section heading is
+   untouched. Listed cards in other bands are untouched. */
+[data-home-kind="articles"] .home-featured-title {
+  font-size: calc(var(--home-featured-title-size) + 2pt);
+}
+
+[data-home-kind="articles"] .home-card-grid .card-title,
+[data-home-kind="articles"] .home-card-grid .ledger-card-title {
+  font-size: calc(var(--type-card) + 2pt);
+}
+
+/* Phone only: the featured card's text sat against the top rule. One
+   step more than the shared top padding, and only on this card. */
+@media (max-width: 767px) {
+  [data-home-kind="articles"] .home-featured {
+    padding-top: calc(var(--space-md) + 0.75rem);
+  }
+}
+
 /* Home article / rascunho / project cards — content-title voice, not display. */
 .home-card-grid .ledger-card-title,
 .home-card-grid .card-title,

data/assets/css/ledger/rascunhos.css

@@ -66,8 +66,46 @@
   display: block;
 }
 
-/* `.hidden` swaps the listing for the detail view; it has to beat the grid. */
-.rascunhos-body.hidden {
+/* Below 1024px the rail is a disclosure above the ledger, and the licence
+   is a child of that rail, so source order paints it above the texts.
+   `writing.css` already sets this column, but the per-page split dropped
+   that sheet from the blog layout, and this `display: block` beats the
+   flex rule whenever rascunhos.css is the later file. The selector here is
+   more specific than that block display, so the licence stays under the
+   entries even if the sheet list changes again. */
+@media (max-width: 1023px) {
+  .rascunhos-main .rascunhos-body {
+    display: flex;
+    flex-direction: column;
+  }
+
+  .rascunhos-main .rascunhos-body>.writing-rail:not([hidden]) {
+    display: contents;
+  }
+
+  .rascunhos-main .rascunhos-body>.rascunhos-ledger {
+    order: 1;
+  }
+
+  .rascunhos-main .writing-rail-licence {
+    order: 2;
+    margin-top: var(--space-xl);
+    padding-top: var(--space-lg);
+    border-top: 1px solid var(--border-gentle-subtle);
+  }
+
+  .rascunhos-main .writing-rail-panel {
+    margin-bottom: var(--space-xl);
+  }
+
+  .rascunhos-main .writing-rail:has(> .writing-rail-panel[hidden]) .writing-rail-trigger {
+    margin-bottom: var(--space-xl);
+  }
+}
+
+/* `.hidden` swaps the listing for the detail view; it has to beat the
+   mobile flex column above, which is why the page class is on the selector. */
+.rascunhos-main .rascunhos-body.hidden {
   display: none;
 }
 

data/assets/icons/favicon.svg

@@ -0,0 +1,23 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img" aria-label="Site">
+  <title>Site</title>
+  <style>
+    /* Light plate: pastel triad on the dark frame. Dark plate: production triad
+       on the light frame. The mark stays inside the maskable safe zone. */
+    .primary { fill: #a4c8da; }
+    .secondary { fill: #95c8a6; }
+    .tertiary { fill: #ddd8a8; }
+    .plate { fill: #5e5d59; }
+    @media (prefers-color-scheme: dark) {
+      .primary { fill: #1c5a7a; }
+      .secondary { fill: #287445; }
+      .tertiary { fill: #746f30; }
+      .plate { fill: #b8b7ae; }
+    }
+  </style>
+  <rect class="plate" width="32" height="32"/>
+  <g transform="translate(7.68 7.68) scale(0.52)">
+    <polygon class="primary" points="0,0 23,0 15,17 0,20"/>
+    <polygon class="secondary" points="23,0 32,0 32,32 17,21 15,17"/>
+    <polygon class="tertiary" points="0,20 15,17 17,21 32,32 0,32"/>
+  </g>
+</svg>

data/assets/icons/studio-logo.svg

@@ -1,6 +1,26 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img" aria-hidden="true" focusable="false">
-  <polygon fill="#a4c8da" points="16,1 24,5 13,14 2,17 2,9"/>
-  <polygon fill="#95c8a6" points="24,5 30,9 30,23 22,28 19,18 13,14"/>
-  <polygon fill="#ddd8a8" points="2,17 13,14 19,18 22,28 16,31 2,23"/>
-  <polygon fill="none" stroke="#5e5d59" stroke-width="1" stroke-linejoin="miter" points="16,1 30,9 30,23 16,31 2,23 2,9"/>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img" aria-label="Studio">
+  <title>Studio</title>
+  <style>
+    /* Same stamp and plate as the site icon. The small badge is the only
+       difference. It stays inside the maskable safe zone. */
+    .primary { fill: #a4c8da; }
+    .secondary { fill: #95c8a6; }
+    .tertiary { fill: #ddd8a8; }
+    .plate { fill: #5e5d59; }
+    .badge { fill: #b8b7ae; }
+    @media (prefers-color-scheme: dark) {
+      .primary { fill: #1c5a7a; }
+      .secondary { fill: #287445; }
+      .tertiary { fill: #746f30; }
+      .plate { fill: #b8b7ae; }
+      .badge { fill: #5e5d59; }
+    }
+  </style>
+  <rect class="plate" width="32" height="32"/>
+  <g transform="translate(7.68 7.68) scale(0.52)">
+    <polygon class="primary" points="0,0 23,0 15,17 0,20"/>
+    <polygon class="secondary" points="23,0 32,0 32,32 17,21 15,17"/>
+    <polygon class="tertiary" points="0,20 15,17 17,21 32,32 0,32"/>
+  </g>
+  <rect class="badge" x="20.32" y="20.32" width="2.88" height="2.88"/>
 </svg>

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

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require "jekyll"
+require "json"
+
+module Pandorga
+  module Jekyll
+    # Writes the web app manifests the shell and Studio link. The icons are
+    # theme assets. A site file at the same path overrides an icon; the
+    # manifest itself is generated so the name follows the site identity.
+    class WebManifestGenerator < ::Jekyll::Generator
+      safe true
+      priority :low
+
+      def generate(site)
+        emit(site, "site.webmanifest", site_manifest(site))
+        emit(site, "studio.webmanifest", studio_manifest)
+      end
+
+      private
+
+      def emit(site, name, payload)
+        page = ::Jekyll::PageWithoutAFile.new(site, site.source, "", name)
+        page.data["layout"] = nil
+        page.data["sitemap"] = false
+        page.content = "#{JSON.pretty_generate(payload)}\n"
+        site.pages << page
+      end
+
+      def site_manifest(site)
+        config = site.config
+        pandorga = config["pandorga"].is_a?(Hash) ? config["pandorga"] : {}
+        identity = pandorga["identity"].is_a?(Hash) ? pandorga["identity"] : {}
+        name = identity["name"].to_s.strip
+        name = config["title"].to_s.strip if name.empty?
+        name = "Site" if name.empty?
+        short = identity["short_name"].to_s.strip
+        short = name if short.empty?
+        manifest("/", name, short, studio: false)
+      end
+
+      def studio_manifest
+        manifest("/studio/", "Studio", "Studio", studio: true)
+      end
+
+      def manifest(start, name, short, studio:)
+        {
+          "id" => start,
+          "name" => name,
+          "short_name" => short,
+          "start_url" => start,
+          "scope" => start,
+          "display" => "standalone",
+          "background_color" => "#5e5d59",
+          "theme_color" => "#5e5d59",
+          "icons" => icons(studio: studio)
+        }
+      end
+
+      # Stems match scripts/render-pwa-icons.py. The site maskable file is
+      # icon-maskable-*.png. Studio's is studio-maskable-*.png.
+      def icons(studio:)
+        any_stem = studio ? "studio-icon" : "icon"
+        mask_stem = studio ? "studio-maskable" : "icon-maskable"
+        [
+          [512, any_stem, "any"],
+          [512, mask_stem, "maskable"],
+          [192, any_stem, "any"],
+          [192, mask_stem, "maskable"]
+        ].map do |size, stem, purpose|
+          {
+            "src" => "/assets/icons/#{stem}-#{size}.png",
+            "sizes" => "#{size}x#{size}",
+            "type" => "image/png",
+            "purpose" => purpose
+          }
+        end
+      end
+    end
+  end
+end

data/lib/pandorga/version.rb

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