cyberweb 0.12.35

data/lib/cyberweb/web_images/map_symbol_to_image_location.rb

@@ -0,0 +1,1820 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will map a given input, as a Symbol, to the corresponding
+# image, as part of the WebImages interface.
+# =========================================================================== #
+# require 'cyberweb/web_images/map_symbol_to_image_location.rb'
+# duck = Cyberweb.get_webimage :duck
+# =========================================================================== #
+module Cyberweb
+
+module WebImages
+
+  require 'cyberweb/web_images/array_listing_all_project_images.rb'
+  require 'cyberweb/configuration/configuration.rb'
+  require 'cyberweb/project/project.rb'
+  require 'cyberweb/constants/constants.rb'
+
+  # ========================================================================= #
+  # === Cyberweb::WebImages::IMG_DIR
+  #
+  # This constant points to the main image directory. In September 2020
+  # I tried to bundle the images within the Cyberweb project, but I ran
+  # into problems so I had to revert this for now.
+  #
+  # At a later time I may re-evaluate this decision. The next line of code
+  # will be retained as a reminder.
+  #
+  # In 2023 this was re-enabled again.
+  # ========================================================================= #
+  # IMG_DIR = "#{::Cyberweb.project_base_dir?}images/real/"
+  # IMG_DIR = 'STD/'
+  IMG_DIR = "#{Cyberweb.project_base_dir?}images/standard_images/"
+
+  # ========================================================================= #
+  # === Cyberweb::WebImages.map_symbol_to_image_location
+  #
+  # This method will try to "convert" the given input, which is assumed
+  # to be a Symbol, to a corresponding image, or more accurately, the
+  # path to an image. This thus allows us to use something like
+  # :camera as a placeholder for an image showing a camera. It is
+  # typically used to make use of small icons that can be used in
+  # a modern webpage.
+  #
+  # Since as of December 2011 this method will downcase the given input
+  # if it is a symbol. It seems to be easier to handle input if this
+  # constraint is in place, sanitizing any possibly "faulty" input
+  # along the way..
+  #
+  # To load the yaml file with our images, do:
+  #
+  #   bl $RUBY_SRC/cyberweb/lib/cyberweb/yaml/web_images.yml
+  #
+  # ========================================================================= #
+  def self.map_symbol_to_image_location(
+      i = :random,
+      &block
+    )
+    _ = i # Keep a reference copy.
+
+    _ = _.to_s.downcase.to_sym if _.is_a? Symbol # ← Added this in December 2011.
+
+    if _.is_a? String # input should be a Symbol, not a String.
+      _[0,1] = '' if _.start_with? ':'
+      _ = _.to_sym # Finally, convert it to Symbol here anyway.
+    end
+    case _
+    # ======================================================================= #
+    # === :random
+    #
+    # This entry point will fetch a random image from all registered
+    # images that are part of the Cyberweb project.
+    # ======================================================================= #
+    when :random,
+         :rand, # only allowed special value for random entries here.
+         :random_image
+      # url = get_proper_url(Cyberweb::ARRAY_LISTING_ALL_PROJECT_IMAGES.sample(1)[0])
+      _ = get_proper_url(
+        ARRAY_LISTING_ALL_PROJECT_IMAGES.sample(1)[0]
+      )
+    end
+
+    case _ # case tag
+    # ======================================================================= #
+    # === :admin
+    # ======================================================================= #
+    when :admin
+      _ = "#{IMG_DIR}ADMIN.png"
+    # ======================================================================= #
+    # === :ambulanz
+    # ======================================================================= #
+    when :ambulanz
+      _ = "#{IMG_DIR}AMBULANZ.png"
+    # ======================================================================= #
+    # === :angry_smiley
+    # ======================================================================= #
+    when :angry_smiley
+      _ = "#{IMG_DIR}ANGRY_SMILEY.png"
+    # ======================================================================= #
+    # === :approve
+    # ======================================================================= #
+    when :approve
+      _ = "#{IMG_DIR}/APPROVE.png"
+    # ======================================================================= #
+    # === :ausrufungszeichen
+    #
+    # This is also "aliased" to the german word "Anmerkung".
+    # ======================================================================= #
+    when :ausrufungszeichen,
+         :ruf,
+         :alert,
+         :ausrufen,
+         :ausrufung,
+         :ausruf,
+         :anmerkung,
+         :achtung,
+         :rufzeichen,
+         :information
+      _ = "#{IMG_DIR}AUSRUFUNGSZEICHEN.png"
+    # ======================================================================= #
+    # === :ausrufungszeichen2
+    # ======================================================================= #
+    when :ausrufungszeichen2
+      _ = "#{IMG_DIR}AUSRUFUNGSZEICHEN2.png"
+    # ======================================================================= #
+    # === :ausrufungszeichen3
+    # ======================================================================= #
+    when :ausrufungszeichen3
+      _ = "#{IMG_DIR}AUSRUFUNGSZEICHEN3.png"
+    # ======================================================================= #
+    # === :ausrufungszeichen4
+    # ======================================================================= #
+    when :ausrufungszeichen4
+      _ = "#{IMG_DIR}AUSRUFUNGSZEICHEN4.png"
+    # ======================================================================= #
+    # === :austria
+    # ======================================================================= #
+    when :austria,
+         :fahne,
+         :austria_fahne
+      _ = "#{IMG_DIR}cyberweb/images/standard_images/AUSTRIA_FAHNE.jpg"
+    # ======================================================================= #
+    # === :award
+    # ======================================================================= #
+    when :award
+      _ = "#{IMG_DIR}AWARD.png"
+    # ======================================================================= #
+    # === :axe
+    # ======================================================================= #
+    when :axe
+      _ = "#{IMG_DIR}AXE.png"
+    # ======================================================================= #
+    # === :blob
+    # ======================================================================= #
+    when :blob
+      _ = "#{IMG_DIR}BLOB.png"      
+    # ======================================================================= #
+    # === :backup_image
+    # ======================================================================= #
+    when :backup_image,
+         :backup
+      _ = "#{IMG_DIR}BACKUP_IMAGE.png"
+    # ======================================================================= #
+    # === :bagger
+    # ======================================================================= #
+    when :bagger
+      _ = "#{IMG_DIR}BAGGER.png"
+    # ======================================================================= #
+    # === :big_star
+    # ======================================================================= #
+    when :big_star,
+         :blue_star
+      _ = "#{IMG_DIR}BIG_STAR.png"
+    # ======================================================================= #
+    # === :bike
+    # ======================================================================= #
+    when :bike
+      _ = "#{IMG_DIR}BIKE.png"
+    # ======================================================================= #
+    # === :blog
+    # ======================================================================= #
+    when :blog
+      _ = "#{IMG_DIR}BLOG.png"
+    # ======================================================================= #
+    # === :bluearrow
+    # ======================================================================= #
+    when :bluearrow
+      _ = "#{IMG_DIR}BLUEARROW.png"
+    # ======================================================================= #
+    # === :blue_head
+    # ======================================================================= #
+    when :blue_head
+      _ = "#{IMG_DIR}BLUE_HEAD.gif"
+    # ======================================================================= #
+    # === :bohrer
+    # ======================================================================= #
+    when :bohrer
+      _ = "#{IMG_DIR}BOHRER.png"
+    # ======================================================================= #
+    # === :blue_pill
+    # ======================================================================= #
+    when :blue_pill
+      _ = "#{IMG_DIR}BLUE_PILL.png"
+    # ======================================================================= #
+    # === :cheering_person
+    # ======================================================================= #
+    when :cheering_person
+      _ = "#{IMG_DIR}CHEERING_PERSON.png"
+    # ======================================================================= #
+    # === :tux_bombe
+    # ======================================================================= #
+    when :tux_bombe
+      _ = 'PC/OS/LINUX/LINUX_FAVICON.png'
+    # ======================================================================= #
+    # === :blume
+    # ======================================================================= #
+    when :blume
+      _ = "#{IMG_DIR}BLUME.png"
+    # ======================================================================= #
+    # === :book_closed
+    # ======================================================================= #
+    when :book_closed
+      _ = "#{IMG_DIR}BOOK_CLOSED.png"
+    # ======================================================================= #
+    # === :book_opened
+    # ======================================================================= #
+    when :book_opened
+      _ = "#{IMG_DIR}BOOK_OPENED.png"
+    # ======================================================================= #
+    # === :books
+    # ======================================================================= #
+    when :books,
+         :buecher
+      _ = "#{IMG_DIR}BUECHER.jpg"
+    # ======================================================================= #
+    # === :buero_klammer
+    # ======================================================================= #
+    when :buero_klammer,
+         :klammer
+      _ = "#{IMG_DIR}BUERO_KLAMMER.png"
+    # ======================================================================= #
+    # === :bubble
+    # ======================================================================= #
+    when :bubble,
+         :sprech_blase,
+         :sprechblase
+      _ = "#{IMG_DIR}BUBBLE.png"
+    # ======================================================================= #
+    # === :business
+    # ======================================================================= #
+    when :business
+      _ = "#{IMG_DIR}BUSINESS.png"
+    # ======================================================================= #
+    # === :broadsword
+    # ======================================================================= #
+    when :broadsword
+      _ = 'RPG/WEAPONS/BROADSWORD.png'
+    # ======================================================================= #
+    # === :camera
+    # ======================================================================= #
+    when :camera
+      _ = "#{IMG_DIR}CAMERA.png"
+    # ======================================================================= #
+    # === :cat
+    # ======================================================================= #
+    when :cat
+      _ = "#{IMG_DIR}CAT.png"
+    # ======================================================================= #
+    # === :caution
+    # ======================================================================= #
+    when :caution
+      _ = "#{IMG_DIR}CAUTION.png"
+    # ======================================================================= #
+    # === :chaotic_image
+    # ======================================================================= #
+    when :chaotic_image
+      _ = "#{IMG_DIR}CHAOTIC_IMAGE.png"
+    # ======================================================================= #
+    # === :checkbox_off
+    # ======================================================================= #
+    when :checkbox_off,
+         :checkbox_empty
+      _ = "#{IMG_DIR}CHECKBOX_OFF.png"
+    # ======================================================================= #
+    # === :checkbox_on
+    # ======================================================================= #
+    when :checkbox_on,
+         :checkbox_checked,
+         :checkboxon,
+         :finished,
+         :done
+      _ = "#{IMG_DIR}CHECKBOX_ON.png"
+    # ======================================================================= #
+    # === :checked_checkbox
+    # ======================================================================= #
+    when :checked_checkbox
+      _ = "#{IMG_DIR}checked_checkbox.png"
+    # ======================================================================= #
+    # === :chest
+    # ======================================================================= #
+    when :chest
+      _ = 'RPG/STD/MINI_CHEST1.png'
+    # ======================================================================= #
+    # === :copy
+    # ======================================================================= #
+    when :copy
+      _ = "#{IMG_DIR}COPY.png"
+    # ======================================================================= #
+    # === :cute_bubba
+    # ======================================================================= #
+    when :cute_bubba,
+         :bubba
+      _ = "#{IMG_DIR}CUTE_BUBBA.png"
+    # ======================================================================= #
+    # === :string_complex
+    # ======================================================================= #
+    when :string_complex
+      _ = "#{IMG_DIR}COMPLEX.png"
+    # ======================================================================= #
+    # === :chronik
+    # ======================================================================= #
+    when :chronik
+      _ = 'RPG/STD/CHRONIK.png'
+    # ======================================================================= #
+    # === :closed
+    # ======================================================================= #
+    when :closed
+      _ = "#{IMG_DIR}CLOSED.png"
+    # ======================================================================= #
+    # === :components
+    # ======================================================================= #
+    when :components
+      _ = "#{IMG_DIR}COMPONENTS.png"
+    # ======================================================================= #
+    # === :computer
+    # ======================================================================= #
+    when :computer
+      _ = "#{IMG_DIR}COMPUTER.png"
+    # ======================================================================= #
+    # === :connected
+    # ======================================================================= #
+    when :connected
+      _ = "#{IMG_DIR}CONNECTED.png"
+    # ======================================================================= #
+    # === :contact
+    # ======================================================================= #
+    when :contact
+      _ = "#{IMG_DIR}CONTACT.png"
+    # ======================================================================= #
+    # === :css
+    # ======================================================================= #
+    when :css,
+         :css_image
+      _ = "#{IMG_DIR}CSS.png"
+    # ======================================================================= #
+    # === :cursor
+    # ======================================================================= #
+    when :cursor
+      _ = "#{IMG_DIR}CURSOR.png"
+    # ======================================================================= #
+    # === :develop
+    # ======================================================================= #
+    when :develop
+      _ = "#{IMG_DIR}DEVELOP.png"
+    # ======================================================================= #
+    # === :dice
+    # ======================================================================= #
+    when :dice
+      _ = 'RPG/STD/SMALL_DICE.png'
+    # ======================================================================= #
+    # === :dot1
+    #
+    # Also known as :black_dot.
+    # ======================================================================= #
+    when :dot1,
+         :dot,
+         :dot_01,
+         :dot101, # default do
+         :black_dot
+      _ = "#{IMG_DIR}DOT_01.png"
+    # ======================================================================= #
+    # === :dot2
+    # ======================================================================= #
+    when :dot2, :dot_02, :dot102
+      _ = "#{IMG_DIR}DOT_02.png"
+    # ======================================================================= #
+    # === :dot3
+    # ======================================================================= #
+    when :dot3, :dot_03, :dot103
+      _ = "#{IMG_DIR}DOT_03.png"
+    # ======================================================================= #
+    # === :dot4
+    # ======================================================================= #
+    when :dot4,
+         :dot_04,
+         :dot104
+      _ = "#{IMG_DIR}DOT_04.png"
+    # ======================================================================= #
+    # === :dot5
+    # ======================================================================= #
+    when :dot5, :dot_05, :dot105
+      _ = "#{IMG_DIR}DOT_05.png"
+    # ======================================================================= #
+    # === :dot6
+    # ======================================================================= #
+    when :dot6,
+         :dot_06,
+         :dot106
+      _ = "#{IMG_DIR}DOT_06.png"
+    # ======================================================================= #
+    # === :dot7
+    # ======================================================================= #
+    when :dot7,
+         :dot_07,
+         :dot107
+      _ = "#{IMG_DIR}DOT_07.png"
+    # ======================================================================= #
+    # === :dot8
+    # ======================================================================= #
+    when :dot8,
+         :dot_08,
+         :dot108
+      _ = "#{IMG_DIR}DOT_08.png"
+    # ======================================================================= #
+    # === :dot9
+    # ======================================================================= #
+    when :dot9,
+         :dot_09,
+         :dot109
+      _ = "#{IMG_DIR}DOT_09.png"
+    # ======================================================================= #
+    # === :dot10
+    # ======================================================================= #
+    when :dot10,
+         :dot_10,
+         :dot110
+      _ = "#{IMG_DIR}DOT_10.png"
+    # ======================================================================= #
+    # === :dot11
+    # ======================================================================= #
+    when :dot11,
+         :dot_11,
+         :dot111
+      _ = "#{IMG_DIR}DOT_11.png"
+    # ======================================================================= #
+    # === :dot12
+    # ======================================================================= #
+    when :dot12,
+         :dot_12,
+         :dot112
+      _ = "#{IMG_DIR}DOT_12.png"
+    # when :dot13, :dot_13
+    #   _ = "#{IMG_DIR}DOT13.png"
+    # when :dot14
+    #   _ = "#{IMG_DIR}DOT14.png"
+    # ======================================================================= #
+    # === :documentation
+    # ======================================================================= #
+    when :documentation
+      _ = "#{IMG_DIR}DOCUMENTATION.png"
+    # ======================================================================= #
+    # === :dokument
+    # ======================================================================= #
+    when :dokument,
+         :document
+      _ = "#{IMG_DIR}DOKUMENT.png"
+    # ======================================================================= #
+    # === :download
+    # ======================================================================= #
+    when :download
+      _ = "#{IMG_DIR}DOWNLOAD.png"
+    # ======================================================================= #
+    # === :download2
+    # ======================================================================= #
+    when :download2
+      _ = "#{IMG_DIR}DOWNLOAD2.png"
+    # ======================================================================= #
+    # === :duck
+    # ======================================================================= #
+    when :duck
+      _ = "#{IMG_DIR}DUCK.png"
+    # ======================================================================= #
+    # === :ducky
+    # ======================================================================= #
+    when :ducky
+      _ = "#{IMG_DIR}DUCKY.png"
+    # ======================================================================= #
+    # === :dukat
+    # ======================================================================= #
+    when :dukat
+      _ = 'RPG/STD/DUKAT.png'
+    # ======================================================================= #
+    # === :einkaufskorb
+    # ======================================================================= #
+    when :einkaufskorb
+      _ = "#{IMG_DIR}EINKAUFSKORB.png"
+    # ======================================================================= #
+    # === :einkaufswagen
+    # ======================================================================= #
+    when :einkaufswagen,
+         :trolley,
+         :shopping_cart,
+         :cart
+      _ = "#{IMG_DIR}EINKAUFSWAGEN.png"
+    # ======================================================================= #
+    # === :elephant
+    # ======================================================================= #
+    when :elephant
+      _ = "#{IMG_DIR}FUNNY_ELEPHANT.png"
+    # ======================================================================= #
+    # === :ellipse
+    # ======================================================================= #
+    when :ellipse
+      _ = "#{IMG_DIR}ELLIPSE.png"
+    # ======================================================================= #
+    # === :email
+    # ======================================================================= #
+    when :email
+      _ = "#{IMG_DIR}EMAIL_FAVICON.png"
+    # ======================================================================= #
+    # === :email_fancy
+    # ======================================================================= #
+    when :email_fancy,
+         :fancy_email
+      _ = "#{IMG_DIR}EMAIL_FANCY.png"
+    # ======================================================================= #
+    # === :english_flag
+    # ======================================================================= #
+    when :english_flag,
+         :english
+      _ = "#{IMG_DIR}ENGLISH.jpg"
+    # ======================================================================= #
+    # === :errors
+    # ======================================================================= #
+    when :errors
+      _ = "#{IMG_DIR}ERRORS.png"
+    # ======================================================================= #
+    # === :euro
+    # ======================================================================= #
+    when :euro
+      _ = "#{IMG_DIR}EURO.png"
+    # ======================================================================= #
+    # === :external_link
+    # ======================================================================= #
+    when :external_link,
+         :external,
+         :extern
+      _ = "#{IMG_DIR}EXTERNAL_LINK.png"
+    # ======================================================================= #
+    # === :eye
+    # ======================================================================= #
+    when :eye
+      _ = "#{IMG_DIR}EYE.png"
+    # ======================================================================= #
+    # === :faq
+    # ======================================================================= #
+    when :faq
+      _ = "#{IMG_DIR}FAQ.png"  
+    # ======================================================================= #
+    # === :fan
+    # ======================================================================= #
+    when :fan
+      _ = "#{IMG_DIR}FAECHER.png"
+    # ======================================================================= #
+    # === :fernglas
+    # ======================================================================= #
+    when :fernglas
+      _ = "#{IMG_DIR}FERNGLAS.png"
+    # ======================================================================= #
+    # === :flower_1
+    # ======================================================================= #
+    when :flower_1
+      _ = "#{IMG_DIR}FLOWER_1.png"
+    # ======================================================================= #
+    # === :flower_2
+    # ======================================================================= #
+    when :flower_2
+      _ = "#{IMG_DIR}FLOWER_2.png"
+    # ======================================================================= #
+    # === :folder
+    # ======================================================================= #
+    when :folder,
+         :dir,
+         :directory,
+         :directories,
+         :file
+      _ = "#{IMG_DIR}FOLDER.png"
+    # ======================================================================= #
+    # === :fork
+    # ======================================================================= #
+    when :fork
+      _ = "#{IMG_DIR}FORK.png"
+    # ======================================================================= #
+    # === :fotoapparat
+    # ======================================================================= #
+    when :fotoapparat
+      _ = "#{IMG_DIR}FOTOAPPARAT.png"
+    # ======================================================================= #
+    # === :fussball
+    # ======================================================================= #
+    when :fussball,
+         :football
+      _ = "#{IMG_DIR}FUSSBALL.png"
+    # ======================================================================= #
+    # === :gender_male
+    # ======================================================================= #
+    when :gender_male,
+         :male
+      _ = "#{IMG_DIR}GENDER_ICON_MALE.png"
+    # ======================================================================= #
+    # === :gender_female
+    # ======================================================================= #
+    when :gender_female,
+         :female
+      _ = "#{IMG_DIR}GENDER_ICON_FEMALE.png"
+    # ======================================================================= #
+    # === :germany
+    # ======================================================================= #
+    when :germany,
+         :german_flag,
+         :german
+      _ = "#{IMG_DIR}GERMANY_FLAG.png"
+    # ======================================================================= #
+    # === :geschenkbox
+    # ======================================================================= #
+    when :geschenkbox
+      _ = "#{IMG_DIR}GESCHENKBOX.png"
+    # ======================================================================= #
+    # === :get_help
+    # ======================================================================= #
+    when :get_help
+      _ = "#{IMG_DIR}GET_HELP.png"
+    # ======================================================================= #
+    # === :gitarre
+    # ======================================================================= #
+    when :gitarre,
+         :guitar
+      _ = "#{IMG_DIR}GITARRE.png"
+    # ======================================================================= #
+    # === :string_google
+    # ======================================================================= #
+    when :string_google,
+         :google
+      _ = "#{IMG_DIR}GOOGLE.png"
+    # ======================================================================= #
+    # === :gorilla
+    # ======================================================================= #
+    when :gorilla
+      _ = "#{IMG_DIR}GORILLA.gif"
+    # ======================================================================= #
+    # === :gothic
+    # ======================================================================= #
+    when :gothic
+      _ = "#{IMG_DIR}GOTHIC_SPACER.png"      
+    # ======================================================================= #
+    # === :grid
+    # ======================================================================= #
+    when :grid,
+         :grid_layout
+      _ = "#{IMG_DIR}GRID_LAYOUT.gif"
+    # ======================================================================= #
+    # === :gun
+    # ======================================================================= #
+    when :gun
+      _ = "#{IMG_DIR}GUN.png"
+    # ======================================================================= #
+    # === :haken
+    # ======================================================================= #
+    when :haken
+      _ = "#{IMG_DIR}HAKEN.png"
+    # ======================================================================= #
+    # === :halloween
+    # ======================================================================= #
+    when :halloween
+      _ = "#{IMG_DIR}HALLOWEEN.png"
+    # ======================================================================= #
+    # === :error_404
+    # ======================================================================= #
+    when :error_404
+      _ = "#{IMG_DIR}www/404_ERROR.png"
+    # ======================================================================= #
+    # === :hang_man
+    # ======================================================================= #
+    when :hang_man,
+         :hangman
+      _ = "#{IMG_DIR}HANG_MAN.png"
+    # ======================================================================= #
+    # === :hanging_monkey
+    # ======================================================================= #
+    when :hanging_monkey,
+         :monkey
+      _ = "#{IMG_DIR}HANGING_MONKEY.png"
+    # ======================================================================= #
+    # === :happy_bird
+    # ======================================================================= #
+    when :happy_bird
+      _ = "#{IMG_DIR}HAPPY_BIRD.png"
+    # ======================================================================= #
+    # === :happy_smiley
+    # ======================================================================= #
+    when :happy_smiley
+      _ = "#{IMG_DIR}HAPPY_SMILEY.png"            
+    # ======================================================================= #
+    # === :heart
+    # ======================================================================= #
+    when :heart,
+         :herz
+      _ = "#{IMG_DIR}HEART.png"
+    # ======================================================================= #
+    # === :home
+    # ======================================================================= #
+    when :home
+      _ = "#{IMG_DIR}HOME.gif"
+    # ======================================================================= #
+    # === :huhn
+    # ======================================================================= #
+    when :huhn
+      _ = "#{IMG_DIR}HUHN.gif"
+    # ======================================================================= #
+    # === :human
+    # ======================================================================= #
+    when :human
+      _ = "#{IMG_DIR}HUMAN.gif"
+    # ======================================================================= #
+    # === :internal
+    # ======================================================================= #
+    when :internal,
+         :internal_links
+      _ = "#{IMG_DIR}INTERNAL_LINKS.png"
+    # ======================================================================= #
+    # === :internet_explorer
+    # ======================================================================= #
+    when :internet_explorer,
+         :ie
+      _ = "#{IMG_DIR}IE.jpg"
+    # ======================================================================= #
+    # === :ipad
+    # ======================================================================= #
+    when :ipad
+      _ = "#{IMG_DIR}IPAD.png"
+    # ======================================================================= #
+    # === :item
+    # ======================================================================= #
+    when :item
+      _ = "#{IMG_DIR}ITEM.png"
+    # ======================================================================= #
+    # === :jewel
+    # ======================================================================= #
+    when :jewel
+      _ = 'RPG/MISC/JEWEL.gif'
+    # ======================================================================= #
+    # === :kaffee
+    # ======================================================================= #
+    when :kaffee
+      _ = "#{IMG_DIR}KAFFEE.png"
+    # ======================================================================= #
+    # === :keys
+    # ======================================================================= #
+    when :keys
+      _ = "#{IMG_DIR}KEYS.png"
+    # ======================================================================= #
+    # === :kleeblatt
+    # ======================================================================= #
+    when :kleeblatt
+      _ = "#{IMG_DIR}KLEE_BLATT.png"            
+    # ======================================================================= #
+    # === :knife
+    # ======================================================================= #
+    when :knife
+      _ = "#{IMG_DIR}KNIFE01.png"
+    # ======================================================================= #
+    # === :konflikt
+    # ======================================================================= #
+    when :konflikt
+      _ = 'RPG/WEAPONS/SWORD_BANNER01.png'
+    # ======================================================================= #
+    # === :kugeln
+    # ======================================================================= #
+    when :kugeln,
+         :bullets,
+         :bullet
+      _ = 'RPG/WEAPONS/KUGELN.png'
+    # ======================================================================= #
+    # === :larger_computer
+    # ======================================================================= #
+    when :larger_computer
+      _ = "#{IMG_DIR}LARGER_COMPUTER.png"
+    # ======================================================================= #
+    # === :lcd
+    # ======================================================================= #
+    when :lcd
+      _ = "#{IMG_DIR}LCD.png"    
+    # ======================================================================= #
+    # === :leaf
+    # ======================================================================= #
+    when :leaf
+      _ = "#{IMG_DIR}LEAF.png"
+    # ======================================================================= #
+    # === :leaf2
+    # ======================================================================= #
+    when :leaf2
+      _ = "#{IMG_DIR}LEAF2.png"
+    # ======================================================================= #
+    # === :lens
+    # ======================================================================= #
+    when :lens
+      _ = "#{IMG_DIR}LENS.png"
+    # ======================================================================= #
+    # === :links
+    # ======================================================================= #
+    when :links
+      _ = 'LINKS/LINKSsmall2.jpg'
+    # ======================================================================= #
+    # === :lock
+    # ======================================================================= #
+    when :lock
+      _ = "#{IMG_DIR}LOCK.png"
+    # ======================================================================= #
+    # === :lupe
+    # ======================================================================= #
+    when :lupe,
+         :lup
+      _ = "#{IMG_DIR}LUPE.gif"
+    # ======================================================================= #
+    # === :man
+    # ======================================================================= #
+    when :man
+      _ = "#{IMG_DIR}SYMBOL_MANN.png"
+    # ======================================================================= #
+    # === :mantis
+    # ======================================================================= #
+    when :mantis
+      _ = "#{IMG_DIR}MANTIS.png"
+    # ======================================================================= #
+    # === :maxerl
+    # ======================================================================= #
+    when :maxerl
+      _ = "#{IMG_DIR}MAXERL.png"
+    # ======================================================================= #
+    # === :message_box_error
+    # ======================================================================= #
+    when :message_box_error
+      _ = "#{IMG_DIR}MESSAGE_BOX_ERROR.png"
+    # ======================================================================= #
+    # === :message_box_info
+    # ======================================================================= #
+    when :message_box_info,
+         :info
+      _ = "#{IMG_DIR}MESSAGE_BOX_INFO.png"
+    # ======================================================================= #
+    # === :message_box_success
+    # ======================================================================= #
+    when :message_box_success
+      _ = "#{IMG_DIR}MESSAGE_BOX_SUCCESS.png"
+    # ======================================================================= #
+    # === :message_box_warning
+    # ======================================================================= #
+    when :message_box_warning
+      _ = "#{IMG_DIR}MESSAGE_BOX_WARNING.png"
+    # ======================================================================= #
+    # === :microsoft
+    # ======================================================================= #
+    when :microsoft
+      _ = "#{IMG_DIR}MICROSOFT.png"
+    # ======================================================================= #
+    # === :mine
+    # ======================================================================= #
+    when :mine
+      _ = "#{IMG_DIR}MINE.png"
+    # ======================================================================= #
+    # === :minibaum1
+    # ======================================================================= #
+    when :minibaum1,
+         :baum1,
+         :bonzai
+      _ = "#{IMG_DIR}MINI_BAUM1.png"
+    # ======================================================================= #
+    # === :minibaum2
+    # ======================================================================= #
+    when :minibaum2
+      _ = "#{IMG_DIR}MINI_BAUM2.png"
+    # ======================================================================= #
+    # === :minibaum3
+    # ======================================================================= #
+    when :minibaum3
+      _ = "#{IMG_DIR}MINI_BAUM3.png"
+    # ======================================================================= #
+    # === :minibaum4
+    # ======================================================================= #
+    when :minibaum4
+      _ = "#{IMG_DIR}MINI_BAUM4.png"
+    # ======================================================================= #
+    # === :minibaum5
+    # ======================================================================= #
+    when :minibaum5
+      _ = "#{IMG_DIR}MINI_BAUM5.png"
+    # ======================================================================= #
+    # === :minibaum6
+    # ======================================================================= #
+    when :minibaum6
+      _ = "#{IMG_DIR}MINI_BAUM6.png"
+    # ======================================================================= #
+    # === :minicube
+    # ======================================================================= #
+    when :minicube
+      _ = "#{IMG_DIR}MINI_CUBE.png"
+    # ======================================================================= #
+    # === :minidot
+    # ======================================================================= #
+    when :minidot
+      _ = "#{IMG_DIR}MINI_DOT.png"
+    # ======================================================================= #
+    # === :minus
+    # ======================================================================= #
+    when :minus
+      _ = "#{IMG_DIR}MINUS.png"
+    # ======================================================================= #
+    # === :money
+    # ======================================================================= #
+    when :money
+      _ = "#{IMG_DIR}MONEY.png"      
+    # ======================================================================= #
+    # === :morningstar
+    # ======================================================================= #
+    when :morningstar
+      _ = 'RPG/WEAPONS/SMALL_MORNING_STAR.png'
+    # ======================================================================= #
+    # === :mouse
+    # ======================================================================= #
+    when :mouse
+      _ = "#{IMG_DIR}MOUSE.png"
+    # ======================================================================= #
+    # === :musik_note
+    # ======================================================================= #
+    when :musik_note,
+         :musiknote
+      _ = "#{IMG_DIR}MUSIK_NOTE.png"
+    # ======================================================================= #
+    # === :nashorn
+    # ======================================================================= #
+    when :nashorn
+      _ = "#{IMG_DIR}NASHORN.png"
+    # ======================================================================= #
+    # === :news
+    # ======================================================================= #
+    when :news
+      _ = "#{IMG_DIR}NEWS.png"
+    # ======================================================================= #
+    # === :new
+    # ======================================================================= #
+    when :new
+      _ = "#{IMG_DIR}NEW.png"
+    # ======================================================================= #
+    # === ninja
+    # ======================================================================= #
+    when :ninja,
+         :ninja_image
+      _ = "#{IMG_DIR}/sneaky_ninja_face.png"
+    # ======================================================================= #
+    # === :note
+    # ======================================================================= #
+    when :note
+      _ = "#{IMG_DIR}NOTE.png"
+    # ======================================================================= #
+    # === :note_1
+    # ======================================================================= #
+    when :note_1,
+         :note1,
+         :noten_1,
+         :noten1,
+         :noten
+      _ = 'AUDIO/NOTEN_01.png'
+    # ======================================================================= #
+    # === :note_2
+    # ======================================================================= #
+    when :note_2, :note2, :noten_2, :noten2
+      _ = 'AUDIO/NOTEN_02.jpg'
+    # ======================================================================= #
+    # === :note_3
+    # ======================================================================= #
+    when :note_3, :note3, :noten_3, :noten3
+      _ = 'AUDIO/NOTEN_03.png'
+    # ======================================================================= #
+    # === :note_4
+    # ======================================================================= #
+    when :note_4, :note4, :noten_4, :noten4
+      _ = 'AUDIO/NOTEN_04.png'
+    # ======================================================================= #
+    # === :notepad
+    # ======================================================================= #
+    when :notepad,
+         :notizblock
+      _ = "#{IMG_DIR}NOTEPAD.png"
+    # ======================================================================= #
+    # === :notiz
+    # ======================================================================= #
+    when :notiz
+      _ = "#{IMG_DIR}NOTIZ.png"
+    # ======================================================================= #
+    # === :obsolete
+    # ======================================================================= #
+    when :obsolete
+      _ = "#{IMG_DIR}OBSOLETE.png"
+    # ======================================================================= #
+    # === :outdated
+    # ======================================================================= #
+    when :outdated
+      _ = "#{IMG_DIR}outdated.png"
+    # ======================================================================= #
+    # === :pdf
+    # ======================================================================= #
+    when :pdf
+      _ = "#{IMG_DIR}PDF.png"
+    # ======================================================================= #
+    # === :pfeil1
+    # ======================================================================= #
+    when :pfeil1, :kleiner_pfeil, :rechter_pfeil
+      _ = "#{IMG_DIR}PFEIL1.png"
+    # ======================================================================= #
+    # === :pfeil2
+    # ======================================================================= #
+    when :pfeil2
+      _ = "#{IMG_DIR}PFEIL2.png"
+    # ======================================================================= #
+    # === :pfeil3
+    # ======================================================================= #
+    when :pfeil3
+      _ = "#{IMG_DIR}PFEIL3.png"
+    # ======================================================================= #
+    # === :pfeil4
+    # ======================================================================= #
+    when :pfeil4
+      _ = "#{IMG_DIR}PFEIL4.png"
+    # ======================================================================= #
+    # === :pfeil5
+    # ======================================================================= #
+    when :pfeil5,
+         :pfeil
+      _ = "#{IMG_DIR}PFEIL5.png"
+    # ======================================================================= #
+    # === :pfeil6
+    #
+    # This is the "right arrow", that is an arrow that is pointing towards
+    # the right side.
+    # ======================================================================= #
+    when :pfeil6,
+         :arrow_right,
+         :right_arrow
+      _ = "#{IMG_DIR}PFEIL6.png"
+    # ======================================================================= #
+    # === :pfeil6_red
+    # ======================================================================= #
+    when :pfeil6_red,
+         :pfeil6red
+      _ = "#{IMG_DIR}PFEIL6_red.png"
+    # ======================================================================= #
+    # === :pfeil7
+    # ======================================================================= #
+    when :pfeil7
+      _ = "#{IMG_DIR}PFEIL7.png"
+    # ======================================================================= #
+    # === :pfeil8
+    # ======================================================================= #
+    when :pfeil8
+      _ = "#{IMG_DIR}PFEIL8_OUT.png"
+    # ======================================================================= #
+    # === :pfeil9
+    # ======================================================================= #
+    when :pfeil9
+      _ = "#{IMG_DIR}PFEIL9.png"
+    # ======================================================================= #
+    # === :pfeil10
+    # ======================================================================= #
+    when :pfeil10,
+         :pfeil_rechts,
+         :pfeilrechts
+      _ = "#{IMG_DIR}PFEIL10.png"
+    # ======================================================================= #
+    # === :pfeil11
+    # ======================================================================= #
+    when :pfeil11
+      _ = "#{IMG_DIR}PFEIL11.png"
+    # ======================================================================= #
+    # === :pfeil12
+    # ======================================================================= #
+    when :pfeil12,
+         :explanation
+      _ = "#{IMG_DIR}PFEIL12.png"
+    # ======================================================================= #
+    # === :pfeil_links_oben
+    # ======================================================================= #
+    when :pfeil_links_oben
+      _ = "#{IMG_DIR}PFEIL_LINKS_OBEN.png"
+    # ======================================================================= #
+    # === :left_right_pfeil
+    # ======================================================================= #
+    when :left_right_pfeil
+      _ = "#{IMG_DIR}LEFT_RIGHT_PFEIL.png"
+    # ======================================================================= #
+    # === :package
+    # ======================================================================= #
+    when :package
+      _ = "#{IMG_DIR}DOWNLOAD_PACKAGE.png"
+    # ======================================================================= #
+    # === :phone
+    # ======================================================================= #
+    when :phone
+      _ = "#{IMG_DIR}PHONE.png" # _ = 'STD/TELEFON.png'
+    # ======================================================================= #
+    # === :pin
+    # ======================================================================= #
+    when :pin
+      _ = "#{IMG_DIR}PIN.png"
+    # ======================================================================= #
+    # === :pin_pointer_red
+    # ======================================================================= #
+    when :pin_pointer_red
+      _ = "#{IMG_DIR}PIN_POINTER_RED.png"
+    # ======================================================================= #
+    # === :pipette
+    # ======================================================================= #
+    when :pipette
+      _ = "#{IMG_DIR}PIPETTE.png"
+    # ======================================================================= #
+    # === :plus
+    # ======================================================================= #
+    when :plus
+      _ = "#{IMG_DIR}PLUS.png"
+    # ======================================================================= #
+    # === :posaune
+    # ======================================================================= #
+    when :posaune
+      _ = "#{IMG_DIR}POSAUNE.png"
+    # ======================================================================= #
+    # === :protokoll
+    # ======================================================================= #
+    when :protokoll
+      _ = "#{IMG_DIR}PROTOKOLL.png"
+    # ======================================================================= #
+    # === :present
+    # ======================================================================= #
+    when :present
+      _ = "#{IMG_DIR}PRESENT.png"
+    # ======================================================================= #
+    # === :printer
+    # ======================================================================= #
+    when :printer
+      _ = "#{IMG_DIR}PRINTER.png"
+    # ======================================================================= #
+    # === :quote
+    # ======================================================================= #
+    when :quote
+      _ = "#{IMG_DIR}QUOTE.png"
+    # ======================================================================= #
+    # === :radioactive
+    # ======================================================================= #
+    when :radioactive
+      _ = "#{IMG_DIR}RADIO_ACTIVE.png"
+    # ======================================================================= #
+    # === :rainbow_circle
+    # ======================================================================= #
+    when :rainbow_circle,
+         :rainbow
+      _ = "#{IMG_DIR}RAINBOW_CIRCLE.png"
+    # ======================================================================= #
+    # === :rating1
+    # ======================================================================= #
+    when :rating1
+      _ = "#{IMG_DIR}BEWERTUNG_1.png"
+    # ======================================================================= #
+    # === :rating2
+    # ======================================================================= #
+    when :rating2
+      _ = "#{IMG_DIR}BEWERTUNG_2.png"
+    # ======================================================================= #
+    # === :rating3
+    # ======================================================================= #
+    when :rating3
+      _ = "#{IMG_DIR}BEWERTUNG_3.png"
+    # ======================================================================= #
+    # === :rating4
+    # ======================================================================= #
+    when :rating4
+      _ = "#{IMG_DIR}BEWERTUNG_4.png"
+    # ======================================================================= #
+    # === :rating5
+    # ======================================================================= #
+    when :rating5
+      _ = "#{IMG_DIR}BEWERTUNG_5.png"
+    # ======================================================================= #
+    # === :red_pill
+    # ======================================================================= #
+    when :red_pill
+      _ = "#{IMG_DIR}RED_PILL.png"
+    # ======================================================================= #
+    # === :rip
+    # ======================================================================= #
+    when :rip,
+         :tod
+      _ = "#{IMG_DIR}RIP.png"
+    # ======================================================================= #
+    # === :rocket
+    # ======================================================================= #
+    when :rocket
+      _ = "#{IMG_DIR}ROCKET.png"
+    # ======================================================================= #
+    # === :rose
+    # ======================================================================= #
+    when :rose
+      _ = "#{IMG_DIR}ROSE.png"
+    # ======================================================================= #
+    # === :rose2
+    # ======================================================================= #
+    when :rose2
+      _ = "#{IMG_DIR}ROSE2.png"
+    # ======================================================================= #
+    # === :ruby
+    # ======================================================================= #
+    when :ruby,
+         :ruby_diamond,
+         :bioruby_favicon
+      _ = 'programming/ruby/BIORUBY_FAVICON.png'
+    # ======================================================================= #
+    # === :running
+    # ======================================================================= #
+    when :running
+      _ = "#{IMG_DIR}RUNNING.png"
+    # ======================================================================= #
+    # === :save
+    # ======================================================================= #
+    when :save,
+         :string_save
+      _ = "#{IMG_DIR}SAVE.png"
+    # ======================================================================= #
+    # === :schneemann
+    # ======================================================================= #
+    when :schneemann,
+         :snowman
+      _ = "#{IMG_DIR}SCHNEEMANN.png"      
+    # ======================================================================= #
+    # === :scale
+    # ======================================================================= #
+    when :scale,
+         :waage
+      _ = 'RPG/STD/SCALE.png'
+    # ======================================================================= #
+    # === scanner
+    # ======================================================================= #
+    when :scanner
+      _ = "#{IMG_DIR}SCANNER.png"
+    # ======================================================================= #
+    # === :scissors
+    # ======================================================================= #
+    when :scissors,
+         :scissor,
+         :old_scissors
+      _ = "#{IMG_DIR}SCISSORS.png"
+    # ======================================================================= #
+    # === :schere
+    # ======================================================================= #
+    when :schere,
+         :schere2,
+         :new_scissors
+      _ = "#{IMG_DIR}SCHERE.png"
+    # ======================================================================= #
+    # === :shopping
+    # ======================================================================= #
+    when :shopping
+      _ = "#{IMG_DIR}SHOPPING.png"
+    # ======================================================================= #
+    # === :shield
+    # ======================================================================= #
+    when :shield,
+         :equip
+      _ = 'RPG/ARMOURS/SMALL_SHIELD.png'
+    # ======================================================================= #
+    # === :string_print
+    # ======================================================================= #
+    when :string_print,
+         :print
+      _ = "#{IMG_DIR}PRINT.png"
+    # ======================================================================= #
+    # === :six_sided_dice
+    # ======================================================================= #
+    when :six_sided_dice
+      _ = "#{IMG_DIR}/SIX_SIDED_DICE.png"
+    # ======================================================================= #
+    # === :simple_camera
+    # ======================================================================= #
+    when :simple_camera
+      _ = "#{IMG_DIR}/simple_camera.png"
+    # ======================================================================= #
+    # === :small_cat
+    # ======================================================================= #
+    when :small_cat
+      _ = "#{IMG_DIR}SMALL_CAT.png"
+    # ======================================================================= #
+    # === :small_document
+    # ======================================================================= #
+    when :small_document,
+         :small_docu,
+         :faltblatt
+      _ = "#{IMG_DIR}SMALL_DOCUMENT.png"
+    # ======================================================================= #
+    # === :small_house
+    # ======================================================================= #
+    when :small_house
+      _ = "#{IMG_DIR}SMALL_HOUSE.png"
+    # ======================================================================= #
+    # === :small_katana
+    # ======================================================================= #
+    when :small_katana, :small_sword
+      _ = 'RPG/WEAPONS/small_katana.jpg'
+    # ======================================================================= #
+    # === :snail
+    # ======================================================================= #
+    when :snail
+      _ = "#{IMG_DIR}SNAIL.png"
+    # ======================================================================= #
+    # === :skull
+    # ======================================================================= #
+    when :skull
+      _ = "#{IMG_DIR}SKULL.png"
+    # ======================================================================= #
+    # === :small_plane
+    # ======================================================================= #
+    when :small_plane
+      _ = "#{IMG_DIR}SMALL_PLANE.png"
+    # ======================================================================= #
+    # === :smiley1
+    # ======================================================================= #
+    when :smiley1,
+         :smiley
+      _ = "#{IMG_DIR}SMILEY1.png"
+    # ======================================================================= #
+    # === :smiley2
+    # ======================================================================= #
+    when :smiley2
+      _ = "#{IMG_DIR}SMILEY2.png"
+    # ======================================================================= #
+    # === :smiley3
+    # ======================================================================= #
+    when :smiley3,
+         :unhappy_smiley
+      _ = "#{IMG_DIR}SMILEY3.png"
+    # ======================================================================= #
+    # === :smiley4
+    # ======================================================================= #
+    when :smiley4
+      _ = "#{IMG_DIR}SMILEY4.png"
+    # ======================================================================= #
+    # === :smiley5
+    # ======================================================================= #
+    when :smiley5
+      _ = "#{IMG_DIR}SMILEY5.png"
+    # ======================================================================= #
+    # === :snowflake
+    # ======================================================================= #
+    when :snowflake
+      _ = "#{IMG_DIR}SNOWFLAKE.png"
+    # ======================================================================= #
+    # === :spacer
+    # ======================================================================= #
+    when :spacer
+      _ = "#{IMG_DIR}SPACER.png"
+    # ======================================================================= #
+    # === :spoon
+    # ======================================================================= #
+    when :spoon
+      _ = "#{IMG_DIR}SPOON.png"
+    # ======================================================================= #
+    # === :square_black
+    # ======================================================================= #
+    when :square_black, :black_square, :black
+      _ = "#{IMG_DIR}SQUARE_BLACK.png"
+    # ======================================================================= #
+    # === :square_blue
+    # ======================================================================= #
+    when :square_blue,
+         :blue_square,
+         :blue
+      _ = "#{IMG_DIR}SQUARE_BLUE.png"
+    # ======================================================================= #
+    # === :square_cadetblue
+    # ======================================================================= #
+    when :square_cadetblue,
+         :cadetblue_square,
+         :cadetblue
+      _ = "#{IMG_DIR}SQUARE_CADETBLUE.png"
+    # ======================================================================= #
+    # === :square_chaos
+    # ======================================================================= #
+    when :square_chaos,
+         :chaos_square, :chaos, :chaos_dot,
+         :teal
+      _ = "#{IMG_DIR}SQUARE_CHAOS.png"
+    when :square_darkgoldenrod, :darkgoldenrod_square
+      _ = "#{IMG_DIR}SQUARE_DARKGOLDENROD.png"
+    # ======================================================================= #
+    # === :square_green
+    # ======================================================================= #
+    when :square_green,
+         :green_square,
+         :green,
+         :green_dot
+      _ = "#{IMG_DIR}SQUARE_GREEN.png"
+    # ======================================================================= #
+    # === :square_grey
+    # ======================================================================= #
+    when :square_grey,
+         :grey_square,
+         :grey
+      _ = "#{IMG_DIR}SQUARE_GREY.png"
+    # ======================================================================= #
+    # === :square_red
+    # ======================================================================= #
+    when :square_red, :red_square, :red, :red_dot
+      _ = "#{IMG_DIR}SQUARE_RED.png"
+    # ======================================================================= #
+    # === :square_violet
+    # ======================================================================= #
+    when :square_violet, :violet_square, :violet
+      _ = "#{IMG_DIR}SQUARE_VIOLET.png"
+    # ======================================================================= #
+    # === :square_yel
+    # ======================================================================= #
+    when :square_yel,
+         :yel_square,
+         :yellow_dot,
+         :square_yellow, 
+         :yellow,
+         :yel_dot,
+         :yel,
+         :ydot,
+         :yellow_square
+      _ = "#{IMG_DIR}SQUARE_YEL.png"
+    # ======================================================================= #
+    # === :square_white
+    # ======================================================================= #
+    when :square_white,
+         :white
+      _ = "#{IMG_DIR}SQUARE_WHITE.png"
+    # ======================================================================= #
+    # === :standard
+    # ======================================================================= #
+    when :standard
+      _ = "#{IMG_DIR}STANDARDS_FAVICON.png"
+    # ======================================================================= #
+    # === :staff
+    # ======================================================================= #
+    when :staff
+      _ = 'RPG/WEAPONS/SMALL_GNARLEDSTAFF.jpg'
+    # ======================================================================= #
+    # === :star
+    # ======================================================================= #
+    when :star
+      _ = "#{IMG_DIR}STAR.png"
+    # ======================================================================= #
+    # === :star_fancy
+    # ======================================================================= #
+    when :star_fancy
+      _ = "#{IMG_DIR}STAR_FANCY.png"
+    # ======================================================================= #
+    # === :sword
+    # ======================================================================= #
+    when :sword
+      _ = 'RPG/WEAPONS/SWORD03.png'
+    # ======================================================================= #
+    # === :in_progress
+    # ======================================================================= #
+    when :in_progress
+      _ = "#{IMG_DIR}STATUS_IN_PROGRESS.png"
+    # ======================================================================= #
+    # === :one_star
+    # ======================================================================= #
+    when :one_star
+      _ = "#{IMG_DIR}EVAL/01_STAR.png"
+    # ======================================================================= #
+    # === :one_and_half_star
+    # ======================================================================= #
+    when :one_and_half_star
+      _ = "#{IMG_DIR}EVAL/1x_STAR.png"
+    # ======================================================================= #
+    # === :two_star
+    # ======================================================================= #
+    when :two_star, :two_stars
+      _ = "#{IMG_DIR}EVAL/02_STAR.png"
+    # ======================================================================= #
+    # === :two_and_half_star
+    # ======================================================================= #
+    when :two_and_half_star
+      _ = "#{IMG_DIR}EVAL/2x_STAR.png"
+    # ======================================================================= #
+    # === :three_star
+    # ======================================================================= #
+    when :three_star, :three_stars
+      _ = "#{IMG_DIR}EVAL/03_STAR.png"
+    # ======================================================================= #
+    # === :three_and_half_star
+    # ======================================================================= #
+    when :three_and_half_star
+      _ = "#{IMG_DIR}EVAL/3x_STAR.png"
+    # ======================================================================= #
+    # === :four_star
+    # ======================================================================= #
+    when :four_star, :four_stars
+      _ = "#{IMG_DIR}EVAL/04_STAR.png"
+    # ======================================================================= #
+    # === :four_and_half_star
+    # ======================================================================= #
+    when :four_and_half_star
+      _ = "#{IMG_DIR}EVAL/4x_STAR.png"
+    # ======================================================================= #
+    # === :five_star
+    # ======================================================================= #
+    when :five_star, 
+         :five_stars
+      _ = "#{IMG_DIR}EVAL/05_STAR.png"
+    when :spiderman_head,
+         :pilothead
+      _ = "#{IMG_DIR}SPIDERMAN_HEAD.png"
+    when :sun
+      _ = "#{IMG_DIR}SUN.png"
+    when :sync
+      _ = "#{IMG_DIR}SYNC.png"
+    # ======================================================================= #
+    # === :tastatur
+    # ======================================================================= #
+    when :tastatur,
+         :keyboard
+      _ = "#{IMG_DIR}TASTATUR.png"
+    # ======================================================================= #
+    # === :teufelchen
+    # ======================================================================= #
+    when :teufelchen
+      _ = "#{IMG_DIR}TEUFELCHEN.png"
+    # ======================================================================= #
+    # === :thinking_human
+    # ======================================================================= #
+    when :thinking_human
+      _ = "#{IMG_DIR}THINKING_HUMAN.png"
+    # ======================================================================= #
+    # === :todo
+    # ======================================================================= #
+    when :todo
+      _ = "#{IMG_DIR}TODO.jpg"
+    # ======================================================================= #
+    # === :tools
+    # ======================================================================= #
+    when :tools
+      _ = "#{IMG_DIR}TOOLS.png"
+    # ======================================================================= #
+    # === :town
+    # ======================================================================= #
+    when :town
+      _ = 'games/SMALL_ICONS/TOWN.png'
+    # ======================================================================= #
+    # === :transport
+    # ======================================================================= #
+    when :transport
+      _ = "#{IMG_DIR}TRANSPORT.png"
+    # ======================================================================= #
+    # === :triangle
+    # ======================================================================= #
+    when :triangle
+      _ = "#{IMG_DIR}TRIANGLE.png"
+    # ======================================================================= #
+    # === :text_editor
+    # ======================================================================= #
+    when :text_editor
+      _ = "#{IMG_DIR}text_editor.png"
+    # ======================================================================= #
+    # === :turm
+    # ======================================================================= #
+    when :turm   
+      _ = "#{IMG_DIR}TURM.png"
+    # ======================================================================= #
+    # === :twirl
+    # ======================================================================= #
+    when :twirl   
+      _ = "#{IMG_DIR}TECHNICOLOR_TWIRL.png"
+    # ======================================================================= #
+    # === :uhr
+    # ======================================================================= #
+    when :uhr
+      _ = "#{IMG_DIR}UHR.png"
+    # ======================================================================= #
+    # === :upload2
+    # ======================================================================= #
+    when :upload2
+      _ = "#{IMG_DIR}UPLOAD2.png"
+    # ======================================================================= #
+    # === :usb
+    # ======================================================================= #
+    when :usb
+      _ = "#{IMG_DIR}USB_CONNECTION_DEVICE.png"
+    # ======================================================================= #
+    # === :videocamera
+    # ======================================================================= #
+    when :videocamera,
+         :camera2
+      _ = "#{IMG_DIR}VIDEOCAMERA.png"
+    # ======================================================================= #
+    # === :vogel
+    # ======================================================================= #
+    when :vogel,
+         :bird
+      _ = "#{IMG_DIR}VOGEL.png"
+    # ======================================================================= #
+    # === :warnschild
+    # ======================================================================= #
+    when :warnschild
+      _ = "#{IMG_DIR}WARNSCHILD.png"
+    # ======================================================================= #
+    # === :webserver
+    # ======================================================================= #
+    when :webserver
+      _ = "#{IMG_DIR}WEBSERVER.png"
+    # ======================================================================= #
+    # === :windows_key
+    # ======================================================================= #
+    when :windows_key
+      _ = "#{IMG_DIR}windows_key.png"
+    # ======================================================================= #
+    # === :wings
+    # ======================================================================= #
+    when :wings
+      _ = "#{IMG_DIR}WINGS.png"
+    # ======================================================================= #
+    # === :word
+    # ======================================================================= #
+    when :word
+      _ = "#{IMG_DIR}WORD.png"
+    # ======================================================================= #
+    # === :woman
+    # ======================================================================= #
+    when :woman
+      _ = "#{IMG_DIR}SYMBOL_FRAU.png"
+    # ======================================================================= #
+    # === :wurzel
+    # ======================================================================= #
+    when :wurzel
+      _ = "#{IMG_DIR}WURZEL_ZEICHEN.png"
+    # ======================================================================= #
+    # === :yin_yang
+    # ======================================================================= #
+    when :yin_yang,
+         :yinyang
+      _ = "#{IMG_DIR}YIN_YANG.png"
+    # ======================================================================= #
+    # === :zauberhut
+    # ======================================================================= #
+    when :zauberhut
+      _ = "#{IMG_DIR}ZAUBERHUT.png"
+    # ======================================================================= #
+    # === :zahnrad
+    # ======================================================================= #
+    when :zahnrad
+      _ = "#{IMG_DIR}ZAHNRAD.png"
+    # ======================================================================= #
+    # === :zitrone
+    # ======================================================================= #
+    when :zitrone
+      _ = "#{IMG_DIR}ZITRONE.png"
+    # ======================================================================= #
+    # === :zoom
+    # ======================================================================= #
+    when :zoom
+      _ = "#{IMG_DIR}zoom.png"
+    else # no easypassthru 
+        # ee url.class+' '+url
+    end # bl $PC/YAML/default_web_images.yml
+    _ = _.to_s
+    # ======================================================================= #
+    # === Handle blocks next
+    #
+    # Next, we handle (and thus allow) block parameters.
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :prepend_the_image_base_directory
+      # ===================================================================== #
+      when :prepend_the_image_base_directory
+        _ = _.dup if _.frozen?
+        _.prepend(Cyberweb.roebe_image_dir?)
+      # ===================================================================== #
+      # === :do_expand
+      #
+      # This entry point will prepend the IMG_DIR forcefully. Use this
+      # with care, as it may not always be what you want to have.
+      # ===================================================================== #
+      when :do_expand,
+           :prepend_img_dir # Prepend the image dir then.
+        _ = _.dup if _.frozen?
+        _.prepend(IMG_DIR)
+      end
+    end
+    return _
+  end; self.instance_eval { alias string?        map_symbol_to_image_location } # === Cyberweb::WebImages.string?
+       self.instance_eval { alias string         map_symbol_to_image_location } # === Cyberweb::WebImages.string
+       self.instance_eval { alias result?        map_symbol_to_image_location } # === Cyberweb::WebImages.result?
+       self.instance_eval { alias result         map_symbol_to_image_location } # === Cyberweb::WebImages.result
+       self.instance_eval { alias obtain         map_symbol_to_image_location } # === Cyberweb::WebImages.obtain
+       self.instance_eval { alias get_proper_url map_symbol_to_image_location } # === Cyberweb::WebImages.get_proper_url
+       self.instance_eval { alias mapper         map_symbol_to_image_location } # === Cyberweb::WebImages.mapper
+       self.instance_eval { alias []             map_symbol_to_image_location } # === Cyberweb::WebImages[]
+
+  # ========================================================================= #
+  # === Cyberweb::WebImages.random
+  # ========================================================================= #
+  def self.random # Obtain a random image here.
+    return map_symbol_to_image_location(:random)
+  end
+
+  # ========================================================================= #
+  # === Cyberweb::WebImages.is_included?
+  #
+  # Whether a given image is included or whether it is not.
+  #
+  # Invocation example:
+  #
+  #   Cyberweb::WebImages.is_included?(:admin) # => true
+  #
+  # ========================================================================= #
+  def self.is_included?(i)
+    # ======================================================================= #
+    # If the input is the same as the output, then we can not
+    # possibly have included it.
+    # ======================================================================= #
+    ! (i == get_proper_url(i))
+  end; self.instance_eval { alias does_include?            is_included? } # === Cyberweb::WebImages.does_include?
+       self.instance_eval { alias webimages_is_included?   is_included? } # === Cyberweb::WebImages.webimages_is_included?
+       self.instance_eval { alias web_images_does_include? is_included? } # === Cyberweb::WebImages.web_images_does_include?
+
+end
+
+# =========================================================================== #
+# === Cyberweb.use_webimages?
+#
+# Whether we will use webimages or not.
+# =========================================================================== #
+def self.use_webimages?
+  ::Cyberweb.config?['use_webimages']
+end
+
+# =========================================================================== #
+# === Cyberweb.get_webimage
+#
+# This method will return the (assumed) path to a registered web-image.
+#
+# You may still have to prepend the absolute path towards your own
+# localhost.
+#
+# Usage example:
+#
+#   Cyberweb.webimage_for :hanging_monkey # => "STD/HANGING_MONKEY.png"
+#
+# =========================================================================== #
+def self.get_webimage(
+    i = :yellow, &block
+  )
+  result = ::Cyberweb::WebImages.map_symbol_to_image_location(i, &block).to_s # bl $WEB_IMAGES/web_images.rb
+  return result.to_s.dup
+end; self.instance_eval { alias return_webimage           get_webimage } # === Cyberweb.return_webimage
+     self.instance_eval { alias webimage_for              get_webimage } # === Cyberweb.webimage_for
+     self.instance_eval { alias obtain                    get_webimage } # === Cyberweb.obtain
+     self.instance_eval { alias return_this_default_image get_webimage } # === Cyberweb.return_this_default_image
+     self.instance_eval { alias return_this_webimage      get_webimage } # === Cyberweb.return_this_webimage
+     self.instance_eval { alias web_images                get_webimage } # === Cyberweb.web_images
+     self.instance_eval { alias image_url                 get_webimage } # === Cyberweb.image_url
+
+# =========================================================================== #
+# === get_webimage                 (case tag, menu tag, img tag, image tag)
+#
+# This method will convert keyword symbols to the proper URL.
+#
+# In order to do so, it will simply pass the input towards
+# class WebImages.
+#
+# Every :symbol that starts with :string_ means that this is a graphical
+# representation of a string (written tex in each entry, is the "default"
+# one which we will also maintain in our array:
+#
+#   ARRAY_LISTING_ALL_PROJECT_IMAGES
+#
+# Specific usage examples for outside use:
+#
+#   Cyberweb.get_webimage :yellow
+#   Cyberweb.get_webimage :rip
+#   monkey = ENV['MY_IMG'].to_s+'/'+Cyberweb.get_webimage(:monkey)
+#
+# =========================================================================== #
+def get_webimage(
+    url = :yellow
+  )
+  Cyberweb.get_webimage(url)
+end
+
+# =========================================================================== #
+# === Cyberweb.get_proper_url
+# =========================================================================== #
+def self.get_proper_url(i, &block)
+  Cyberweb::WebImages.get_proper_url(i, &block)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e Cyberweb::WebImages.map_symbol_to_image_location(ARGV)
+  e Cyberweb.get_webimage(:big_star) # -> /home/Programs/Ruby/2.7.1/lib/ruby/site_ruby/2.7.0/web_object/images/real/BIG_STAR.png
+  e Cyberweb::WebImages.is_included?(:admin) # => true
+  e Cyberweb::WebImages[:austria]
+  e Cyberweb::WebImages.random
+  e Cyberweb::WebImages.mapper(:phone)
+  e Cyberweb::WebImages.mapper(:phone) { :prepend_the_image_base_directory }
+end