pandorga 1.11.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d3adc84d250c4ff140df5b9cc9db266896fdfce92fd899789fd943ce8ac4659
-  data.tar.gz: 474d788dea7851796fb189732c9bb75d118666177f4cf81df70d8361f4310872
+  metadata.gz: c03095737ae31747d865ba734912bb725e2d88586405dd847c63d340b42bbfa3
+  data.tar.gz: 764bc60f9ef00c00e33391511a7cb5680438660dd5a622af0801add004670f31
 SHA512:
-  metadata.gz: d9e76b0be8485c3870366cce0bc816fc55f3dee7ea2b17ec40602f2c70dccbf985e2d7be6da7911e54a7f830c6fd3c4030dbb985689d50c84cb9226c04cd0f2e
-  data.tar.gz: 6853fe1a1d0edd4066d45187a4cddd67258a753afd849284615383fb9cae4844a24aabff188681a73066e2808170bfc1e28730832e68d976c34400899d2cea88
+  metadata.gz: 392a4fbde9ea59d1b7dfea8206f45c81f6d104d3b70efcb9a6c67afa21fc9738eefc589b537c8e045bdf7cdb13527ade3ec8c3a1d5683ff0c4f5134a72743dbc
+  data.tar.gz: 44b0d25b56e010e2ce1d2106c3a2c688a5b3ee61c322b55f39c89beca4d9821c31f5942de335f351289bab176a6752c809205ae7aae97f517351003eb71ce0a5

data/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [Unreleased]
 
+## [1.13.0] — 2026-10-19
+
+### Added
+
+- `pandorga export` and the new `pandorga thumbnails [root]` command write 16:9 center-cropped width variants (`variants/<stem>-{480,960,1440}.jpg`, progressive JPEG at quality 82, stripped of metadata, never upscaled) beside each local `/media/...` project thumbnail when ImageMagick is installed (logging one warning otherwise), export `thumbnail_srcset` on project front matter and `writing_index.json`, and render `srcset` and `sizes` on project cards and the home specimen (PLT-AC-44).
+
+## [1.12.0] — 2026-10-19
+
+### Changed
+
+- `pandorga install-functions` fills the Studio tag pickers from the site's `_config.yml` → `pandorga.taxonomies` (with `min` and `max`), falling back to a page's `taxonomy`, then applies `studio.overrides.yml`. The gem's `studio/schema.yml` no longer ships a site's tag vocabulary; a collection without one gets an empty picker and a build warning (PLT-AC-43).
+
 ## [1.11.0] — 2026-10-19
 
 ### Fixed

data/DESIGN.md

@@ -1201,14 +1201,12 @@ discs.
 An element renders only if a populated field backs it. The classification axes,
 as enforced by [`_plugins/lib/tag_validator.rb`](_plugins/lib/tag_validator.rb):
 
-* **Articles** classify on `tags`, one to three, from a closed English
-  vocabulary: `Aesthetics`, `AI`, `Data`, `DevOps`, `Mathematics`,
-  `Robotics`, `Social`. All 22 carry them.
-* **Rascunhos** classify on `tags` too, by subject and in Portuguese, **zero to
-  three**: `arte`, `brasilidade`, `carme`, `devaneio`, `engraçadinho`,
-  `música`, `pesquisa`, `provocação`, `técnico`, `trabalho`. Unlike articles
-  the field may be empty — a notebook holds pages that file nowhere. 29 of 30
-  carry at least one.
+* **Articles** classify on `tags`, one to three, from the closed vocabulary
+  the site declares in `_config.yml` → `pandorga.taxonomies`.
+* **Rascunhos** classify on `tags` too, **zero to three**, from the closed
+  vocabulary the site declares in `_config.yml` → `pandorga.taxonomies`.
+  Unlike articles the field may be empty — a notebook holds pages that file
+  nowhere.
 * `category` is rejected on both collections — one classification axis, not
   two.
 * **Projects** carry free `tags` (all 8 do), plus `label`, `status`,

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

@@ -300,7 +300,7 @@
      *
      * A video URL still renders rather than vanishing, but it downloads
      * nothing until the reader asks for it. */
-    function renderPosterMedia(src, alt) {
+    function renderPosterMedia(src, alt, options) {
       var url = String(src || '').trim();
       if (!url) return '';
       var isVideo = /\.(mp4|webm|mov)(\?|#|$)/i.test(url);
@@ -312,9 +312,15 @@
           '</div>'
         ].join('');
       }
+      var opts = options || {};
+      var srcset = String(opts.srcset || '').trim();
+      var sizes = String(opts.sizes || '').trim();
       return [
         '<div class="ledger-poster">',
-        '<img src="', escapeAttr(url), '" alt="', escapeAttr(alt || ''),
+        '<img src="', escapeAttr(url), '"',
+        srcset ? ' srcset="' + escapeAttr(srcset) + '"' : '',
+        (srcset && sizes) ? ' sizes="' + escapeAttr(sizes) + '"' : '',
+        ' alt="', escapeAttr(alt || ''),
         '" loading="lazy" decoding="async"',
         // Thumbnails are frequently hotlinked to third-party hosts. When one
         // dies, remove the frame rather than leaving an empty plate behind.
@@ -324,6 +330,16 @@
       ].join('');
     }
 
+    /* Project thumbnail sizes (PLT-AC-44):
+     * - Home specimen (home.css PLT-AC-41): >= 900px column is max(35%, 20rem)
+     *   inside max-width 80rem (1408px at html 110%), minus card padding =>
+     *   ~431 CSS px at 1440px viewport (31vw = 446px -> 480w at DPR 1, 960w at
+     *   DPR 2); below 900px full band width (390px at DPR 2 = 780px -> 960w).
+     * - Projects grid card (projects.css): 3 cols >= 1024px (~384px -> 28vw),
+     *   2 cols >= 700px (~46vw), 1 col below (92vw). */
+    var PROJECT_CARD_SIZES = '(min-width: 1024px) 28vw, (min-width: 700px) 46vw, 92vw';
+    var HOME_SPECIMEN_SIZES = '(min-width: 900px) 31vw, 92vw';
+
     function twoDigits(value) {
       var label = String(Number(value));
       return label.length < 2 ? '0' + label : label;
@@ -418,7 +434,10 @@
       if (options.frameCorners) {
         html += '<span class="ledger-frame-corners" aria-hidden="true"></span>';
       }
-      var poster = renderPosterMedia(fm.thumbnail, name);
+      var poster = renderPosterMedia(fm.thumbnail, name, {
+        srcset: fm.thumbnail_srcset,
+        sizes: options.sizes || PROJECT_CARD_SIZES
+      });
       if (poster) {
         html += poster;
       } else if (options.glyphFallback && fm.icon) {
@@ -501,7 +520,10 @@
       var mark = fm.icon
         ? { cls: 'material-symbols-outlined', text: fm.icon }
         : { cls: 'is-initial', text: String(name || '').charAt(0).toUpperCase() };
-      var poster = renderPosterMedia(fm.thumbnail, name);
+      var poster = renderPosterMedia(fm.thumbnail, name, {
+        srcset: fm.thumbnail_srcset,
+        sizes: options.sizes || HOME_SPECIMEN_SIZES
+      });
       html += '<div class="home-specimen-figure">';
       if (poster) {
         html += poster + '<span class="home-specimen-badge ' + mark.cls + '" aria-hidden="true">' +

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

@@ -140,6 +140,7 @@
           description: entry.description,
           excerpt: entry.excerpt,
           thumbnail: entry.thumbnail,
+          thumbnail_srcset: entry.thumbnail_srcset,
           language: entry.language,
           date: entry.date,
           last_updated: entry.last_updated,

data/_layouts/projects.html

@@ -154,7 +154,13 @@ layout: shell
        imagery still reads as finished rather than as broken. */
     function plateHtml(item, modifier) {
       var fm = item.front_matter || {};
-      var poster = runtime.renderPosterMedia(fm.thumbnail, projectName(item));
+      var sizes = modifier === 'projects-plate--card'
+        ? '(min-width: 1024px) 28vw, (min-width: 700px) 46vw, 92vw'
+        : '(min-width: 900px) 38vw, 92vw';
+      var poster = runtime.renderPosterMedia(fm.thumbnail, projectName(item), {
+        srcset: fm.thumbnail_srcset,
+        sizes: sizes
+      });
       var cls = 'projects-plate' + (modifier ? ' ' + modifier : '');
       if (poster) return '<div class="' + cls + '">' + poster + '</div>';
       if (!fm.icon) return '';

data/lib/pandorga/cli.rb

@@ -7,6 +7,7 @@ require_relative "commands/publish"
 require_relative "commands/install_functions"
 require_relative "commands/studio_schema"
 require_relative "commands/new"
+require_relative "commands/thumbnails"
 
 module Pandorga
   # Dispatch for `exe/pandorga`.
@@ -18,7 +19,8 @@ module Pandorga
       "serve" => Commands::Serve,
       "publish" => Commands::Publish,
       "install-functions" => Commands::InstallFunctions,
-      "studio-schema" => Commands::StudioSchema
+      "studio-schema" => Commands::StudioSchema,
+      "thumbnails" => Commands::Thumbnails
     }.freeze
 
     module_function
@@ -52,6 +54,7 @@ module Pandorga
           pandorga new PATH               Scaffold a site from the minimal example
           pandorga doctor                 Check site config and environment
           pandorga export [src] [dest]    Export content collections to JSON
+          pandorga thumbnails [root]      Write 16:9 width variants for project thumbnails
           pandorga serve                  Local Jekyll serve with JSON re-export
           pandorga publish                Sync content JSON to R2
           pandorga install-functions      Copy functions/ and studio/ into site root

data/lib/pandorga/commands/install_functions.rb

@@ -1,12 +1,16 @@
 # frozen_string_literal: true
 
+require "date"
 require "fileutils"
 require "pathname"
+require "yaml"
+require "pandorga/commands/studio_schema"
 
 module Pandorga
   module Commands
     # Option A (PLT-0.2): copy functions/ and studio/ from the gem into the site root
-    # so Cloudflare Pages can compile Functions from the project root.
+    # so Cloudflare Pages can compile Functions from the project root, then apply
+    # site taxonomies and overrides to studio/schema.yml (PLT-AC-43).
     class InstallFunctions
       STAMP = ".pandorga-version"
 
@@ -22,6 +26,7 @@ module Pandorga
 
         copy_tree(gem_functions, dest_root.join("functions"))
         copy_tree(gem_studio, dest_root.join("studio")) if gem_studio.directory?
+        hydrate_studio_schema(dest_root)
 
         stamp = dest_root.join("functions", STAMP)
         stamp.write("#{Pandorga::VERSION}\n")
@@ -36,6 +41,36 @@ module Pandorga
         FileUtils.mkdir_p(dest.dirname)
         FileUtils.cp_r(src, dest)
       end
+
+      def hydrate_studio_schema(dest_root)
+        config_path = dest_root.join("_config.yml")
+        schema_path = dest_root.join("studio", "schema.yml")
+        return unless config_path.file? && schema_path.file?
+
+        config = load_yaml(config_path)
+        schema = load_yaml(schema_path)
+        return unless schema.is_a?(Hash)
+
+        missing = StudioSchema.apply_taxonomies!(schema, config)
+
+        overrides_path = dest_root.join("studio.overrides.yml")
+        if overrides_path.file?
+          extra = load_yaml(overrides_path)
+          StudioSchema.apply_overrides!(schema, extra) if extra.is_a?(Hash)
+        end
+
+        header = "# Installed by pandorga install-functions #{Pandorga::VERSION}; " \
+                 "tag vocabularies come from _config.yml pandorga.taxonomies.\n"
+        schema_path.write("#{header}#{YAML.dump(schema)}")
+
+        missing.each do |name|
+          warn "pandorga install-functions: warning: no taxonomy for #{name}; its Studio tags picker is empty"
+        end
+      end
+
+      def load_yaml(path)
+        YAML.safe_load(path.read, permitted_classes: [Date, Time], aliases: true) || {}
+      end
     end
   end
 end

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

data/lib/pandorga/commands/studio_schema.rb

@@ -8,7 +8,7 @@ require "date"
 module Pandorga
   module Commands
     # Compose studio/schema.yml from template studio.yml files + registry.
-    # Refs: PLT-AC-3, docs/spec.md §5.5
+    # Refs: PLT-AC-3, PLT-AC-43, docs/spec.md §5.5
     class StudioSchema
       DEFAULT_MEDIA = {
         "name" => "media",
@@ -28,6 +28,14 @@ module Pandorga
         "options" => { "format" => "markdown" }
       }.freeze
 
+      def self.apply_taxonomies!(schema, config)
+        new.apply_taxonomies!(schema, config)
+      end
+
+      def self.apply_overrides!(schema, extra)
+        new.apply_overrides!(schema, extra)
+      end
+
       def run(argv)
         root = Pathname.new(argv[0] || Dir.pwd).expand_path
         templates_root = Pathname.new(Pandorga.gem_path("templates"))
@@ -56,7 +64,6 @@ module Pandorga
       # Public for gates: build the schema hash without writing.
       def compose(config, templates_root)
         pages = config.dig("pandorga", "pages") || []
-        taxonomies = config.dig("pandorga", "taxonomies") || {}
         groups = {}
         group_order = []
         needs_media = false
@@ -76,7 +83,7 @@ module Pandorga
           next unless fragment.is_a?(Hash)
 
           needs_media ||= truthy?(fragment["needs_media"])
-          contributions = expand_fragment(fragment, page, taxonomies)
+          contributions = expand_fragment(fragment, page)
           contributions.each do |contrib|
             group_name = contrib[:group]
             unless groups.key?(group_name)
@@ -110,12 +117,88 @@ module Pandorga
         if needs_markdown
           schema["components"] = { "markdown_body" => deep_dup(DEFAULT_MARKDOWN_BODY) }
         end
+        apply_taxonomies!(schema, config)
         schema
       end
 
+      def apply_taxonomies!(schema, config)
+        return [] unless schema.is_a?(Hash)
+
+        vocabularies = resolve_taxonomies(config)
+        missing = []
+
+        Array(schema["content"]).each do |group|
+          next unless group.is_a?(Hash)
+
+          Array(group["items"]).each do |item|
+            next unless item.is_a?(Hash)
+            next unless item["type"].to_s == "collection"
+
+            name = item["name"].to_s
+            next if name.empty?
+
+            had_picker = apply_collection_taxonomy!(item, vocabularies[name])
+            missing << name if had_picker && !vocabularies.key?(name)
+          end
+        end
+
+        index = schema["collections"].is_a?(Hash) ? schema["collections"] : {}
+        index.each do |key, entry|
+          next unless entry.is_a?(Hash)
+
+          name = entry["name"].to_s.empty? ? key.to_s : entry["name"].to_s
+          next if name.empty?
+
+          had_picker = apply_collection_taxonomy!(entry, vocabularies[name])
+          missing << name if had_picker && !vocabularies.key?(name)
+        end
+
+        missing.uniq
+      end
+
+      def apply_overrides!(schema, extra)
+        if extra["media"].is_a?(Hash)
+          schema["media"] = deep_merge(schema["media"] || {}, extra["media"])
+        end
+
+        if extra["components"].is_a?(Hash)
+          schema["components"] = deep_merge(schema["components"] || {}, extra["components"])
+        end
+
+        if extra["collections"].is_a?(Hash)
+          extra["collections"].each do |name, patch|
+            next unless patch.is_a?(Hash)
+
+            item = find_content_item(schema, name.to_s)
+            if item
+              merged = deep_merge(item, patch)
+              item.replace(merged)
+            end
+            if schema["collections"].is_a?(Hash) && schema["collections"][name.to_s]
+              schema["collections"][name.to_s] =
+                deep_merge(schema["collections"][name.to_s], patch)
+            end
+          end
+        end
+
+        return unless extra["content"].is_a?(Array)
+
+        schema["content"] ||= []
+        extra["content"].each do |group|
+          next unless group.is_a?(Hash)
+
+          existing = schema["content"].find { |g| g["name"].to_s == group["name"].to_s }
+          if existing
+            existing.replace(deep_merge(existing, group))
+          else
+            schema["content"] << deep_dup(group)
+          end
+        end
+      end
+
       private
 
-      def expand_fragment(fragment, page, taxonomies)
+      def expand_fragment(fragment, page)
         contributions = []
         default_group = fragment["group"].to_s
         default_group = page["template"].to_s if default_group.empty?
@@ -127,12 +210,7 @@ module Pandorga
         if fragment["collection"].is_a?(Hash)
           name = page["collection"].to_s
           unless name.empty?
-            items << instantiate_collection(
-              fragment["collection"],
-              name,
-              page,
-              taxonomies
-            )
+            items << instantiate_collection(fragment["collection"], name, page)
           end
         end
 
@@ -145,7 +223,7 @@ module Pandorga
             name = slot.to_s if name.empty?
             next if name.empty? || name == "data" || name == "profile"
 
-            items << instantiate_collection(spec, name, page, taxonomies)
+            items << instantiate_collection(spec, name, page)
           end
         end
 
@@ -178,7 +256,7 @@ module Pandorga
         contributions
       end
 
-      def instantiate_collection(spec, name, page, taxonomies)
+      def instantiate_collection(spec, name, page)
         entry = deep_dup(spec)
         entry["name"] = name
         entry["type"] ||= "collection"
@@ -189,66 +267,96 @@ module Pandorga
         end
         entry["path"] ||= "content/collections/#{name}"
         entry["path"] = entry["path"].to_s.gsub("{collection}", name)
-        apply_taxonomy!(entry, name, taxonomies)
         entry
       end
 
-      def apply_taxonomy!(entry, collection_name, taxonomies)
-        tax = taxonomies[collection_name]
-        return unless tax.is_a?(Hash)
+      def resolve_taxonomies(config)
+        return {} unless config.is_a?(Hash)
 
-        Array(entry["fields"]).each do |field|
-          next unless field.is_a?(Hash)
-          next unless field["name"].to_s == "tags"
+        vocab = {}
+        pages = Array(config.dig("pandorga", "pages")).select { |p| p.is_a?(Hash) }
+        taxonomies = config.dig("pandorga", "taxonomies")
 
-          field["options"] ||= {}
-          next unless field["options"].is_a?(Hash)
+        if taxonomies.is_a?(Hash)
+          taxonomies.each do |collection, spec|
+            next unless spec.is_a?(Hash)
 
-          tags = tax["tags"]
-          field["options"]["values"] = tags if tags.is_a?(Array) && !tags.empty?
-          max = tax["max"]
-          field["options"]["max"] = max if max
-        end
-      end
+            tags = spec["tags"]
+            next unless tags.is_a?(Array) && !tags.empty?
 
-      def apply_overrides!(schema, extra)
-        if extra["media"].is_a?(Hash)
-          schema["media"] = deep_merge(schema["media"] || {}, extra["media"])
-        end
+            coll_name = collection.to_s
+            page_tax = pages.find { |p| p["collection"].to_s == coll_name }&.fetch("taxonomy", nil)
+            page_tax = nil unless page_tax.is_a?(Hash)
 
-        if extra["components"].is_a?(Hash)
-          schema["components"] = deep_merge(schema["components"] || {}, extra["components"])
+            max = spec["max"].nil? ? page_tax&.fetch("max", nil) : spec["max"]
+            min = spec["min"].nil? ? page_tax&.fetch("min", nil) : spec["min"]
+
+            vocab[coll_name] = build_taxonomy_entry(tags, max: max, min: min)
+          end
         end
 
-        if extra["collections"].is_a?(Hash)
-          extra["collections"].each do |name, patch|
-            next unless patch.is_a?(Hash)
+        pages.each do |page|
+          coll_name = page["collection"].to_s
+          next if coll_name.empty? || vocab.key?(coll_name)
 
-            item = find_content_item(schema, name.to_s)
-            if item
-              merged = deep_merge(item, patch)
-              item.replace(merged)
-            end
-            if schema["collections"].is_a?(Hash) && schema["collections"][name.to_s]
-              schema["collections"][name.to_s] =
-                deep_merge(schema["collections"][name.to_s], patch)
-            end
-          end
+          spec = page["taxonomy"]
+          next unless spec.is_a?(Hash)
+
+          tags = spec["tags"]
+          next unless tags.is_a?(Array) && !tags.empty?
+
+          vocab[coll_name] = build_taxonomy_entry(tags, max: spec["max"], min: spec["min"])
         end
 
-        return unless extra["content"].is_a?(Array)
+        vocab
+      end
 
-        schema["content"] ||= []
-        extra["content"].each do |group|
-          next unless group.is_a?(Hash)
+      def build_taxonomy_entry(tags, max:, min:)
+        entry = { "tags" => tags.map(&:to_s) }
+        parsed_max = parse_int_or_nil(max)
+        parsed_min = parse_int_or_nil(min)
+        entry["max"] = parsed_max unless parsed_max.nil?
+        entry["min"] = parsed_min unless parsed_min.nil?
+        entry
+      end
 
-          existing = schema["content"].find { |g| g["name"].to_s == group["name"].to_s }
-          if existing
-            existing.replace(deep_merge(existing, group))
+      def parse_int_or_nil(val)
+        return nil if val.nil?
+
+        Integer(val)
+      rescue ArgumentError, TypeError
+        nil
+      end
+
+      def apply_collection_taxonomy!(entry, tax)
+        had_picker = false
+        Array(entry["fields"]).each do |field|
+          next unless tag_picker_field?(field)
+
+          had_picker = true
+          field["options"] = {} unless field["options"].is_a?(Hash)
+          opts = field["options"]
+
+          if tax.is_a?(Hash)
+            opts["values"] = Array(tax["tags"]).map(&:to_s)
+            opts["max"] = tax["max"] unless tax["max"].nil?
+            if tax["min"].nil?
+              opts.delete("min")
+            else
+              opts["min"] = tax["min"]
+            end
           else
-            schema["content"] << deep_dup(group)
+            opts["values"] = []
+            opts.delete("min")
           end
         end
+        had_picker
+      end
+
+      def tag_picker_field?(field)
+        field.is_a?(Hash) &&
+          field["name"].to_s == "tags" &&
+          field["type"].to_s == "select"
       end
 
       def find_content_item(schema, name)

data/lib/pandorga/commands/thumbnails.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "pathname"
+require_relative "../thumbnail_variants"
+
+module Pandorga
+  module Commands
+    # Generate 16:9 center-cropped width variants for local project thumbnails.
+    # Refs: PLT-AC-44
+    class Thumbnails
+      def run(argv)
+        site_root = Pathname.new(argv[0] || Dir.pwd).expand_path
+        summary = Pandorga::ThumbnailVariants.generate(site_root)
+        puts "pandorga thumbnails: #{summary[:written]} written, #{summary[:skipped]} skipped (#{summary[:sources]} sources in #{site_root})"
+        0
+      end
+    end
+  end
+end

data/lib/pandorga/registry/schema.yml

@@ -79,7 +79,7 @@ taxonomies:
   prose: |
     Closed tag vocabularies per collection (`tags`, `max`, `min`). Page-local
     `pandorga.pages[].taxonomy` is also accepted when a collection has no top-level
-    entry.
+    entry. `pandorga install-functions` copies these vocabularies into the installed Studio schema (`studio/schema.yml`), so the Studio tag pickers always offer this list. A collection with no vocabulary gets an empty picker and a warning.
 
 pages:
   title: "`pandorga.pages[]`"