jekyll-uj-powertools 1.7.11 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b58316def5bdf1f88a2feb03a14b4c2857e5530eead4f39d246068fbf474cf94
-  data.tar.gz: 0ef67cae823576783e197c3557d798420dc341784d3199d7ad8ec8a285f3cf29
+  metadata.gz: b5d3b0b5e6420c4de7821fe8f925fff59712eb31b9244feccf0291a42f2f7f9b
+  data.tar.gz: 38aae313ca04d6eb74c7248eebe7fbb2f7e1c00d5e8c21636d0683778f9233ab
 SHA512:
-  metadata.gz: 0e7beb32662dc8dadb479c3f06a17b3c48f930dc09c1bf16a7bf56c826f41fdd1f96ab091b8a849a50aa0706eebeced5b11e91ebe139fd105f517a951eff6d3c
-  data.tar.gz: 0b16685b292e37358bfa76721a71778a7b1a629ee6d03a94083aa0db5fae6b48044e89620c48741f2bea17073ccb3e6228b545084e944f908ab509bd391040e4
+  metadata.gz: b291387665a874e83e9dcc7e60db4f344ca26cab3c22d112a53412abb0f2ebe06c6fc917eb3e52ad08702367901f15e32aa1c113fd3d5f95b7ff09d7b2257ca4
+  data.tar.gz: 7178018a7fb28c365aaa354d0003020868c9f09f5f56b5c4f657b50ac8995ab72537a510393e6de11c02212064415222859db0839b5fcabcd452f97f86c4a58c

data/README.md

@@ -106,6 +106,28 @@ Format numbers with commas for better readability (e.g., 10000 becomes 10,000).
 <!-- Output: 1,234.56 -->
 ```
 
+### `uj_append_param` Filter
+Intelligently append a query parameter to a URL, using `?` or `&` depending on whether the URL already has a query string.
+
+```liquid
+{{ "https://example.com/img.png" | uj_append_param: "cb", "123" }}
+<!-- Output: https://example.com/img.png?cb=123 -->
+
+{{ "https://example.com/img.png?w=200" | uj_append_param: "cb", "123" }}
+<!-- Output: https://example.com/img.png?w=200&cb=123 -->
+```
+
+### `uj_cachebreak` Filter
+Append a cache-busting query parameter (`cb=<timestamp>`) to any URL. Uses the same consistent timestamp as `site.uj.cache_breaker`. Handles URLs with or without existing query strings.
+
+```liquid
+{{ site.brand.images.brandmark | uj_cachebreak }}
+<!-- Output: https://cdn.example.com/logo.svg?cb=1234567890 -->
+
+{{ "/assets/css/main.bundle.css" | uj_cachebreak }}
+<!-- Output: /assets/css/main.bundle.css?cb=1234567890 -->
+```
+
 ### `uj_content_format` Filter
 Process content with Liquid templating and Markdown conversion, automatically transforming markdown and liquid into HTML intelligently based on the file type.
 
@@ -209,6 +231,8 @@ Resolves the site, layout, and page data into a single object, which can be usef
 {{ page.my.variable | default: layout.my.variable | default: site.my.variable }}
 ```
 
+Merge order, lowest to highest priority: site config → layout chain (parents beat children) → front-matter `defaults:` from the site config → the page's own front matter. The `defaults:` layer lets a site override layout-provided content (e.g. framework sample sections) in one place without editing every page.
+
 ## Tags
 ### `iftruthy` Tag
 A custom Liquid tag that checks if a variable is truthy (not nil, not false, not empty string, not 0) and renders the content inside the tag if it is truthy.

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.7.11"
+  spec.version = "1.8.1"
 
   # Author info
   spec.authors = ["ITW Creative Works"]

data/lib/filters/main.rb

@@ -149,6 +149,25 @@ module Jekyll
       JSON.pretty_generate(input, indent: indent_string)
     end
 
+    # Append a query parameter to a URL, handling existing query strings
+    # Usage: {{ "https://example.com/img.png" | uj_append_param: "cb", "123" }}
+    #   => "https://example.com/img.png?cb=123"
+    # Usage: {{ "https://example.com/img.png?w=200" | uj_append_param: "cb", "123" }}
+    #   => "https://example.com/img.png?w=200&cb=123"
+    def uj_append_param(input, key, value)
+      return input if input.nil? || input.to_s.strip.empty?
+      url = input.to_s.strip
+      sep = url.include?('?') ? '&' : '?'
+      "#{url}#{sep}#{key}=#{value}"
+    end
+
+    # Append a cache-busting query parameter to a URL
+    # Usage: {{ "https://example.com/img.png" | uj_cachebreak }}
+    #   => "https://example.com/img.png?cb=1234567890"
+    def uj_cachebreak(input)
+      uj_append_param(input, 'cb', UJPowertools.cache_timestamp)
+    end
+
     # Pluralize a word based on a count
     # Usage: {{ count | uj_pluralize: 'singular', 'plural' }}
     # Example: {{ 5 | uj_pluralize: 'post', 'posts' }} => 'posts'

data/lib/generators/inject-properties.rb

@@ -168,6 +168,17 @@ module Jekyll
         end
       end
 
+      # Merge front-matter defaults (site config `defaults:`) as their own layer.
+      # Jekyll materializes defaults into a Document's data at read time, but for
+      # Pages they only exist behind data.default_proc — resolved per-key on
+      # access, never during iteration — so the page-data merge below can't see
+      # them. Without this layer, site-wide `defaults:` values silently lose to
+      # layout front matter in `resolved`.
+      if site.respond_to?(:frontmatter_defaults) && item.respond_to?(:relative_path) && item.respond_to?(:type)
+        fm_defaults = site.frontmatter_defaults.all(item.relative_path, item.type)
+        resolved = deep_merge(resolved, filter_front_matter(fm_defaults)) unless fm_defaults.empty?
+      end
+
       # Finally merge page data (highest priority)
       # Filter out Jekyll internal properties
       page_data = filter_front_matter(item.data)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-uj-powertools
 version: !ruby/object:Gem::Version
-  version: 1.7.11
+  version: 1.8.1
 platform: ruby
 authors:
 - ITW Creative Works