cyberweb 0.4.174

data/lib/cyberweb/images/images.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will store image-related code of interest to the
+# Cyberweb project.
+# =========================================================================== #
+# require 'cyberweb/images/images.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'yaml'
+  require 'cyberweb/images/path_to_images.rb'
+  require 'cyberweb/images/embed_this_image.rb'
+  require 'cyberweb/images/is_image.rb'
+  require 'cyberweb/images/string_image.rb'
+  require 'cyberweb/images/standalone_drag_and_drop_this_image.rb'
+  require 'cyberweb/images/remove_this_substring_from_all_images.rb'
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  require 'colours/colours_e_autoinclude.rb'
+  n_tests_to_perform = '4'
+  e Colours.rev+
+    'Now performing '+
+    Colours.lightgreen(n_tests_to_perform)+
+    ' short "tests":'
+  e Colours.slateblue(N+'(1)'+N)
+  e Cyberweb.string_image(
+    'cat.png'
+  )
+  e Colours.slateblue(N+'(2)'+N)
+  e Cyberweb.string_image(
+    'cat.png',
+    alt: 'Cat is shown here normally but first argument was a String'
+  )
+  e Colours.slateblue(N+'(3)'+N)
+  e Cyberweb.string_image(
+    'smiley.gif', alt: 'Smiley face'
+  )
+  e Colours.slateblue(N+'(4)'+N)
+  e Cyberweb.string_image(
+    img: 'cat.png', alt: 'Cat is shown here normally'
+  )
+  e
+  e Cyberweb.string_img(
+    'RPG/DSA/DSA_LOGO_BIG.png', id: 'drag_dsa_logo_big'
+  )
+  e
+end
+
+if __FILE__ == $PROGRAM_NAME
+  c = '<span style="margin-left:2em"><img src="/home/x/DATA/IMG/STUDIUM/TU_VIENNA_LOGO.png">
+      <span style="margin-left:2em"><img src="/home/x/DATA/IMG/STUDIUM/VETMED_LOGO_IMAGE.png">'
+  puts Cyberweb.remove_this_substring_from_all_images(:default, :default, c)
+  puts Cyberweb.is_image?('foobar.png')
+end

data/lib/cyberweb/images/is_image.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/images/is_image.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/constants/array_images.rb'
+  # ========================================================================= #
+  # === Cyberweb.is_image?
+  #
+  # This method will return true if the input is an image, otherwise
+  # it will yield false.
+  # ========================================================================= # 
+  def self.is_image?(this_file)
+    ARRAY_IMAGES.any? {|entry|
+      this_file.downcase =~ /\.#{entry}$/
+    }
+  end; self.instance_eval { alias is_this_an_image? is_image? } # === Cyberweb.is_this_an_image?
+
+end

data/lib/cyberweb/images/path_to_images.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/images/path_to_images.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/constants/roebe.rb'
+
+  # ========================================================================= #
+  # === @path_to_images
+  #
+  # The @path_to_images variable is initially hardcoded.
+  #
+  # It will lateron become sanitized and dynamic.
+  # ========================================================================= #
+  @path_to_images = Cyberweb.roebe_image_dir?
+
+  # ========================================================================= #
+  # === Cyberweb.path_to_images?
+  #
+  # This method will always give us back the path to the images.
+  # ========================================================================= #
+  def self.path_to_images?
+    @path_to_images.to_s # .to_s to safeguard against any possible nil.
+  end; self.instance_eval { alias path_to_image_dir? path_to_images? } # === Cyberweb.path_to_image_dir?
+       self.instance_eval { alias path_to_img_dir?   path_to_images? } # === Cyberweb.path_to_img_dir?
+
+  # ========================================================================= #
+  # === Cyberweb.set_path_to_images
+  #
+  # This method can be used to set a path to a global image-directory.
+  # ========================================================================= #
+  def self.set_path_to_images(
+      i = @path_to_images
+    )
+    case i
+    when :default # Set default before entering the case-menu.
+      i = @path_to_images
+    end
+    case i
+    when nil
+      i = path_to_images?
+    end
+    i = i.to_s.dup
+    unless i.end_with? '/'
+      i << '/' unless i.empty?
+    end
+    @path_to_images = i
+  end; self.instance_eval { alias set_image_base_directory set_path_to_images }
+
+  # ========================================================================= #
+  # === Cyberweb.use_absolute_image_path
+  # ========================================================================= #
+  def self.use_absolute_image_path
+    set_path_to_images('')
+  end
+
+end

data/lib/cyberweb/images/real/README.md

@@ -0,0 +1,6 @@
+This directory used to contain the "real" images, aka .jpg
+or .png files, for the Cyberweb component.
+
+In September 2020 this had to be reverted, though, due to
+some bugs. At a later time I may re-evaluate this, but for
+now this file, as a notice, has to suffice.

data/lib/cyberweb/images/remove_this_substring_from_all_images.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/images/remove_this_substring_from_all_images.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/constants/roebe.rb'
+  # ========================================================================= #
+  # === Cyberweb.remove_this_substring_from_all_images
+  #
+  # The code in this method can be used to replace all paths of images
+  # in e. g. a HTML file (stored as String).
+  #
+  # The functionality was needed because I have had absolute paths to
+  # images, which needed to be turned into relative paths instead.
+  # ========================================================================= #
+  def self.remove_this_substring_from_all_images(
+      look_for_this_component     = HOME_X_DATA,
+      replace_it_with_that_string = '../',
+      use_this_string             = nil
+    )
+    if use_this_string
+      case look_for_this_component
+      # ===================================================================== #
+      # === :default
+      # ===================================================================== #
+      when :default
+        look_for_this_component = HOME_X_DATA
+      end
+      case replace_it_with_that_string
+      when :default
+        replace_it_with_that_string = '../'
+      end
+      use_this_string = use_this_string.dup if use_this_string.frozen?
+      use_this_string.gsub!(
+        /\<img src="#{look_for_this_component}/,
+        '<img src="'+replace_it_with_that_string
+      )
+    end
+  end
+
+end

data/lib/cyberweb/images/standalone_drag_and_drop_this_image.rb

@@ -0,0 +1,64 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/images/standalone_drag_and_drop_this_image.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/javascript/drag_and_drop.rb'
+  # ========================================================================= #
+  # === Cyberweb.standalone_drag_and_drop_this_image
+  #
+  # This method has been added on 23.04.2019, mostly because I needed a
+  # simpler API to embed an image into a sinatra-application while also
+  # adding support for dragging this image with the mouse. The jquery
+  # library supports drag-and-drop operations performed on an image.
+  #
+  # The first argument to this method should be the URL to a remote image.
+  # However had, a local path could also be used, since we will only
+  # insert into the src="" attribute of the <img> tag anyway.
+  #
+  # Note that this will return a String - you have to handle the display
+  # of that String, should you want this, on your own.
+  #
+  # Usage example:
+  #
+  #   Cyberweb.standalone_drag_and_drop_this_image('https://upload.wikimedia.org/wikipedia/commons/thumb/5/57/Devicon-ruby-plain-wordmark.svg/512px-Devicon-ruby-plain-wordmark.svg.png')
+  #
+  # ========================================================================= #
+  def self.standalone_drag_and_drop_this_image(
+      url_to_the_image,  # <- The remote URL to the image that you wish to drag/drop-support.
+      optional_css_class = '',
+      optional_id        = nil,
+      optional_css_style = ''
+    )
+    _ = ''.dup
+    # ======================================================================= #
+    # We currently rely on a hardcoded remote path to jquery - not very
+    # elegant, but it is simple and effective:
+    # ======================================================================= #
+    _ << '<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>'+"\n"
+    _ << '<script src="https://code.jquery.com/ui/1.12.1/jquery-ui.min.js"></script>'+"\n"
+    if optional_id.nil?
+      # ===================================================================== #
+      # In this case we will infer an id from the filename.
+      # ===================================================================== #
+      optional_id = File.basename(url_to_the_image)
+    end
+    optional_id = optional_id.
+                  sub(/#{File.extname(url_to_the_image)}$/,'').to_s.
+                  tr('-','_').gsub(/[0-9]/,'')
+    _ << '<img src="'+url_to_the_image.to_s+'"'
+    if optional_css_class and !optional_css_class.empty?
+      _ << ' class="'+optional_css_class+'"'
+    end
+    if optional_css_style and !optional_css_style.empty?
+      _ << " style=\"#{optional_css_style}\""
+    end
+    _ << ' id="'+optional_id+'">'+"\n"
+    _ << return_javascript_drag_and_drop(optional_id)+"\n"
+    _ # Return it finally.
+  end; self.instance_eval { alias drag_this_image_id standalone_drag_and_drop_this_image } # === Cyberweb.drag_this_image_id
+
+end

data/lib/cyberweb/images/string_image.rb

@@ -0,0 +1,399 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/images/path_to_images.rb'
+# Cyberweb.string_image
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/requires/require_web_images.rb'
+  require 'cyberweb/constants/file_constants.rb'
+  require 'cyberweb/toplevel_methods/filename.rb' # ← Necessary for the method Cyberweb.register_this_filename()
+  require 'cyberweb/toplevel_methods/css.rb'
+  require 'cyberweb/toplevel_methods/registered_ids.rb'
+
+  # ========================================================================= #
+  # === string_img                                                   (sg tag)
+  #
+  # This method is just a wrapper over the module-level method called
+  # Cyberweb.string_img(). Please refer to that method, in this file
+  # here, for more information.
+  # ========================================================================= #
+  def string_img(
+      url        = '',    # entry 1
+      css_class  = '',    # entry 2
+      the_id     = '',    # entry 3
+      css_style  = '',    # entry 4
+      new_line   = 0,     # entry 5
+      alt        = '',    # entry 6
+      to_img_dir = 'def', # entry 7
+      usemap     = '',    # entry 8
+      javascript = '',    # entry 9
+      &block
+    )
+    ::Cyberweb.string_image(
+      url,
+      css_class,
+      the_id,
+      css_style,
+      new_line,
+      alt,
+      to_img_dir,
+      usemap,
+      javascript,
+      &block
+    )
+  end; alias sg           string_img # === sg # the main thing to use since 2011.
+       alias string_image string_img # === string_image
+       alias simg         string_img # === simg
+       alias s_img        string_img # === s_img
+       alias s_image      string_img # === s_image
+
+  # ========================================================================= #
+  # === Cyberweb.string_image
+  #
+  # This method will try to "create" a HTML <img> tag. It will hold a
+  # reference to the image at hand, as a String. This String can then
+  # be used to be put to use for a web-page or some other web-app
+  # related program.
+  #
+  # This method here must remain as flexible as possible.
+  #
+  # If an alt-value is passed, and this value is the Symbol called :def,
+  # then the string 'Missing_Image' will be used.
+  #
+  # If you pass a Hash and wish to denote the image file at hand,
+  # use either of the two symbols :img or :src as the key.
+  #
+  # The first entry in the given Array may also be a Symbol, in which
+  # case we may attempt to query the WebImages project for a
+  # corresponding image file.
+  #
+  # The third argument, if supplied, will be used for the ID of
+  # that particular HTML element. If this value for the ID is
+  # :drag then we enable drag and drop support for this image.
+  # This part depends on the availability of jquery. If this value
+  # is the Symbol :drag_and_highlight then we will enable both drag
+  # and drop, and also jquery-based highlighting (an on-click
+  # action).
+  #
+  # The fifth argument to this method is usually reserved for
+  # a Symbol called :newline or :new_line. If this is the case, or
+  # if the given input evaluates to true, or the .to_s call to it
+  # is equal to the string '1' then a newline will be appended.
+  # The reaso as to why '1' or 1 also works as input is so that
+  # we can write terse code - but I recommend to be explicit
+  # and just use :newline or something like that instead.
+  #
+  # The following lines gather some existing examples - the method must
+  # be able to deal with all of these properly:
+  #
+  #   sg('PC/HARDWARE/LAPTOP_LENOVO_110_17IKB.png','mar0_5em', :drag)
+  #
+  # The old code had hardcoded positions like these:
+  #
+  #     url        # 0
+  #     css_class  # 1
+  #     the_id     # 2
+  #     css_style  # 3
+  #     new_line   # 4
+  #     alt        # 5
+  #     to_img_dir # 6
+  #     usemap     # 7
+  #     javascript # 8
+  #
+  # This is still supported, in principle - but using a Hash may be a lot
+  # better if you have to pass in a lot of arguments.
+  #
+  # Some specific examples follow next:
+  #
+  #   Cyberweb.string_img 'LG_GSA_4163.png' # => <img src="/home/x/data/images/LG_GSA_4163.png">
+  #   Cyberweb.string_img(:external) # => <img src="/home/x/data/images/STD/EXTERNAL_LINK.png">
+  #   Cyberweb.string_img 'diamond_logo' # => <img src="/home/x/data/images/diamond_logo">
+  #   Cyberweb.string_img(:external,'', :drag_and_highlight) # => <img src="/Users/x/DATA/IMG/STD/EXTERNAL_LINK.png" <script> etc.
+  #   Cyberweb.string_img :external # => <img src="/home/x/data/images/STD/EXTERNAL_LINK.png">
+  #   Cyberweb.string_img url
+  #   Cyberweb.string_img 'LG_GSA_4163.png','style','id',0,'altern name',Cyberweb::TID[0]
+  #   Cyberweb.string_img '','class','style','id',0,'alt_name','def',nil,'onClick'
+  #   Cyberweb.string_img(
+  #     'PC/HARDWARE/VOICE_RECORDER_OLYMPUS_360.png',
+  #     id: 'drag_olympus',
+  #     css: 'mars1em')
+  #   Cyberweb.string_img('RPG/DSA/DSA_LOGO_BIG.png', id: 'drag_dsa_logo_big')
+  #   Cyberweb.string_img('SITEMAP/SITEMAP_REAL.png', id: 'draggable_sitemap', css_style: 'z-index: -2;') # => <img src="/home/x/data/images/SITEMAP/SITEMAP_REAL.png" id="draggable_sitemap" style="z-index: -2;">
+  #   Cyberweb.string_img('HARDWARE/ANSCHLÜSSE/HDMI_KABEL_ANSCHLUSS.jpg','bblack1 marl2em',
+  #     :guess_draggable_id)
+  #   rose = Cyberweb.sg('web_object/lib/web_object/images/real/ROSE.png.png', 'mar20px FLR', 'drag_rose', 'margin-right: 40%' ) { :do_not_prepend_anything }
+  #
+  # ========================================================================= #
+  def self.string_image(
+      *i,
+      &block
+    )
+    # ======================================================================= #
+    # === url
+    #
+    # The url variable will store the "URL" of the image at hand. It is
+    # in some ways the most important variable, because it will be used
+    # as the input to <img src="">.
+    # ======================================================================= #
+    url = ''.dup
+    first_entry = i.first # This can be a Hash or a String. Is equivalent to i[0].
+    # ======================================================================= #
+    # Check whether the image is registered as part of WebImages.
+    # ======================================================================= #
+    if webimages_is_included?(first_entry) and !File.exist?(first_entry.to_s) 
+      first_entry = get_webimage(first_entry) # bl $CYBERWEB/get_webimage/webimages.rb
+    end
+    # ======================================================================= #
+    # Next, handle the second entry given. This can be a Hash, but it may
+    # also be a String. If it is a String then we assume it to mean a CSS
+    # class.
+    # ======================================================================= #
+    second_entry   = i[1] # ← Remember: this can also be a Hash. This is the css-class.
+    third_entry    = i[2] # ← This may be missing. If not missing then it is the id. Can also be a symbol like :drag
+    fourth_entry   = i[3] # ← This is the css style.
+    fifth_entry    = i[4] # ← This is for making a newline.
+    sixth_entry    = i[5] # ← This is for the alt tag.
+    _seventh_entry = i[6] # ← This is for to_img_dir
+    # _eight_entry = i[7]
+    javascript     = i[8].to_s.dup # ← This is for javascript
+    result = '<img src="'.dup
+    use_in_dir_images = use_in_dir_images?
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # This entry point essentially means that we will not prepend any
+      # special string in order to find the corresponding web-image at
+      # hand.
+      # ===================================================================== #
+      when :use_absolute_path,
+           :absolute_path,
+           :do_not_prepend_anything
+        use_in_dir_images = true
+      end
+    end
+    if use_in_dir_images == false
+      # ===================================================================== #
+      # If we do not use in-dir images then we will prepend the
+      # relative path to the IMG directory - unless the File
+      # exists.
+      # ===================================================================== #
+      result << path_to_images?.to_s
+    end
+    # ======================================================================= #
+    # === Handle the cases where the second_entry is a Hash
+    # ======================================================================= #
+    if second_entry.is_a? Hash
+      if second_entry.has_key? :css_style
+        fourth_entry = second_entry.delete(:css_style)
+      end
+    end
+    if first_entry.is_a?(String) and second_entry.is_a? Hash
+      # ===================================================================== #
+      # We convert the first_entry into a Hash as well, if it was a String
+      # and the second entry was a Hash too. This allows us to easily
+      # merge the two together lateron.
+      # ===================================================================== #
+      first_entry = { src: first_entry } # ← Now first_entry will be a Hash as well.
+    end
+    if first_entry.is_a? Hash
+      if second_entry.is_a? Hash
+        # =================================================================== #
+        # Merge the two together next:
+        # =================================================================== #
+        first_entry.merge!(second_entry)
+        second_entry = nil
+      end
+      # ===================================================================== #
+      # Handle Hashes next, always starting with an :img key. Both :img
+      # and :src are equivalent.
+      # ===================================================================== #
+      if first_entry.has_key? :src
+        url = first_entry.delete(:src)
+      # ===================================================================== #
+      # === :img
+      # ===================================================================== #
+      elsif first_entry.has_key? :img
+        url = first_entry.delete(:img)
+      end
+      # ===================================================================== #
+      # === :css_class
+      # ===================================================================== #
+      if first_entry.has_key? :css_class
+        second_entry = first_entry.delete(:css_class)
+      end
+    else # else simply use the first_entry as URL. But ideally we would
+         # use a :src or :img identifier here.
+      url = first_entry
+    end
+    if url.is_a? String
+      url = rds(url) if url.include?('//')
+    end
+    result << url # Append the URL.
+    result << '"'
+    # ======================================================================= #
+    # === Handle the case where first_entry is a Hash and has an entry
+    #     called :alt.
+    # ======================================================================= #
+    if first_entry.is_a?(Hash) and first_entry.has_key?(:alt)
+      value_for_alt = first_entry.delete(:alt)
+      value_for_alt = 'Missing_Image' if value_for_alt == :def
+      result << ' alt="'+value_for_alt+'"'
+    end
+    if first_entry.is_a?(Hash)
+      if first_entry.has_key?(:newline) or
+         first_entry.has_key?(:new_line)
+        result << N
+      end
+      # ===================================================================== #
+      # Re-assign the id entry to the third_entry variable:
+      # ===================================================================== #
+      if first_entry.has_key? :id
+        third_entry = first_entry.delete(:id)
+      end
+    end
+    # ======================================================================= #
+    # If the third entry exists and is not empty, we assume it to be a
+    # CSS class. The variable used to be called css_class.
+    # ======================================================================= #
+    if second_entry and second_entry.is_a?(String) and !second_entry.empty?
+      result << return_css_class(second_entry)
+    end
+    # ======================================================================= #
+    # === The ID of the image object
+    #
+    # Handle IDs passed into this method next. This has to support quite
+    # a few different symbols, such as :guess_draggable_id and other
+    # variants.
+    # ======================================================================= #
+    if third_entry
+      # ===================================================================== #
+      # If the user enabled global drag-support for all images, then this
+      # setting will be checked in the following subsection. If true, the
+      # string 'drag_' will be prepended to the id of our image in question.
+      # ===================================================================== #
+      if respond_to?(:web_object?) and web_object?
+        if web_object?.drag_all_images?
+          # ================================================================= #
+          # We need to be careful - if the id is empty, then we must come up
+          # with an ID name on our own. Otherwise, we can indeed just prepend.
+          # ================================================================= #
+          if third_entry.empty? # Invent a new id.
+            third_entry = 'drag_'+File.basename(url).tr(' .,','_')
+          else # else the existing ID will be used, and the String prepended to it.
+            case third_entry
+            # =============================================================== #
+            # === :guess_draggable_id
+            # =============================================================== #
+            when :guess_draggable_id
+              third_entry = 'drag_'+File.basename(url).gsub(File.extname(url),'')
+            end
+            third_entry = third_entry.to_s
+            third_entry = third_entry.dup if third_entry.frozen?
+            third_entry.prepend('drag_') unless third_entry.to_s.start_with? 'drag_'
+          end
+        end
+      end
+      if third_entry.is_a?(String) and !third_entry.empty?
+        result << return_the_id(third_entry)
+      # ===================================================================== #
+      # === Handle Symbols next
+      # ===================================================================== #
+      elsif third_entry.is_a? Symbol
+        # =================================================================== #
+        # === third_entry (which is the ID)
+        #
+        # Handle the case when we passed :drag or similar symbols to the ID
+        # that is to be used.
+        #
+        # This has to occur after we handled Hashes given as input.
+        # =================================================================== #
+        case third_entry # ← This is the ID
+        # =================================================================== #
+        # === :drag_and_highlight
+        # =================================================================== #
+        when :drag_and_highlight # Handle more complex Symbols here.
+          third_entry = 'drag_'+File.basename(url).gsub(File.extname(url),'')
+          # ================================================================= #
+          # In this case, we also highlight that particular entry.
+          # ================================================================= #
+          result << string_highlight(third_entry)
+        # =================================================================== #
+        # === :on_click_darken,
+        # =================================================================== #
+        when :on_click_darken,
+             :darken_on_click, # Handle on-click events for darkening an image.
+             :on_click_highlight
+          unless the_id.to_s.empty?
+            javascript = javascript.dup if javascript.frozen?
+            javascript << on_click_change_opacity(the_id).to_s
+          end
+        # =================================================================== #
+        # === :guess_draggable_id
+        # =================================================================== #
+        when :guess_draggable_id,
+             :drag,
+             /^drag/
+          third_entry = 'drag_'+File.basename(url).gsub(File.extname(url),'')
+          # ================================================================= #
+          # javascript_drag_and_drop(the_id)
+          # ^^^ We do not need to do the above because as we already
+          # prepend drag_ to it, it will be automatically activated
+          # in the file id.rb lateron.
+          # ================================================================= #
+        # =================================================================== #
+        # === :guess_id
+        #
+        # This will simply "guess" the ID to use.
+        # =================================================================== #
+        when :guess_id
+          third_entry = File.basename(url).gsub(File.extname(url),'')
+        end
+        result << return_the_id(third_entry)
+      end
+    end
+    # ======================================================================= #
+    # Next, handle css-style. We have to use .to_s here because a number
+    # such as 0 may also be passed into this method, even though this
+    # seems to be fairly useless.
+    # ======================================================================= #
+    if fourth_entry and !fourth_entry.to_s.empty?
+      result << return_css_style(fourth_entry.to_s)
+    end
+    # ======================================================================= #
+    # Next, handle the optional alt-tag:
+    # ======================================================================= #
+    if sixth_entry and !sixth_entry.empty?
+      result << " alt=\"#{sixth_entry}\""
+    end
+    if fifth_entry
+      case fifth_entry.to_s
+      when '1'
+        result << N
+      end
+    end
+    # ======================================================================= #
+    # Register the filename that is passed to us.
+    # ======================================================================= #
+    register_this_filename(url)
+    if javascript and !javascript.empty?
+      result << " #{javascript}"
+      result.squeeze!(' ')
+    end
+    # ======================================================================= #
+    # Append closing tag.
+    # ======================================================================= #
+    result << '>' unless result.end_with? '>'
+    result << N
+    return result # Finally, return our finding.
+  end; self.instance_eval { alias string_img string_image } # === Cyberweb.string_img
+       self.instance_eval { alias sg         string_image } # === Cyberweb.sg
+       self.instance_eval { alias simg       string_image } # === Cyberweb.simg
+
+end

data/lib/cyberweb/images_base64_encoded/AUSRUFUNGSZEICHEN.png.md

@@ -0,0 +1 @@
+iVBORw0KGgoAAAANSUhEUgAAABIAAAASCAMAAABhEH5lAAAABGdBTUEAALGPC/xhBQAAAAFzUkdCAK7OHOkAAAKjUExURQAAAEQ1MjYfHi0RETIeHG8EChsbEj0jJEYxMDseHjcAAS0AAz8eIAAAAEA1MAAIAMwgMjsuLCUAADklJ04XGYASG7oIFdkfKzQfHd0dLdFxetUwPPXP0u/IxT4EBfLCwtA1Q+CsrNyVl9empea8tdeAg9hcX+yLiiMTD+e+utNtcMUhJOWyuOKgq8YSIIFsb7tFUW1jYYFgZ593fIRVWrtWW8pCSKt4fMZKUHw+Q08JDbNxd38OErVjadFbXbIIEtgNJrh3d9wBEHoiJn41OOmqs8sUJLlOUGUNDd59h8oZJNqUl5ZcXYZISjQcGvQXKPjO2GkaI1xYVDc0L2FHSUxFQh4OCTQYFq4QGdcdLfSyu8iKjjEREKsnLB0CAdxbXmMODPfZ4KgSHKwGC9USJEExLngACeCurjgdHAAAAAcQCqcAACMAACgGBqQMDSwJCbkTGc4AABIAAMOIgMoECfLO1eqao70iJeCqprgCCrYYGvHT1erJyNphaa0AAMtyZrYWFcsaIeKcmu3Ny+i8uMs8OOOQkscABemcmu3EwqsAAN1cZMsgMey4uOqprOaUmKMAAP///+SqqtgjOaQAAMVTU98eMt4fMq8AAN4cMd0dMcAEENkjOdgkOkAAAOOqqr4PFyIAAOi4uMITHcQVIMMTHcUVIsUVIGQAAccRIsQVIssSI+MbGdshMb4PGWEVGcYNIMkRIL0MFAAAALgJELIKFc5JTdkkOt4AANwAAOIFAHIYHZoAAF8AAN0dMLsKEr0OFskRHjoAAMwcHMgAAKUAAE4AAOGlperExMlcXM4cHNEuLtAuLujDwsZcW9+lpFIAAKkeHeKqqqUHBebCwqkZFurDwuicoLEnJbEsKakOC+mboOihpb8ABOeeodAAAMsAAEUP3qsAAACQdFJOUwAVDT5I85MDBBbNifD2P9X9g/7H/e7+/if+5fsCDMY4+laZt3TX68F8JPb7BSD2B6EcIQZYzv4X9J3cQd6H/vf+PPb+8Qb+mtpW3Bd9x1b+E6ZQpVyeupf7/oBT1Njm7O0D+P79398V+vng+Pr3/P7+/v6U/jrD+zj+8wx26/7P/ftuJbXxr/3jVf75/p3i588o6TsAAAFhSURBVBjTAVYBqf4AAGF7g4mNjtze19uPhoJ4ZywAABxQdXyEiIuM3eDfh4V/c1stRQAdH1p2fYGK2tjZ1dOAel0wSUsAKSQnX3d+kNaRkdTReWQuSkdBACEjJitjkJTSkZGSkJCwQEJITAAiGhsWtZSQkpGRkpSUqb5Pnk0AJSAZq66QkJKRkZKQkKatl71EACoXnJOykJCSkZGSkJCkl5a8QwA+rJOTtJCUkpGRkpCUo5eXm7sAtrqdk7+QkJ+RkZ+QkKWWlpuvADa5nZPAkJCikZGikJCnlpaoFAA4uLeToJCQlZWVlZCQqpqaEgwANbOTnKCQkMmVlc6QkLGZmQ0TAD06P1nBlJDHkZHPkJBGEAUPEQA7OTxicMWYyJGRzZiYWBUKBg4ANzRRZmtxxMrLzMN0bmAeCwQBADMyVFNqaXKe0MbCbF5WKAMJCAAALzFSVWVob6GhbVxXThgCBwAArpmbdTKhrAAAAABJRU5ErkJggg==

data/lib/cyberweb/images_base64_encoded/BLUEARROW.png.md

@@ -0,0 +1 @@
+iVBORw0KGgoAAAANSUhEUgAAACcAAAATBAMAAADhZgm9AAAABGdBTUEAALGPC/xhBQAAAAFzUkdCAK7OHOkAAAAtUExURQAAACSRtgBtkdr//2222ki22pHa2tra/7ba2ki2trba/5G22iS2tiSRkUiRtpYvcdEAAAABdFJOUwBA5thmAAAAkUlEQVQY02NgwA6YU4UxxNgD3Q0wBBuDMTWzH8ViIosAFkFDB6IELRYw2KAJsqeKAM2cjCLWIqQUwMDAJY0kZOaopKQJcrVjAlyMVQkIwN4zEYMLcispXlIsADMTw+GigXFK4tAAcYyAGekqpNQACyZH0XRmA4MKV0E3ITWErWUTBYHArYBZCNXVxsxgZzLgBAAJFhSziyUU/gAAAABJRU5ErkJggg==