jekyll-auto-thumbnails 0.3.3 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a8f6d099b2d5685d864827584c661c6583950e6e269fd8e7ca4bf7a3c9b21c1
-  data.tar.gz: 36dddb91f054252e9591bc5428030370c5ec3fb8a3ad480920dee74d53a2422a
+  metadata.gz: f285f00df661aa19adac0316e235ad5ea58717b392be088295a457db9ded92bc
+  data.tar.gz: 92e7da98bbc220773e6247977815724733e5319b2ed9ad54dfe32a61c1a9cdfc
 SHA512:
-  metadata.gz: f1c424f69eb58e7e3fbcf68835fe32e07b6967b5bd1d34e3712d955ece86d5301afa0a40714c0d7a3ef547a30afb93e5a580f1ef66d9d54446c240fc4c65a6a8
-  data.tar.gz: 2deed4d50f48b3f57222d332130c882723f1dfc2fd82d537e428e9949b4dce1225f5b97ffe7a75eaddbaca52736dfdb3c13c833e62edd0f5a604a1727cf505a7
+  metadata.gz: 936bb03d186071967c2379bdfff539737602926eeff35776af90a29d32d102f9fc68dde50eb8aaeab12ee7c9c3a92501f00cd41746f2715d78e1cc1827d5f121
+  data.tar.gz: 06546f50fca9d6da941da5eccbae7577ed3e4167f34ebce3d670718ab070dcc6744bb4e94ff7f3950fdaca5474e520dcba976a76e05251f37e8d22eee7484bd3

data/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [2.0.0](https://github.com/Texarkanine/jekyll-auto-thumbnails/compare/v1.0.0...v2.0.0) (2026-04-24)
+
+
+### ⚠ BREAKING CHANGES
+
+* Incorrectly round-tripped all content through HTML4 parser ([#30](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/30))
+
+### Bug Fixes
+
+* **deps:** bump nokogiri from 1.19.0 to 1.19.1 in the production-deps group ([#20](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/20)) ([0ed6c0c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/0ed6c0cf65aa17ed0182ff7eb1f85d8b053188e1))
+* **deps:** bump nokogiri from 1.19.1 to 1.19.2 in the production-deps group across 1 directory ([#24](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/24)) ([023882c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/023882c815b26f1d1143635c56f2adc78a124b85))
+* **deps:** bump nokogiri in the production-deps group ([023882c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/023882c815b26f1d1143635c56f2adc78a124b85))
+* **deps:** bump nokogiri in the production-deps group ([0ed6c0c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/0ed6c0cf65aa17ed0182ff7eb1f85d8b053188e1))
+* Incorrectly round-tripped all content through HTML4 parser ([#30](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/30)) ([75640c8](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/75640c8c0de097e1ebb9e615e1acf8a00c0ef7e6))
+
+## [1.0.0](https://github.com/Texarkanine/jekyll-auto-thumbnails/compare/v0.3.3...v1.0.0) (2026-01-18)
+
+
+### ⚠ BREAKING CHANGES
+
+* standardize config across Jekyll gem repos ([#16](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/16))
+* Drop ostensible support for Ruby 3.1; only 3.3+ is promised
+
+### Features
+
+* standardize config across Jekyll gem repos ([#16](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/16)) ([3fa892b](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/3fa892b5a7c292eae2d58db9283acae99ec919dd))
+
+
+### Bug Fixes
+
+* **deps-dev:** bump rubocop from 1.81.7 to 1.82.0 in the dev-deps-minor-patch group ([#12](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/12)) ([965c63c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/965c63c3bd20737a81465e52f64f46ab8c2631e2))
+* **deps-dev:** bump rubocop from 1.82.0 to 1.82.1 in the dev-deps-minor-patch group ([#14](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/14)) ([7cb95c7](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/7cb95c70a6982cd33ea5c76470417d1def5fb48f))
+* **deps-dev:** bump rubocop in the dev-deps-minor-patch group ([7cb95c7](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/7cb95c70a6982cd33ea5c76470417d1def5fb48f))
+* **deps-dev:** bump rubocop in the dev-deps-minor-patch group ([965c63c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/965c63c3bd20737a81465e52f64f46ab8c2631e2))
+* **deps-dev:** bump rubocop-rspec from 3.8.0 to 3.9.0 in the dev-deps-minor-patch group ([#15](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/15)) ([65c2acc](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/65c2acc066b3566e24bed6bbbb2a3459f0664d5b))
+* **deps-dev:** bump rubocop-rspec in the dev-deps-minor-patch group ([65c2acc](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/65c2acc066b3566e24bed6bbbb2a3459f0664d5b))
+* **deps:** bump nokogiri from 1.18.10 to 1.19.0 in the production-deps group ([#17](https://github.com/Texarkanine/jekyll-auto-thumbnails/issues/17)) ([c3b213c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/c3b213c3f96b9b3fd452e3f63feca57f29ebf419))
+* **deps:** bump nokogiri in the production-deps group ([c3b213c](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/c3b213c3f96b9b3fd452e3f63feca57f29ebf419))
+* **docs:** Tighten up gemspec description ([0b4d66e](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/0b4d66eab4bcdeed84ccea75b13245b0e5d99926))
+
+
+### Miscellaneous Chores
+
+* standardize config across Jekyll gem repos ([3fa892b](https://github.com/Texarkanine/jekyll-auto-thumbnails/commit/3fa892b5a7c292eae2d58db9283acae99ec919dd))
+
 ## [0.3.3](https://github.com/Texarkanine/jekyll-auto-thumbnails/compare/v0.3.2...v0.3.3) (2025-12-21)
 
 

data/README.md

@@ -43,8 +43,25 @@ auto_thumbnails:
   
   # JPEG quality for generated thumbnails (0-100)
   quality: 85  # default: 85
+
+  # HTML parser used for scanning and rewriting.
+  # - html5 (default, CRuby only): standards-compliant, does not inject a
+  #   <meta http-equiv="Content-Type"> when serializing.
+  # - html4: legacy libxml2-based parser; re-inserts the encoding meta tag
+  #   on serialize. Required on JRuby.
+  parser: html5  # default: html5
 ```
 
+### HTML parser (`parser: html5 | html4`)
+
+As of `v2.0.0`, `jekyll-auto-thumbnails` parses and serializes HTML with Nokogiri's HTML5 parser by default.
+
+Set `parser: html4` to restore the previous behavior (the libxml2-based `Nokogiri::HTML` parser) if you depended on its serialization quirks.
+
+**JRuby note**: `Nokogiri::HTML5` is not available on JRuby. Under JRuby, you **must** explicitly set `parser: html4`; otherwise the plugin will raise a configuration error at build time.
+
+Pages that contain no replaceable `<article><img>` are no longer re-serialized at all - they are passed through byte-for-byte, regardless of which parser is selected.
+
 ## How It Works
 
 1. **HTML Scanning**: After all plugins run, scans `<article>` tags for images

data/jekyll-auto-thumbnails.gemspec

@@ -10,11 +10,10 @@ Gem::Specification.new do |spec|
 
   spec.summary = "Automatic image optimization for Jekyll sites"
   spec.description = "Jekyll plugin that automatically generates and serves optimized image thumbnails " \
-                     "for faster page loads. Scans rendered HTML, generates thumbnails with intelligent " \
-                     "caching, and seamlessly replaces img src attributes."
+                     "for faster page loads."
   spec.homepage = "https://github.com/Texarkanine/jekyll-auto-thumbnails"
   spec.license = "AGPL-3.0-or-later"
-  spec.required_ruby_version = ">= 3.1.0"
+  spec.required_ruby_version = ">= 3.3.0"
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/Texarkanine/jekyll-auto-thumbnails"

data/lib/jekyll-auto-thumbnails/configuration.rb

@@ -6,7 +6,9 @@ module JekyllAutoThumbnails
   # Parses Jekyll site config for auto_thumbnails options and provides
   # accessor methods with appropriate defaults and validation.
   class Configuration
-    attr_reader :max_width, :max_height, :quality, :cache_dir
+    VALID_PARSERS = %i[html4 html5].freeze
+
+    attr_reader :max_width, :max_height, :quality, :cache_dir, :parser
 
     # Initialize configuration from Jekyll site
     #
@@ -18,6 +20,7 @@ module JekyllAutoThumbnails
       @max_width = parse_dimension(config_hash["max_width"])
       @max_height = parse_dimension(config_hash["max_height"])
       @quality = parse_quality(config_hash.fetch("quality", 85))
+      @parser = parse_parser(config_hash.fetch("parser", "html5"))
       @cache_dir = File.join(site.source, ".jekyll-cache", "jekyll-auto-thumbnails")
     end
 
@@ -47,5 +50,39 @@ module JekyllAutoThumbnails
       val = value.to_i
       val.between?(0, 100) ? val : 85
     end
+
+    # Parse and validate the HTML parser choice.
+    #
+    # Accepts "html4" or "html5" (case-insensitive). Raises on any other
+    # input so HTML correctness is never silently traded for availability.
+    # JRuby cannot use the HTML5 parser (Nokogiri::HTML5 is CRuby-only),
+    # so selecting it under JRuby also raises, directing the user to set
+    # `auto_thumbnails.parser: html4` explicitly.
+    #
+    # @param value [Object] parser value from config
+    # @return [Symbol] :html4 or :html5
+    # @raise [ArgumentError] for invalid values or JRuby + :html5
+    def parse_parser(value)
+      unless value.is_a?(String)
+        raise ArgumentError,
+              "auto_thumbnails: parser must be a string (\"html4\" or \"html5\"); got #{value.inspect}"
+      end
+
+      symbol = value.downcase.to_sym
+      unless VALID_PARSERS.include?(symbol)
+        raise ArgumentError,
+              "auto_thumbnails: parser must be one of #{VALID_PARSERS.join(", ")}; " \
+              "got #{value.inspect}"
+      end
+
+      if symbol == :html5 && RUBY_ENGINE == "jruby"
+        raise ArgumentError,
+              "auto_thumbnails: parser: html5 is not supported on JRuby " \
+              "(Nokogiri::HTML5 is CRuby-only). " \
+              "Set auto_thumbnails.parser: html4 in _config.yml to run on JRuby."
+      end
+
+      symbol
+    end
   end
 end

data/lib/jekyll-auto-thumbnails/hooks.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "html_parser"
+
 module JekyllAutoThumbnails
   # Jekyll hook integration
   module Hooks
@@ -72,7 +74,7 @@ module JekyllAutoThumbnails
         next unless doc.output
         next unless html_document?(doc)
 
-        doc.output = replace_urls(doc.output, url_map)
+        doc.output = replace_urls(doc.output, url_map, parser: config.parser)
       end
 
       Jekyll.logger.info "AutoThumbnails:", "Generated #{url_map.size} thumbnails"
@@ -105,28 +107,37 @@ module JekyllAutoThumbnails
       Jekyll.logger.info "AutoThumbnails:", "All thumbnails copied"
     end
 
-    # Replace image URLs in HTML
+    # Replace image URLs in HTML.
+    #
+    # Returns the input string unchanged (object identity) when no replacement
+    # was actually made. This is both a perf win for pages with no matching
+    # images and a correctness win: the HTML4 path otherwise round-trips every
+    # page through libxml2's serializer, which injects a spurious
+    # `<meta http-equiv="Content-Type">` on HTML5 sites.
     #
     # @param html [String] HTML content
     # @param url_map [Hash] original URL => thumbnail URL
-    # @return [String] modified HTML
-    def self.replace_urls(html, url_map)
-      # Return early if no replacements needed
+    # @param parser [Symbol] :html5 (default) or :html4
+    # @return [String] modified HTML (or the input itself, unchanged)
+    def self.replace_urls(html, url_map, parser: :html5)
       return html if url_map.empty?
+      return html unless html.match?(/<img/i)
 
-      doc = Nokogiri::HTML(html)
+      doc = HtmlParser.parse(html, parser)
 
+      modified = false
       doc.css("article img").each do |img|
         src = img["src"]
         next unless src
 
-        # Find thumbnail URL for this image
         thumb_url = url_map[src]
-        img["src"] = thumb_url if thumb_url
+        next unless thumb_url
+
+        img["src"] = thumb_url
+        modified = true
       end
 
-      # Serialize with encoding declaration to match Jekyll output
-      doc.to_html
+      modified ? doc.to_html : html
     end
 
     # Check if a document outputs HTML (not CSS, JS, etc.)

data/lib/jekyll-auto-thumbnails/html_parser.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+# Nokogiri::HTML5 ships with Nokogiri on CRuby but is not available on JRuby.
+# Configuration rejects `parser: :html5` under JRuby, so this require only
+# needs to succeed on CRuby. On JRuby, the HTML4 branch is the only path
+# that ever runs.
+require "nokogiri/html5" unless RUBY_ENGINE == "jruby"
+
+module JekyllAutoThumbnails
+  # Dispatch between Nokogiri's HTML5 and libxml2-based HTML4 parsers.
+  #
+  # HTML5 is the default throughout the gem; HTML4 is kept as an opt-in for
+  # users who depended on libxml2's serialization quirks (notably the
+  # injected `<meta http-equiv="Content-Type">`).
+  module HtmlParser
+    module_function
+
+    # Parse an HTML string with the selected parser.
+    #
+    # @param html [String] HTML source
+    # @param parser [Symbol] :html5 or :html4
+    # @return [Nokogiri::HTML5::Document, Nokogiri::HTML4::Document]
+    # @raise [ArgumentError] for an unknown parser symbol
+    # @raise [NameError] if :html5 is requested under JRuby (should be
+    #   prevented by Configuration validation; this is a belt-and-suspenders
+    #   guard)
+    def parse(html, parser)
+      case parser
+      when :html5
+        Nokogiri::HTML5.parse(html)
+      when :html4
+        Nokogiri::HTML(html)
+      else
+        raise ArgumentError, "Unknown HTML parser: #{parser.inspect}"
+      end
+    end
+  end
+end

data/lib/jekyll-auto-thumbnails/scanner.rb

@@ -2,6 +2,7 @@
 
 require "nokogiri"
 require "open3"
+require_relative "html_parser"
 require_relative "imagemagick_wrapper"
 
 module JekyllAutoThumbnails
@@ -14,7 +15,7 @@ module JekyllAutoThumbnails
     # @param config [Configuration] configuration
     # @param site_source [String] Jekyll site source (optional, for unsized image checking)
     def self.scan_html(html, registry, config, site_source = nil)
-      doc = Nokogiri::HTML(html)
+      doc = HtmlParser.parse(html, config.parser)
 
       # Only process images in <article> tags
       doc.css("article img").each do |img|

data/lib/jekyll-auto-thumbnails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllAutoThumbnails
-  VERSION = "0.3.3"
+  VERSION = "2.0.0"
 end

data/lib/jekyll-auto-thumbnails.rb

@@ -4,6 +4,7 @@ require "jekyll"
 require "nokogiri"
 
 require_relative "jekyll-auto-thumbnails/version"
+require_relative "jekyll-auto-thumbnails/html_parser"
 require_relative "jekyll-auto-thumbnails/configuration"
 require_relative "jekyll-auto-thumbnails/url_resolver"
 require_relative "jekyll-auto-thumbnails/digest_calculator"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-auto-thumbnails
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 2.0.0
 platform: ruby
 authors:
 - Texarkanine
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -143,8 +142,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.1'
 description: Jekyll plugin that automatically generates and serves optimized image
-  thumbnails for faster page loads. Scans rendered HTML, generates thumbnails with
-  intelligent caching, and seamlessly replaces img src attributes.
+  thumbnails for faster page loads.
 email:
 - texarkanine@protonmail.com
 executables: []
@@ -160,6 +158,7 @@ files:
 - lib/jekyll-auto-thumbnails/digest_calculator.rb
 - lib/jekyll-auto-thumbnails/generator.rb
 - lib/jekyll-auto-thumbnails/hooks.rb
+- lib/jekyll-auto-thumbnails/html_parser.rb
 - lib/jekyll-auto-thumbnails/imagemagick_wrapper.rb
 - lib/jekyll-auto-thumbnails/registry.rb
 - lib/jekyll-auto-thumbnails/scanner.rb
@@ -173,7 +172,6 @@ metadata:
   source_code_uri: https://github.com/Texarkanine/jekyll-auto-thumbnails
   changelog_uri: https://github.com/Texarkanine/jekyll-auto-thumbnails/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -181,15 +179,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Automatic image optimization for Jekyll sites
 test_files: []