jekyll-uj-powertools 1.5.2 → 1.6.1

data/lib/tags/icon.rb

@@ -0,0 +1,262 @@
+# Libraries
+require "jekyll"
+
+module Jekyll
+  class UJIconTag < Liquid::Tag
+    # Default icon to show when requested icon is not found
+    DEFAULT_ICON = '<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>'
+
+    # Language code to country code mapping for flags
+    LANGUAGE_TO_COUNTRY = {
+      'en' => 'us',    # English -> United States (could also be 'gb' for Great Britain)
+      'es' => 'es',    # Spanish -> Spain
+      'fr' => 'fr',    # French -> France
+      'de' => 'de',    # German -> Germany
+      'it' => 'it',    # Italian -> Italy
+      'pt' => 'pt',    # Portuguese -> Portugal
+      'ru' => 'ru',    # Russian -> Russia
+      'ja' => 'jp',    # Japanese -> Japan
+      'ko' => 'kr',    # Korean -> South Korea
+      'zh' => 'cn',    # Chinese -> China
+      'ar' => 'sa',    # Arabic -> Saudi Arabia
+      'hi' => 'in',    # Hindi -> India
+      'tr' => 'tr',    # Turkish -> Turkey
+      'pl' => 'pl',    # Polish -> Poland
+      'nl' => 'nl',    # Dutch -> Netherlands
+      'sv' => 'se',    # Swedish -> Sweden
+      'no' => 'no',    # Norwegian -> Norway
+      'da' => 'dk',    # Danish -> Denmark
+      'fi' => 'fi',    # Finnish -> Finland
+      'he' => 'il',    # Hebrew -> Israel
+      'th' => 'th',    # Thai -> Thailand
+      'vi' => 'vn',    # Vietnamese -> Vietnam
+      'uk' => 'ua',    # Ukrainian -> Ukraine
+      'cs' => 'cz',    # Czech -> Czech Republic
+      'hu' => 'hu',    # Hungarian -> Hungary
+      'ro' => 'ro',    # Romanian -> Romania
+      'bg' => 'bg',    # Bulgarian -> Bulgaria
+      'hr' => 'hr',    # Croatian -> Croatia
+      'sk' => 'sk',    # Slovak -> Slovakia
+      'sl' => 'si',    # Slovenian -> Slovenia
+      'et' => 'ee',    # Estonian -> Estonia
+      'lv' => 'lv',    # Latvian -> Latvia
+      'lt' => 'lt',    # Lithuanian -> Lithuania
+      'mt' => 'mt',    # Maltese -> Malta
+      'ga' => 'ie',    # Irish -> Ireland
+      'cy' => 'gb',    # Welsh -> Great Britain
+      'ca' => 'es',    # Catalan -> Spain (could also be ad for Andorra)
+      'eu' => 'es',    # Basque -> Spain
+      'gl' => 'es',    # Galician -> Spain
+    }
+
+    # Font Awesome size mappings - commented out for now
+    # FA_SIZES = {
+    #   'fa-2xs' => '0.625em',
+    #   'fa-xs'  => '0.75em',
+    #   'fa-sm'  => '0.875em',
+    #   'fa-md'  => '1em',
+    #   'fa-lg'  => '1.25em',
+    #   'fa-xl'  => '1.5em',
+    #   'fa-2xl' => '2em'
+    # }
+
+    # Cache for loaded icons to improve performance
+    @@icon_cache = {}
+
+    def initialize(tag_name, markup, tokens)
+      super
+      @markup = markup.strip
+    end
+
+    def render(context)
+      # Parse arguments that can be quoted or unquoted
+      parts = parse_arguments(@markup)
+      icon_name_input = parts[0]
+      css_classes = parts[1]
+
+      # Check if the input was originally quoted (literal string)
+      is_quoted = @markup.strip.match(/^['"]/)
+
+      # If quoted, use as literal. Otherwise, try to resolve as variable
+      if is_quoted
+        icon_name = icon_name_input
+      else
+        # Try to resolve as a variable
+        icon_name = resolve_variable(context, icon_name_input)
+        # If it didn't resolve to a string, use the input as literal
+        icon_name = icon_name_input if icon_name.nil? || !icon_name.is_a?(String)
+      end
+
+      # Strip quotes from resolved icon name if present
+      if icon_name.is_a?(String) && icon_name.match(/^['"].*['"]$/)
+        icon_name = icon_name[1..-2]
+      end
+
+      # Get site from context
+      site = context.registers[:site]
+      return '' unless site
+
+      # Load the icon SVG from file
+      icon_svg = load_icon_from_file(site, icon_name.to_s)
+      return '' unless icon_svg
+
+      # Process SVG to inject required attributes
+      processed_svg = inject_svg_attributes(icon_svg)
+
+      # Determine CSS classes
+      # font_size = '1em' # default
+      # if size_input && !size_input.empty?
+      #   # Check if it's a Font Awesome preset size
+      #   font_size = FA_SIZES[size_input] || size_input
+      # end
+
+      # Wrap in i tag with CSS classes (always include 'fa' class)
+      if css_classes && !css_classes.empty?
+        "<i class=\"fa #{css_classes}\">#{processed_svg}</i>"
+      else
+        "<i class=\"fa\">#{processed_svg}</i>"
+      end
+    end
+
+    private
+
+    def inject_svg_attributes(svg_content)
+      # Inject width, height, and fill attributes into the SVG tag
+      if svg_content.include?('<svg')
+        # Replace the opening SVG tag to include our required attributes
+        svg_content.sub(/<svg([^>]*)>/) do |match|
+          existing_attrs = $1
+          # Only add attributes if they don't already exist
+          attrs_to_add = []
+          attrs_to_add << 'width="1em"' unless existing_attrs.include?('width=')
+          attrs_to_add << 'height="1em"' unless existing_attrs.include?('height=')
+          attrs_to_add << 'fill="currentColor"' unless existing_attrs.include?('fill=')
+
+          if attrs_to_add.any?
+            "<svg#{existing_attrs} #{attrs_to_add.join(' ')}>"
+          else
+            match
+          end
+        end
+      else
+        svg_content
+      end
+    end
+
+    def load_icon_from_file(site, icon_name)
+      # Get the style from site config
+      style = site.config.dig('icons', 'style') || 'solid'
+
+      # Create cache key
+      cache_key = "#{style}/#{icon_name}"
+
+      # Return cached version if available
+      return @@icon_cache[cache_key] if @@icon_cache.key?(cache_key)
+
+      # Try to load icon from multiple sources in order
+      icon_svg = try_load_fontawesome_icon(icon_name, style) ||
+                 try_load_flag_icon(icon_name) ||
+                 DEFAULT_ICON
+
+      # Cache the result
+      @@icon_cache[cache_key] = icon_svg
+      return icon_svg
+    end
+
+    def try_load_fontawesome_icon(icon_name, style)
+      # Build file path for the configured style
+      icon_path = File.join(Dir.pwd, 'node_modules', 'ultimate-jekyll-manager', 'assets', 'icons', 'font-awesome', style, "#{icon_name}.svg")
+
+      # Read file if it exists in the configured style
+      if File.exist?(icon_path)
+        return File.read(icon_path)
+      end
+
+      # If not found and style is not 'brands', try brands style as fallback
+      if style != 'brands'
+        brands_path = File.join(Dir.pwd, 'node_modules', 'ultimate-jekyll-manager', 'assets', 'icons', 'font-awesome', 'brands', "#{icon_name}.svg")
+
+        if File.exist?(brands_path)
+          return File.read(brands_path)
+        end
+      end
+
+      nil
+    end
+
+    def try_load_flag_icon(icon_name)
+      # First try direct country code (e.g., 'us', 'gb')
+      flag_path = File.join(Dir.pwd, 'node_modules', 'ultimate-jekyll-manager', 'assets', 'icons', 'flags', 'modern-square', "#{icon_name}.svg")
+
+      if File.exist?(flag_path)
+        return File.read(flag_path)
+      end
+
+      # If not found, try language code to country code mapping (e.g., 'en' -> 'us')
+      country_code = LANGUAGE_TO_COUNTRY[icon_name.downcase]
+      if country_code
+        mapped_flag_path = File.join(Dir.pwd, 'node_modules', 'ultimate-jekyll-manager', 'assets', 'icons', 'flags', 'modern-square', "#{country_code}.svg")
+
+        if File.exist?(mapped_flag_path)
+          return File.read(mapped_flag_path)
+        end
+      end
+
+      nil
+    end
+
+    def parse_arguments(markup)
+      # Parse arguments that can be quoted or unquoted
+      # Examples: award, fa-md  OR  'award', 'fa-md'  OR  myVar, "2em"
+      args = []
+      current_arg = ''
+      in_quotes = false
+      quote_char = nil
+
+      markup.each_char.with_index do |char, i|
+        if !in_quotes && (char == '"' || char == "'")
+          # Start of quoted string
+          in_quotes = true
+          quote_char = char
+        elsif in_quotes && char == quote_char
+          # End of quoted string
+          in_quotes = false
+          quote_char = nil
+        elsif !in_quotes && char == ','
+          # Argument separator
+          args << current_arg.strip
+          current_arg = ''
+        else
+          # Regular character
+          current_arg += char
+        end
+      end
+
+      # Add the last argument
+      args << current_arg.strip if current_arg.strip.length > 0
+
+      args
+    end
+
+    def resolve_variable(context, variable_name)
+      # Handle nested variable access like page.icon
+      parts = variable_name.split('.')
+      current = context
+
+      parts.each do |part|
+        if current.respond_to?(:[])
+          current = current[part]
+        elsif current.respond_to?(:key?) && current.key?(part)
+          current = current[part]
+        else
+          return nil
+        end
+        return nil if current.nil?
+      end
+
+      current
+    end
+  end
+end
+
+Liquid::Template.register_tag('uj_icon', Jekyll::UJIconTag)

data/lib/tags/iffalsy.rb

@@ -0,0 +1,38 @@
+# Libraries
+# ...
+
+# Tag
+module Jekyll
+  module UJPowertools
+    class IfFalsyTag < Liquid::Block
+      def initialize(tag_name, markup, tokens)
+        super
+        @variable = markup.strip
+      end
+
+      def render(context)
+        # Use Liquid's variable lookup to handle nested properties
+        value = context.scopes.last[@variable] || context[@variable]
+
+        # For nested properties like page.my.variable
+        if @variable.include?('.')
+          parts = @variable.split('.')
+          value = context[parts.first]
+          parts[1..-1].each do |part|
+            value = value.is_a?(Hash) ? value[part] : nil
+            break if value.nil?
+          end
+        end
+
+        # Check if the value is falsy (nil, false, empty string, or 0)
+        if value.nil? || value == false || value == "" || value == 0
+          super
+        else
+          ""
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag('iffalsy', Jekyll::UJPowertools::IfFalsyTag)

data/lib/tags/iftruthy.rb

@@ -0,0 +1,38 @@
+# Libraries
+# ...
+
+# Tag
+module Jekyll
+  module UJPowertools
+    class IfTruthyTag < Liquid::Block
+      def initialize(tag_name, markup, tokens)
+        super
+        @variable = markup.strip
+      end
+
+      def render(context)
+        # Use Liquid's variable lookup to handle nested properties
+        value = context.scopes.last[@variable] || context[@variable]
+
+        # For nested properties like page.my.variable
+        if @variable.include?('.')
+          parts = @variable.split('.')
+          value = context[parts.first]
+          parts[1..-1].each do |part|
+            value = value.is_a?(Hash) ? value[part] : nil
+            break if value.nil?
+          end
+        end
+
+        # Check if the value is truthy (not nil, not false, not empty string, not 0)
+        if value && value != false && value != "" && value != 0
+          super
+        else
+          ""
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag('iftruthy', Jekyll::UJPowertools::IfTruthyTag)

data/lib/tags/image.rb

@@ -0,0 +1,208 @@
+# Libraries
+require "jekyll"
+
+module Jekyll
+  class UJImageTag < Liquid::Tag
+    def initialize(tag_name, markup, tokens)
+      super
+      @markup = markup.strip
+    end
+
+    def render(context)
+      # Parse arguments
+      args = parse_arguments(@markup)
+      src_input = args[0]
+      options = parse_options(args[1..-1])
+
+      # Resolve source path
+      src = resolve_variable(context, src_input)
+      return '' unless src
+
+      # Check if this is an external URL
+      is_external = !!(src =~ /^https?:\/\//)
+
+      if is_external
+        # For external URLs, just create a simple responsive img tag
+        build_external_image(src, options)
+      else
+        # Extract file extension
+        extension = File.extname(src)
+        src_path = src.chomp(extension)
+
+        # Determine max width
+        max_width = options['max_width'] || options['max-width'] || false
+        max_width = max_width.to_s if max_width
+
+        # Build picture element for local images
+        build_picture_element(src, src_path, extension, max_width, options)
+      end
+    end
+
+    private
+
+    def parse_arguments(markup)
+      args = []
+      current_arg = ''
+      in_quotes = false
+      quote_char = nil
+
+      markup.each_char do |char|
+        if !in_quotes && (char == '"' || char == "'")
+          in_quotes = true
+          quote_char = char
+          current_arg += char
+        elsif in_quotes && char == quote_char
+          in_quotes = false
+          quote_char = nil
+          current_arg += char
+        elsif !in_quotes && char == ','
+          args << current_arg.strip
+          current_arg = ''
+        else
+          current_arg += char
+        end
+      end
+
+      args << current_arg.strip if current_arg.strip.length > 0
+      args
+    end
+
+    def parse_options(option_args)
+      options = {}
+
+      option_args.each do |arg|
+        if arg.include?('=')
+          key, value = arg.split('=', 2)
+          key = key.strip.gsub(/^['"]|['"]$/, '')
+          value = value.strip.gsub(/^['"]|['"]$/, '')
+          options[key] = value
+        end
+      end
+
+      options
+    end
+
+    def resolve_variable(context, variable_input)
+      # Strip quotes if present
+      if variable_input.match(/^['"]/)
+        variable_input.gsub(/^['"]|['"]$/, '')
+      else
+        # Resolve as variable
+        parts = variable_input.split('.')
+        current = context
+
+        parts.each do |part|
+          return nil unless current.respond_to?(:[]) || current.is_a?(Hash)
+          current = current[part]
+          return nil if current.nil?
+        end
+
+        current
+      end
+    end
+
+    def build_picture_element(src, src_path, extension, max_width, options)
+      html = "<picture>\n"
+
+      # Add WebP sources unless disabled
+      unless options['webp'] == 'false'
+        html += build_webp_sources(src_path, max_width)
+      end
+
+      # Add original format sources
+      html += build_original_sources(src_path, extension, max_width, src)
+
+      # Build img tag
+      alt = options['alt'] || ''
+      css_class = options['class'] || ''
+      style = options['style'] || ''
+      width = options['width'] || ''
+      height = options['height'] || ''
+
+      html += "<img\n"
+      html += "src=\"data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\"\n"
+      html += "data-lazy=\"@src #{src}\"\n"
+      html += "class=\"#{css_class}\"\n" unless css_class.empty?
+      html += "alt=\"#{alt}\"\n"
+      html += "style=\"#{style}\"\n" unless style.empty?
+      html += "width=\"#{width}\"\n" unless width.empty?
+      html += "height=\"#{height}\"\n" unless height.empty?
+      html += ">\n"
+      html += "</picture>"
+
+      html
+    end
+
+    def build_webp_sources(src_path, max_width)
+      html = ""
+
+      case max_width
+      when "320"
+        html += "<source data-lazy=\"@srcset #{src_path}-320px.webp\" type=\"image/webp\">\n"
+      when "640"
+        html += "<source data-lazy=\"@srcset #{src_path}-320px.webp\" media=\"(max-width: 320px)\" type=\"image/webp\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-640px.webp\" type=\"image/webp\">\n"
+      when "1024"
+        html += "<source data-lazy=\"@srcset #{src_path}-320px.webp\" media=\"(max-width: 320px)\" type=\"image/webp\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-640px.webp\" media=\"(max-width: 640px)\" type=\"image/webp\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-1024px.webp\" type=\"image/webp\">\n"
+      else
+        html += "<source data-lazy=\"@srcset #{src_path}-320px.webp\" media=\"(max-width: 320px)\" type=\"image/webp\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-640px.webp\" media=\"(max-width: 640px)\" type=\"image/webp\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-1024px.webp\" media=\"(max-width: 1024px)\" type=\"image/webp\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}.webp\" type=\"image/webp\">\n"
+      end
+
+      html
+    end
+
+    def build_original_sources(src_path, extension, max_width, src)
+      html = ""
+
+      case max_width
+      when "320"
+        html += "<source data-lazy=\"@srcset #{src_path}-320px#{extension}\">\n"
+      when "640"
+        html += "<source data-lazy=\"@srcset #{src_path}-320px#{extension}\" media=\"(max-width: 320px)\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-640px#{extension}\">\n"
+      when "1024"
+        html += "<source data-lazy=\"@srcset #{src_path}-320px#{extension}\" media=\"(max-width: 320px)\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-640px#{extension}\" media=\"(max-width: 640px)\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-1024px#{extension}\">\n"
+      else
+        html += "<source data-lazy=\"@srcset #{src_path}-320px#{extension}\" media=\"(max-width: 320px)\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-640px#{extension}\" media=\"(max-width: 640px)\">\n"
+        html += "<source data-lazy=\"@srcset #{src_path}-1024px#{extension}\" media=\"(max-width: 1024px)\">\n"
+        html += "<source data-lazy=\"@srcset #{src}\" media=\"(min-width: 1025px)\">\n"
+      end
+
+      html
+    end
+
+    def build_external_image(src, options)
+      # Build responsive img tag for external URLs
+      alt = options['alt'] || ''
+      css_class = options['class'] || ''
+      style = options['style'] || ''
+      width = options['width'] || ''
+      height = options['height'] || ''
+      loading = options['loading'] || 'lazy'
+
+      # Build img tag on a single line to prevent markdown parsing issues
+      html = "<img"
+      html += " src=\"data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\""
+      html += " data-lazy=\"@src #{src}\""
+      html += " class=\"#{css_class}\"" unless css_class.empty?
+      html += " alt=\"#{alt}\""
+      html += " style=\"#{style}\"" unless style.empty?
+      html += " width=\"#{width}\"" unless width.empty?
+      html += " height=\"#{height}\"" unless height.empty?
+      html += " loading=\"#{loading}\""
+      html += ">"
+
+      html
+    end
+  end
+end
+
+Liquid::Template.register_tag('uj_image', Jekyll::UJImageTag)