jekyll-l10n 1.2.8 → 1.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5a4a4261253d5efb8103b3d8896bff9960249f4d6ed69266c0016729b38da43
-  data.tar.gz: 582bb044c024621b3bee6407f0ef6f2c6d3f3de8cbca9df14c2449702aaeb446
+  metadata.gz: e9b061ddf1f9f9072efe9135d023d05d55d7dd8545bd34988ecae6f59e03a2e2
+  data.tar.gz: 6c8704fa0e33e96c8e9918d5f7539db8203f291b4a2608e8946846e86fea8a94
 SHA512:
-  metadata.gz: cb0212b0e62d331499629fe94eb3983dbaba9d4414804be1f1846873619935acbecf8f26d405b5c10cdc4400bdd246c23f35697ab67bc58deae24b506280f516
-  data.tar.gz: dde77b84bb811f0e08fb3bf4cf613cc8cef18bb39e907c7b0bf53a6c0993e33c399bf8b089cab60cbbe5e597725616aae1575b2c21fc9372c299759430c393ba
+  metadata.gz: 709ab40d1a6f0ada0810751f54279d4c466d00349a46a9c7916d4a705289af6e8c142ebbd31fefd520c1205089f1f662354f702b381fe8bb44129ab4fde157fc
+  data.tar.gz: acda3c29b32433e2c3b1e90004690955b0da0219a8c896f8cfc28aa61e2ff190e238352e08e35cd606c4717524b8d6c731cd3efac673be115ec89ce89a9fdb32

data/README.md

@@ -1,85 +1,65 @@
 # jekyll-l10n
 
-`jekyll-l10n` is a Jekyll plugin that streamlines the localization of static
-websites using industry-standard GNU Gettext PO files. Creating multilingual
-sites presents unique challenges: maintaining consistent translations across
-multiple pages, managing translation workflows with non-technical translators,
-and keeping translations synchronized as content evolves. This plugin automates
-these challenges by integrating the proven Gettext workflow directly into your
-Jekyll build pipeline.
-
-The plugin works by extracting translatable strings from your site's generated
-HTML and organizing them into PO files that translators can edit using standard
-translation tools. As your content changes, the plugin intelligently updates
-these translation files, preserving existing translations while flagging
-changed or new content. When you rebuild your site, translated strings are
-automatically applied to localized versions of your pages, producing fully
-translated HTML output with locale-prefixed URLs.
+`jekyll-l10n` is a Jekyll plugin that streamlines the localization of static websites using industry-standard GNU Gettext PO files. It extracts translatable strings from your site's HTML, organizes them into PO files for professional translation, and automatically applies translations to generate fully localized pages with locale-prefixed URLs.
 
 ![Jekyll site localization](docs/assets/img/jekyll-l10n.png)
 
-Key features include automatic page duplication with locale-specific URL
-prefixes, flexible fallback modes when translations are incomplete (display
-original English, mark untranslated strings, or leave blank), and support for
-compendium files to share common translations across your site. By leveraging
-the standard Gettext format and workflow, `jekyll-l10n` enables collaboration
-with professional translators and integrates with existing translation
-management systems, while keeping your source content in Markdown where it
-belongs.
+## Installation
 
-## Development Setup
+Add to your Jekyll site's `Gemfile`:
 
-To set up your development environment:
-
-```bash
-bundle install          # Install Ruby dependencies
-pip install pre-commit  # Install pre-commit framework
-pre-commit install      # Install pre-commit hooks
+```ruby
+gem "jekyll-l10n", "~> 1.1"
 ```
 
-This enables pre-commit hooks that automatically check code style and format on each commit.
+Run `bundle install`, then enable in `_config.yml`:
 
-## Configuration
+```yaml
+plugins:
+  - jekyll-l10n
+
+defaults:
+  - scope:
+      type: "pages"
+    values:
+      with_locales: true
+      with_locales_data:
+        locales: ["es", "fr", "de"]
+        locales_dir: "_locales"
+        extract_on_build: true
+```
 
-### Incremental Builds (Performance Optimization)
+## Quick Example
 
-By default, the plugin regenerates all localized pages on every build. For large
-sites with many locales, this can impact build performance. You can enable
-incremental build support to skip regenerating pages that haven't changed:
+Edit PO files in `_locales/` with translations. On rebuild, your site will generate:
 
-```yaml
-localization_gettext:
-  with_locales_data:
-    incremental: true # Enable incremental builds
-```
+- `/es/` - Spanish pages
+- `/fr/` - French pages
+- `/de/` - German pages
 
-Or at the top level:
+## Documentation
 
-```yaml
-localization_gettext:
-  incremental: true
-```
+Complete documentation is available in the [docs/](docs/) directory:
 
-When incremental mode is enabled, pages are only regenerated if:
+- **[Getting Started](docs/getting-started/)** - Installation requirements and first-site setup
+- **[Configuration Guide](docs/configuration/)** - All configuration options and settings
+- **[Guides](docs/guides/)** - Fallback modes, Liquid filters, machine translation, incremental builds
+- **[Development](docs/development/)** - Setup, testing, API documentation
+- **[Examples](docs/examples/)** - Real-world usage examples
 
-- The source page content has been modified
-- Any PO translation files have been updated
-- The Jekyll configuration has changed
+## Key Features
 
-This significantly improves build times on subsequent builds when only
-translations or a few pages have changed.
+- **Automatic extraction** - Extract translatable strings during Jekyll builds
+- **Professional workflows** - Edit translations using standard Gettext tools (Poedit, Weblate, etc.)
+- **Fallback modes** - Display English, mark untranslated strings, or leave blank
+- **Incremental builds** - Skip regenerating unchanged localized pages for faster builds
+- **Machine translation** - Optional LibreTranslate integration for initial translations
+- **Compendium files** - Share common translations across your entire site
 
-## Machine Translation
+## Requirements
 
-For teams without translation resources, the plugin integrates with
-LibreTranslate, a free and open-source machine translation service, to
-automatically translate newly extracted strings during the extraction workflow.
-You can enable this optional integration on a per-locale basis, allowing
-LibreTranslate to generate initial translations for compendia files that serve
-as a foundation for professional translators to refine. This significantly
-reduces the initial translation effort and helps bootstrap localization for new
-content, though professional review is still recommended for
-publication-quality results.
+- **Ruby**: >= 2.7.0
+- **Jekyll**: >= 4.0, < 5.0
 
 ## License
 
@@ -88,7 +68,7 @@ MIT License - see LICENSE file for details.
 ## Contributing
 
 1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
 3. Commit your changes (`git commit -m 'feat: Add amazing feature'`)
 4. Push to the branch (`git push origin feature/amazing-feature`)
 5. Open a Pull Request

data/lib/jekyll-l10n/constants.rb

@@ -22,27 +22,27 @@ module Jekyll
       # Matches ISO 639-1 (2 letter language) with optional ISO 3166-1 (2 letter country)
       # Examples: 'en', 'es', 'fr', 'pt_BR', 'zh_CN'
       # @return [Regexp]
-      LOCALE_PATTERN = %r!^[a-z]{2}(_[A-Z]{2})?$!.freeze
+      LOCALE_PATTERN = /^[a-z]{2}(_[A-Z]{2})?$/.freeze
 
       # ## Translation Fallback Modes
 
       # Fallback mode: use original English text if translation not found
       # @return [String] "english"
-      FALLBACK_MODE_ENGLISH = "english"
+      FALLBACK_MODE_ENGLISH = 'english'
 
-      # Fallback mode: wrap untranslated text with markers (e.g., "[UNTRANSLATED: text]")
+      # Fallback mode: wrap untranslated text with markers (e.g., "[UNTRANSLATED] text")
       # @return [String] "marker"
-      FALLBACK_MODE_MARKER = "marker"
+      FALLBACK_MODE_MARKER = 'marker'
 
       # Fallback mode: leave text blank if no translation found
       # @return [String] "empty"
-      FALLBACK_MODE_EMPTY = "empty"
+      FALLBACK_MODE_EMPTY = 'empty'
 
       # ## Translation Markers
 
       # Marker used to indicate untranslated strings in marker fallback mode
       # @return [String] "[UNTRANSLATED]"
-      UNTRANSLATED_MARKER = "[UNTRANSLATED]"
+      UNTRANSLATED_MARKER = '[UNTRANSLATED]'
 
       # ## PO File Formatting (GNU Gettext Standard)
 
@@ -82,7 +82,7 @@ module Jekyll
 
       # Default directory for storing PO translation files
       # @return [String] "_locales"
-      DEFAULT_LOCALES_DIR = "_locales"
+      DEFAULT_LOCALES_DIR = '_locales'
 
       # Default fallback mode when translation is not found
       # @return [String] "english"
@@ -90,10 +90,15 @@ module Jekyll
 
       # Default HTML attributes to extract from elements (can be overridden per-page)
       # @return [Array<String>] ["title", "alt", "aria-label", "placeholder", "aria-description"]
-      DEFAULT_TRANSLATABLE_ATTRIBUTES = %w(title alt aria-label placeholder aria-description).freeze
+      DEFAULT_TRANSLATABLE_ATTRIBUTES = %w[title alt aria-label placeholder aria-description].freeze
 
       # ## LibreTranslate Integration Defaults
 
+      # Default LibreTranslate API endpoint URL
+      # Uses localhost:5000 as default for local development
+      # @return [String] "http://localhost:5000"
+      DEFAULT_LIBRETRANSLATE_API_URL = 'http://localhost:5000'
+
       # Default timeout (in seconds) for LibreTranslate API requests
       # @return [Integer] 300 seconds (5 minutes)
       DEFAULT_LIBRETRANSLATE_TIMEOUT = 300
@@ -125,12 +130,12 @@ module Jekyll
       # Default source locale for LibreTranslate API
       # The language of the original content being translated
       # @return [String] "en" (English)
-      DEFAULT_LIBRETRANSLATE_SOURCE_LOCALE = "en"
+      DEFAULT_LIBRETRANSLATE_SOURCE_LOCALE = 'en'
 
       # Default text format for LibreTranslate API requests
       # Either 'text' (plain text) or 'html' (preserves markup)
       # @return [String] "html"
-      DEFAULT_LIBRETRANSLATE_FORMAT = "html"
+      DEFAULT_LIBRETRANSLATE_FORMAT = 'html'
     end
   end
 end

data/lib/jekyll-l10n/extraction/compendium_merger.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative "../po_file/manager"
-require_relative "../utils/page_locales_config"
-require_relative "../utils/site_config_accessor"
+require_relative '../po_file/manager'
+require_relative '../utils/page_locales_config'
+require_relative '../utils/site_config_accessor'
 
 module Jekyll
   module L10n
@@ -34,7 +34,7 @@ module Jekyll
       def initialize(site)
         @site = site
         with_locales_data = SiteConfigAccessor.extract_locales_data(@site)
-        @site_config = PageLocalesConfig.new({ "with_locales_data" => with_locales_data })
+        @site_config = PageLocalesConfig.new({ 'with_locales_data' => with_locales_data })
       end
 
       # Merge page-specific PO files into compendia for all locales.
@@ -55,6 +55,7 @@ module Jekyll
       private
 
       # Process a single locale: merge existing compendium with new page translations
+      # Skips writing when translations are unchanged to avoid unnecessary file rewrites
       def process_locale(locale, po_manager, config)
         compendium_path = File.join(@site.source, config.locales_dir, "#{locale}.po")
         existing_compendium = load_existing_compendium(compendium_path)
@@ -62,12 +63,27 @@ module Jekyll
 
         combined = build_combined_hash(existing_compendium)
         merge_into_combined(combined, merged)
-        combined_entries = format_compendium_entries(combined)
 
-        po_manager.save_compendium(locale, combined_entries)
+        unless compendium_unchanged?(existing_compendium, combined)
+          combined_entries = format_compendium_entries(combined)
+          po_manager.save_compendium(locale, combined_entries)
+        end
         cleanup_locale_directory(locale, config)
       end
 
+      # Check if compendium content is unchanged (same msgids and msgstrs)
+      def compendium_unchanged?(existing_compendium, combined)
+        return false if existing_compendium.empty? && !combined.empty?
+
+        normalized_existing = build_combined_hash(existing_compendium)
+        return false unless normalized_existing.keys.sort == combined.keys.sort
+
+        combined.all? do |msgid, data|
+          existing = normalized_existing[msgid]
+          existing && existing[:msgstr] == data[:msgstr]
+        end
+      end
+
       # Load existing compendium translations or return empty hash if not found
       def load_existing_compendium(compendium_path)
         if File.exist?(compendium_path)
@@ -89,9 +105,9 @@ module Jekyll
       # Normalize entry format to ensure consistent hash structure with :msgstr and :reference keys
       def normalize_compendium_entry(data)
         if data.is_a?(Hash)
-          { :msgstr => data[:msgstr], :reference => data[:reference] }
+          { msgstr: data[:msgstr], reference: data[:reference] }
         else
-          { :msgstr => data, :reference => nil }
+          { msgstr: data, reference: nil }
         end
       end
 
@@ -108,20 +124,24 @@ module Jekyll
 
       # Update reference for existing entry if new reference is available
       def update_entry_reference(combined_entry, entry)
-        if combined_entry[:reference].nil? && entry.is_a?(Hash) && entry[:reference]
-          combined_entry[:reference] = entry[:reference]
-        end
+        return unless combined_entry[:reference].nil? && entry.is_a?(Hash) && entry[:reference]
+
+        combined_entry[:reference] = entry[:reference]
       end
 
-      # Create new entry for untranslated string with optional reference
+      # Create new entry preserving any existing translation and reference
       def create_new_entry(entry)
-        { :msgstr => "", :reference => entry.is_a?(Hash) ? entry[:reference] : nil }
+        if entry.is_a?(Hash)
+          { msgstr: entry[:msgstr] || '', reference: entry[:reference] }
+        else
+          { msgstr: '', reference: nil }
+        end
       end
 
       # Convert combined hash to array of entries suitable for PO file writing
       def format_compendium_entries(combined)
         combined.map do |msgid, data|
-          entry = { :msgid => msgid, :msgstr => data[:msgstr] }
+          entry = { msgid: msgid, msgstr: data[:msgstr] }
           entry[:reference] = data[:reference] if data[:reference]
           entry
         end
@@ -134,9 +154,10 @@ module Jekyll
         FileUtils.rm_rf(locale_dir) if File.directory?(locale_dir)
       end
 
-      private :process_locale, :load_existing_compendium, :build_combined_hash,
-              :normalize_compendium_entry, :merge_into_combined, :update_entry_reference,
-              :create_new_entry, :format_compendium_entries, :cleanup_locale_directory
+      private :process_locale, :compendium_unchanged?, :load_existing_compendium,
+              :build_combined_hash, :normalize_compendium_entry, :merge_into_combined,
+              :update_entry_reference, :create_new_entry, :format_compendium_entries,
+              :cleanup_locale_directory
     end
   end
 end

data/lib/jekyll-l10n/extraction/compendium_translator.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require_relative "../po_file/manager"
-require_relative "../utils/page_locales_config"
-require_relative "../utils/po_entry_converter"
-require_relative "../utils/site_config_accessor"
-require_relative "../utils/logger_formatter"
-require_relative "../translation/libre_translator"
+require_relative '../po_file/manager'
+require_relative '../utils/page_locales_config'
+require_relative '../utils/po_entry_converter'
+require_relative '../utils/site_config_accessor'
+require_relative '../utils/logger_formatter'
+require_relative '../translation/libre_translator'
 
 module Jekyll
   module L10n
@@ -34,7 +34,7 @@ module Jekyll
       def initialize(site)
         @site = site
         with_locales_data = SiteConfigAccessor.extract_locales_data(@site)
-        @site_config = PageLocalesConfig.new({ "with_locales_data" => with_locales_data })
+        @site_config = PageLocalesConfig.new({ 'with_locales_data' => with_locales_data })
       end
 
       # Translate compendia for all configured locales.
@@ -68,7 +68,7 @@ module Jekyll
 
       def process_single_locale(locale, config, translator, po_manager)
         compendium_path = File.join(@site.source, config.locales_dir, "#{locale}.po")
-        LoggerFormatter.debug_if_enabled("CompendiumTranslator",
+        LoggerFormatter.debug_if_enabled('CompendiumTranslator',
                                          "Processing compendium file: #{compendium_path}")
         return unless File.exist?(compendium_path)
 
@@ -86,29 +86,29 @@ module Jekyll
       end
 
       def log_compendia_enabled_check(enabled)
-        msg = "translate_compendia_for_locale called, libretranslate_enabled:"
-        LoggerFormatter.debug_if_enabled("CompendiumTranslator", "#{msg} #{enabled}")
+        msg = 'translate_compendia_for_locale called, libretranslate_enabled:'
+        LoggerFormatter.debug_if_enabled('CompendiumTranslator', "#{msg} #{enabled}")
       end
 
       def log_compendium_stats(locale, po_entries, compendium_path)
         msg = "Locale #{locale}: Loaded #{po_entries.length} entries from compendium"
-        LoggerFormatter.debug_if_enabled("CompendiumTranslator", "#{msg} #{compendium_path}")
+        LoggerFormatter.debug_if_enabled('CompendiumTranslator', "#{msg} #{compendium_path}")
 
         empty_count = count_empty_entries(po_entries)
         LoggerFormatter.debug_if_enabled(
-          "CompendiumTranslator",
+          'CompendiumTranslator',
           "Locale #{locale}: #{empty_count} empty msgstr entries to translate"
         )
       end
 
       def log_translation_complete_for_locale(locale)
         msg = "Locale #{locale}: Translation complete, saving compendium"
-        LoggerFormatter.debug_if_enabled("CompendiumTranslator", msg)
+        LoggerFormatter.debug_if_enabled('CompendiumTranslator', msg)
       end
 
       def log_compendium_saved(locale, compendium_path)
         msg = "Locale #{locale}: Saved compendium to"
-        LoggerFormatter.debug_if_enabled("CompendiumTranslator", "#{msg} #{compendium_path}")
+        LoggerFormatter.debug_if_enabled('CompendiumTranslator', "#{msg} #{compendium_path}")
       end
 
       def count_empty_entries(po_entries)
@@ -118,14 +118,14 @@ module Jekyll
       end
 
       def log_translation_start(config)
-        locales = config.locales.join(", ")
-        Jekyll.logger.info "Localization",
+        locales = config.locales.join(', ')
+        Jekyll.logger.info 'Localization',
                            "Starting LibreTranslate translation for locales: #{locales}"
       end
 
       def log_translation_complete(config)
-        locales = config.locales.join(", ")
-        Jekyll.logger.info "Localization",
+        locales = config.locales.join(', ')
+        Jekyll.logger.info 'Localization',
                            "LibreTranslate translation complete for locales: #{locales}"
       end
 

data/lib/jekyll-l10n/extraction/config_loader.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "../utils/page_locales_config"
+require_relative '../utils/page_locales_config'
 
 module Jekyll
   module L10n
@@ -69,10 +69,10 @@ module Jekyll
       # @return [Hash, nil] Page front matter data if found, nil otherwise
       def find_page_config_for_file(file_path)
         @site.pages.each do |page|
-          next unless page.data["with_locales"] == true
+          next unless page.data['with_locales'] == true
 
-          page_output = page.output_ext ? page.destination("") : page.destination("/")
-          next unless file_path.end_with?(page_output.sub(%r!/$!, "/index.html"))
+          page_output = page.output_ext ? page.destination('') : page.destination('/')
+          next unless file_path.end_with?(page_output.sub(%r{/$}, '/index.html'))
 
           return page.data
         end
@@ -88,10 +88,10 @@ module Jekyll
       # @param file_path [String] Path to file to check
       # @return [Boolean] True if file is in a locale subdirectory
       def skip_localized_page?(file_path)
-        relative_path = file_path.sub(@dest, "")
+        relative_path = file_path.sub(@dest, '')
 
         all_locales = @site.pages.map do |p|
-          p.data.dig("with_locales_data", "locales") || []
+          p.data.dig('with_locales_data', 'locales') || []
         end
         all_locales.flatten!
         all_locales.uniq!
@@ -106,8 +106,8 @@ module Jekyll
       # @param config [Hash] Page front matter data
       # @return [Array<String>] CSS selectors for excluded elements
       def extract_exclude_selectors(config)
-        config.data.dig("with_locales_data", "extraction", "exclude_selectors") ||
-          ["script", "style", "code.language-plaintext", "pre code"]
+        config.data.dig('with_locales_data', 'extraction', 'exclude_selectors') ||
+          ['script', 'style', 'code.language-plaintext', 'pre code']
       end
     end
   end

data/lib/jekyll-l10n/extraction/dom_attribute_extractor.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "../utils/xpath_reference_generator"
-require_relative "../utils/text_validator"
+require_relative '../utils/xpath_reference_generator'
+require_relative '../utils/text_validator'
 
 module Jekyll
   module L10n
@@ -24,7 +24,7 @@ module Jekyll
     #                                           ['title', 'alt', 'aria-label'])
     #   # Returns array of extraction entries for all valid attribute values
     module DomAttributeExtractor
-      extend self
+      module_function
 
       # Extract attribute values from an HTML element.
       #
@@ -47,7 +47,7 @@ module Jekyll
         attrs = extract_node_attributes(node, translatable_attrs)
         attrs.map do |attr_text, attr_name|
           reference = XPathReferenceGenerator.generate(node, file_path, dest, attr_name)
-          { :msgid => attr_text, :msgstr => "", :reference => reference }
+          { msgid: attr_text, msgstr: '', reference: reference }
         end
       end
 

data/lib/jekyll-l10n/extraction/dom_text_extractor.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require_relative "../utils/text_normalizer"
-require_relative "../utils/xpath_reference_generator"
-require_relative "../utils/html_text_utils"
-require_relative "../utils/html_elements"
-require_relative "../utils/text_validator"
+require_relative '../utils/text_normalizer'
+require_relative '../utils/xpath_reference_generator'
+require_relative '../utils/html_text_utils'
+require_relative '../utils/html_elements'
+require_relative '../utils/text_validator'
 
 module Jekyll
   module L10n
@@ -48,7 +48,7 @@ module Jekyll
         return nil if text.nil?
 
         reference = XPathReferenceGenerator.generate(node, file_path, dest)
-        { :msgid => text, :msgstr => "", :reference => reference }
+        { msgid: text, msgstr: '', reference: reference }
       end
 
       def extractable?(node)

data/lib/jekyll-l10n/extraction/extractor.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require_relative "config_loader"
-require_relative "result_saver"
-require_relative "logger"
-require_relative "html_string_extractor"
-require_relative "../utils/file_operations"
-require_relative "../utils/site_config_accessor"
-require_relative "../utils/error_handler"
+require_relative 'config_loader'
+require_relative 'result_saver'
+require_relative 'logger'
+require_relative 'html_string_extractor'
+require_relative '../utils/file_operations'
+require_relative '../utils/site_config_accessor'
+require_relative '../utils/error_handler'
 
 module Jekyll
   module L10n
@@ -72,7 +72,7 @@ module Jekyll
       #   result = extractor.extract_site
       #   puts "Processed #{result[:files_processed]} files"
       def extract_site
-        Jekyll.logger.info "Localization", "Extracting translatable strings..."
+        Jekyll.logger.info 'Localization', 'Extracting translatable strings...'
         start_time = Time.now
         stats = process_all_html_files
         translate_all_compendia
@@ -81,8 +81,8 @@ module Jekyll
       end
 
       def process_all_html_files
-        stats = { :files_processed => 0, :strings_extracted => 0, :po_files_created => 0 }
-        html_files = Dir.glob(File.join(@dest, "**", "*.html"))
+        stats = { files_processed: 0, strings_extracted: 0, po_files_created: 0 }
+        html_files = Dir.glob(File.join(@dest, '**', '*.html'))
 
         html_files.each do |file_path|
           next if @config_loader.skip_localized_page?(file_path)
@@ -100,7 +100,7 @@ module Jekyll
         config = find_libretranslate_config
         return unless config
 
-        ErrorHandler.handle_with_logging("machine translation") do
+        ErrorHandler.handle_with_logging('machine translation') do
           @result_saver.translate_compendia(config)
         end
       end
@@ -120,7 +120,7 @@ module Jekyll
       end
 
       def default_stats
-        { :files_processed => 0, :strings_extracted => 0, :po_files_created => 0 }
+        { files_processed: 0, strings_extracted: 0, po_files_created: 0 }
       end
 
       def extract_strings_from_file(file_path, config)
@@ -137,9 +137,9 @@ module Jekyll
         return nil unless @site.respond_to?(:pages)
 
         @site.pages.each do |page|
-          next unless page.data["with_locales"] == true
+          next unless page.data['with_locales'] == true
 
-          config = @config_loader.load_page_config(page.destination(""))
+          config = @config_loader.load_page_config(page.destination(''))
           return config if config.libretranslate_enabled?
         end
 
@@ -149,7 +149,7 @@ module Jekyll
       private
 
       def construct_page_path(file_path)
-        file_path.sub("#{@dest}/", "")
+        file_path.sub("#{@dest}/", '')
       end
     end
   end

data/lib/jekyll-l10n/extraction/html_string_extractor.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative "dom_text_extractor"
-require_relative "dom_attribute_extractor"
-require_relative "logger"
+require_relative 'dom_text_extractor'
+require_relative 'dom_attribute_extractor'
+require_relative 'logger'
 
 module Jekyll
   module L10n
@@ -92,10 +92,10 @@ module Jekyll
 
         @exclude_selectors.any? { |selector| node.matches?(selector) }
       rescue Nokogiri::CSS::SyntaxError => e
-        Jekyll.logger.warn "Localization", "CSS selector syntax error: #{e.message}"
+        Jekyll.logger.warn 'Localization', "CSS selector syntax error: #{e.message}"
         false
       rescue StandardError => e
-        Jekyll.logger.warn "Localization", "Selector matching error (continuing): #{e.message}"
+        Jekyll.logger.warn 'Localization', "Selector matching error (continuing): #{e.message}"
         false
       end
     end