jekyll-uj-powertools 1.6.23 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8e4f51fc9ea4a48db55c09c67dc157e8ff10a2ac3ec70b0725cd691f22e8eeb
-  data.tar.gz: bd0025c8a7b871ce18e261c7b7a11d9eec2dfa756769905682eaecc681771d27
+  metadata.gz: 60803db8fb2a1e2c50aea11a0f49e964fc16d3323943ce0330f4312fd6468e37
+  data.tar.gz: 05f5ac27b7651b0d5592395cc510ba5b31e77f9b5ead9f35f0de6420d5919fd9
 SHA512:
-  metadata.gz: 265cb3b441bf454a72cb0dd80fd7357c8a775e91602969b8ed2f35068825baf3b48571fbbe7841ca801a694f17c2c7f2bb107a7c860af1c965e369448c4f6d2a
-  data.tar.gz: 60a90ebbfc3a02462063ade9848b1f58ed50596a525a6a1fd9d4547de89cb048dbd712e8b9f6dedfee86e1003365a021fc2a615a4a9938914c94d6901dc9e210
+  metadata.gz: 17bb830ad04f8be16741f99f9dcaab5f723b7c9bb58f1ffbdfa0bf9a9637c0357e829c82dd4dc13feee2e70773bde48cd71e1cface15873f7232a60ea6880f4c
+  data.tar.gz: 21c374abbaa0e43c40bf1ecda75ac52eda70dd33140c69c972bf352eca2d571c35c5d70485947275a639c46b7df8e235f496a2b678a29008722ebeadb9e4e62b

data/README.md

@@ -294,6 +294,90 @@ Creates language-specific URLs for multilingual sites.
 {% uj_translation_url target_lang, "/pricing" %}
 ```
 
+## Generators
+
+### Dynamic Pages Generator
+Automatically generate pages from collection data based on frontmatter fields. This is useful for creating category, tag, or any taxonomy pages dynamically without manually creating each page.
+
+#### Configuration
+Add to your `_config.yml`:
+
+```yaml
+generators:
+  collection_categories:
+    # Example 1: Extract category from nested frontmatter field
+    - collection: recipes
+      field: recipe.cuisine       # Dot notation for nested fields
+      layout: recipe-category
+      permalink: /recipes/:slug
+      title: ":name Recipes"
+      description: "Browse our collection of :name recipes."
+
+    # Example 2: Simple frontmatter field
+    - collection: products
+      field: category
+      layout: product-category
+      permalink: /products/:slug
+      title: ":name Products"
+      description: "Shop our :name products."
+
+    # Example 3: Minimal config (uses defaults)
+    - collection: articles
+      field: category
+      layout: article-category
+```
+
+#### Template Variables
+Use these placeholders in `title`, `description`, and `permalink`:
+- `:name` - The formatted category name (e.g., "Asian Cuisine")
+- `:slug` - The URL-safe slug (e.g., "asian-cuisine")
+
+#### Defaults
+- `permalink`: `/:collection/:slug` (e.g., `/recipes/asian`)
+- `title`: `:name`
+- `description`: `Browse our collection of :name.`
+
+#### Generated Page Data
+Each generated page includes the following data accessible in the layout:
+- `page.title` - The formatted title
+- `page.description` - The formatted description
+- `page.category_slug` - URL-safe slug (e.g., "asian-cuisine")
+- `page.category_name` - Human-readable name (e.g., "Asian Cuisine")
+- `page.collection_name` - Source collection name (e.g., "recipes")
+- `page.meta.title` - SEO title with site name appended
+- `page.meta.description` - SEO description
+
+#### Example Layout
+Create a layout file (e.g., `_layouts/recipe-category.html`) to display the category page:
+
+```liquid
+---
+layout: default
+---
+<h1>{{ page.category_name }}</h1>
+<p>{{ page.description }}</p>
+
+{% assign items = site.recipes | where_exp: "item", "item.recipe.cuisine == page.category_name" %}
+{% for item in items %}
+  <article>
+    <h2><a href="{{ item.url }}">{{ item.title }}</a></h2>
+  </article>
+{% endfor %}
+```
+
+## Development Config (`_config.dev.yml`)
+Speed up dev builds by limiting collections. Create `_config.dev.yml` in your Jekyll source:
+
+```yaml
+limit_collections:
+  recipes: 50
+  products: 20
+```
+
+Run with: `bundle exec jekyll serve --config _config.yml,_config.dev.yml`
+
+UJ auto-loads this file in dev mode.
+
 ## Final notes
 These examples show how you can use the features of `jekyll-uj-powertools` in your Jekyll site.
 

data/jekyll-uj-powertools.gemspec

@@ -5,7 +5,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 Gem::Specification.new do |spec|
   # Gem info
   spec.name = "jekyll-uj-powertools"
-  spec.version = "1.6.23"
+  spec.version = "1.7.0"
 
   # Author info
   spec.authors = ["ITW Creative Works"]

data/lib/generators/dynamic-pages.rb

@@ -0,0 +1,152 @@
+# Dynamic Pages Generator
+# Automatically generates pages from collection data based on config
+#
+# Usage in _config.yml:
+#
+#   generators:
+#     collection_categories:
+#       # Example 1: Extract category from frontmatter field
+#       - collection: recipes
+#         field: recipe.cuisine       # Dot notation for nested fields
+#         layout: recipe-category
+#         permalink: /recipes/:slug
+#         title: ":name Recipes"
+#         description: "Browse our collection of :name recipes."
+#
+#       # Example 2: Simple frontmatter field
+#       - collection: products
+#         field: category
+#         layout: product-category
+#         permalink: /products/:slug
+#         title: ":name Products"
+#         description: "Shop our :name products."
+#
+#       # Example 3: Minimal config (uses defaults)
+#       - collection: articles
+#         field: category
+#         layout: article-category
+#
+# Template variables for title/description/permalink:
+#   :name - The formatted category name (e.g., "Asian Cuisine")
+#   :slug - The URL-safe slug (e.g., "asian-cuisine")
+#
+# Defaults:
+#   permalink: /:collection/:slug (e.g., /recipes/asian)
+#   title: :name
+#   description: "Browse our collection of :name."
+
+module Jekyll
+  class DynamicPagesGenerator < Generator
+    safe true
+    priority :normal  # Run before InjectProperties (:low) so dynamic pages get resolved data
+
+    def generate(site)
+      config = site.config.dig('generators', 'collection_categories')
+      return unless config.is_a?(Array)
+
+      config.each do |category_config|
+        generate_category_pages(site, category_config)
+      end
+    end
+
+    private
+
+    def generate_category_pages(site, config)
+      collection_name = config['collection']
+      field = config['field']
+      return unless collection_name && field
+
+      collection = site.collections[collection_name]
+      return unless collection
+
+      # Configuration with defaults
+      layout = config['layout']
+      permalink_template = config['permalink'] || "/#{collection_name}/:slug"
+      title_template = config['title'] || ':name'
+      description_template = config['description'] || 'Browse our collection of :name.'
+
+      # Extract unique categories from documents
+      categories = {}
+
+      collection.docs.each do |doc|
+        category_value = dig_value(doc.data, field)
+        next unless category_value && !category_value.empty?
+
+        category_slug = slugify(category_value)
+        next if categories.key?(category_slug)
+
+        # Format category name: titleize
+        category_name = titleize(category_value)
+
+        # Apply templates
+        permalink = apply_template(permalink_template, category_name, category_slug)
+        title = apply_template(title_template, category_name, category_slug)
+        description = apply_template(description_template, category_name, category_slug)
+
+        categories[category_slug] = {
+          'slug' => category_slug,
+          'name' => category_name,
+          'title' => title,
+          'description' => description,
+          'permalink' => permalink
+        }
+      end
+
+      # Generate a page for each category
+      categories.each do |slug, data|
+        page = DynamicCategoryPage.new(site, layout, data, collection_name)
+        site.pages << page
+      end
+
+      Jekyll.logger.info "DynamicPages:", "Generated #{categories.size} category pages for '#{collection_name}'"
+    end
+
+    # Dig into nested hash using dot notation (e.g., "recipe.cuisine")
+    def dig_value(hash, field)
+      keys = field.split('.')
+      value = hash
+      keys.each do |key|
+        return nil unless value.is_a?(Hash)
+        value = value[key]
+      end
+      value.is_a?(String) ? value : nil
+    end
+
+    def slugify(str)
+      str.to_s.downcase.strip.gsub(/[^\w\s-]/, '').gsub(/[\s_]+/, '-')
+    end
+
+    def titleize(str)
+      str.to_s.split(/[\s_-]+/).map(&:capitalize).join(' ')
+    end
+
+    def apply_template(template, name, slug)
+      template.gsub(':name', name).gsub(':slug', slug)
+    end
+  end
+
+  # Custom page class for dynamically generated category pages
+  class DynamicCategoryPage < Page
+    def initialize(site, layout, data, collection_name)
+      @site = site
+      @base = site.source
+      @dir = ''
+      @name = "#{data['slug']}.html"
+
+      self.process(@name)
+      self.data = {
+        'layout' => layout,
+        'title' => data['title'],
+        'description' => data['description'],
+        'category_slug' => data['slug'],
+        'category_name' => data['name'],
+        'collection_name' => collection_name,
+        'permalink' => data['permalink'],
+        'meta' => {
+          'title' => "#{data['title']} - #{site.config.dig('brand', 'name') || site.config['title']}",
+          'description' => data['description']
+        }
+      }
+    end
+  end
+end

data/lib/generators/inject-properties.rb

@@ -5,7 +5,7 @@
 module Jekyll
   class InjectProperties < Generator
     safe true
-    priority :low
+    priority :lowest  # Run LAST so all pages from other generators exist before injecting resolved data
 
     def generate(site)
       # Define a global variable accessible in templates

data/lib/generators/limit-collections.rb

@@ -0,0 +1,56 @@
+# Limit Collections Generator
+# Limits the number of documents in collections during development for faster builds
+#
+# Usage in _config.dev.yml:
+#   limit_collections:
+#     recipes: 50
+#     products: 20
+#
+# By default, uses a seeded random sample for diverse selection across categories.
+# To disable randomization and take first N documents:
+#   limit_collections:
+#     recipes: 50
+#     products: 20
+#     randomize: false
+#
+# Run Jekyll with: bundle exec jekyll serve --config _config.yml,_config.dev.yml
+
+module Jekyll
+  class LimitCollectionsGenerator < Generator
+    safe true
+    priority :highest  # Run before other generators
+
+    def generate(site)
+      limits = site.config['limit_collections']
+      return unless limits.is_a?(Hash)
+
+      # Check if randomization is disabled (default: true)
+      randomize = limits.fetch('randomize', true)
+
+      limits.each do |collection_name, limit|
+        # Skip the 'randomize' option itself
+        next if collection_name == 'randomize'
+        next unless limit.is_a?(Integer) && limit > 0
+
+        collection = site.collections[collection_name]
+        next unless collection
+
+        original_count = collection.docs.size
+        next if original_count <= limit
+
+        if randomize
+          # Use a seeded random for repeatable but diverse sampling
+          # Seed based on collection name so it's consistent across rebuilds
+          rng = Random.new(collection_name.hash.abs)
+          sampled_docs = collection.docs.shuffle(random: rng).first(limit)
+          collection.docs.replace(sampled_docs)
+          Jekyll.logger.info "LimitCollections:", "Limited '#{collection_name}' from #{original_count} to #{limit} documents (random sample)"
+        else
+          # Take first N documents in order
+          collection.docs.replace(collection.docs.first(limit))
+          Jekyll.logger.info "LimitCollections:", "Limited '#{collection_name}' from #{original_count} to #{limit} documents"
+        end
+      end
+    end
+  end
+end

data/lib/jekyll-uj-powertools.rb

@@ -6,8 +6,10 @@ module Jekyll
   require_relative "filters/main"
 
   # Load Generators
+  require_relative "generators/limit-collections"
   require_relative "generators/inject-properties"
   require_relative "generators/blog-taxonomy"
+  require_relative "generators/dynamic-pages"
 
   # Load Hooks
   require_relative "hooks/inject-properties"

data/lib/tags/logo.rb

@@ -5,12 +5,15 @@ require_relative '../helpers/variable_resolver'
 module Jekyll
   class UJLogoTag < Liquid::Tag
     include UJPowertools::VariableResolver
-    
+
     # Default logo to show when requested logo is not found
     DEFAULT_LOGO = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 640"><!--!Font Awesome Free v7.0.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d="M320 64C334.7 64 348.2 72.1 355.2 85L571.2 485C577.9 497.4 577.6 512.4 570.4 524.5C563.2 536.6 550.1 544 536 544L104 544C89.9 544 76.9 536.6 69.6 524.5C62.3 512.4 62.1 497.4 68.8 485L284.8 85C291.8 72.1 305.3 64 320 64zM320 232C306.7 232 296 242.7 296 256L296 368C296 381.3 306.7 392 320 392C333.3 392 344 381.3 344 368L344 256C344 242.7 333.3 232 320 232zM346.7 448C347.3 438.1 342.4 428.7 333.9 423.5C325.4 418.4 314.7 418.4 306.2 423.5C297.7 428.7 292.8 438.1 293.4 448C292.8 457.9 297.7 467.3 306.2 472.5C314.7 477.6 325.4 477.6 333.9 472.5C342.4 467.3 347.3 457.9 346.7 448z"/></svg>'
-    
-    # Cache for loaded logos to improve performance
+
+    # Cache for loaded logos (raw SVG content) to improve performance
     @@logo_cache = {}
+
+    # Counter for generating unique prefixes per logo instance
+    @@instance_counter = 0
     
     def initialize(tag_name, markup, tokens)
       super
@@ -63,22 +66,27 @@ module Jekyll
       # Get site from context
       site = context.registers[:site]
       return '' unless site
-      
-      # Load the logo SVG from file
-      logo_svg = load_logo_from_file(logo_name.to_s, type, color)
-      return '' unless logo_svg
-      
-      # Return the SVG directly
-      logo_svg
+
+      # Load the raw logo SVG from file (cached)
+      raw_svg = load_logo_from_file(logo_name.to_s, type, color)
+      return '' unless raw_svg
+
+      # Generate unique prefix for this instance to prevent ID conflicts
+      # when the same logo is used multiple times on a page
+      @@instance_counter += 1
+      unique_prefix = "#{logo_name}-#{@@instance_counter}"
+
+      # Prefix all IDs with unique prefix
+      prefix_svg_ids(raw_svg, unique_prefix)
     end
-    
+
     private
-    
+
     def load_logo_from_file(logo_name, type, color)
       # Create cache key
       cache_key = "#{type}/#{color}/#{logo_name}"
 
-      # Return cached version if available
+      # Return cached version if available (raw SVG without prefixing)
       return @@logo_cache[cache_key] if @@logo_cache.key?(cache_key)
 
       # Build file path
@@ -91,10 +99,7 @@ module Jekyll
                    DEFAULT_LOGO
                  end
 
-      # Prefix all IDs to prevent conflicts when multiple SVGs are on the same page
-      logo_svg = prefix_svg_ids(logo_svg, logo_name)
-
-      # Cache the result
+      # Cache the raw result (before prefixing)
       @@logo_cache[cache_key] = logo_svg
       return logo_svg
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-uj-powertools
 version: !ruby/object:Gem::Version
-  version: 1.6.23
+  version: 1.7.0
 platform: ruby
 authors:
 - ITW Creative Works
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-17 00:00:00.000000000 Z
+date: 2025-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -115,7 +115,9 @@ files:
 - jekyll-uj-powertools.gemspec
 - lib/filters/main.rb
 - lib/generators/blog-taxonomy.rb
+- lib/generators/dynamic-pages.rb
 - lib/generators/inject-properties.rb
+- lib/generators/limit-collections.rb
 - lib/helpers/variable_resolver.rb
 - lib/hooks/inject-properties.rb
 - lib/hooks/markdown-images.rb