cyberweb 0.7.9 → 0.8.17

data/lib/cyberweb/web_object/misc.rb

@@ -10,29 +10,375 @@ module Cyberweb
 
 class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
 
+  require 'cyberweb/web_object/effects.rb'
   require 'cyberweb/javascript/javascript_helper/javascript_helper.rb'
   require 'cyberweb/modules/css_style.rb'
   require 'cyberweb/utility_scripts/obtain_css_rules.rb'
+  require 'cyberweb/toplevel_methods/listing.rb'
+  require 'cyberweb/web_images/map_symbol_to_image_location.rb'
 
   begin
     require 'roebe/classes/to_binary.rb'
   rescue LoadError; end
 
   # ========================================================================= #
-  # === Cyberweb::WebObject.evaluate_from_the_same_named_file_then_serve
+  # === sanitize_this_id
   #
-  # This is the simplified variant that can be used for .cgi files, if
-  # a nearby .rb file exists. In order for this to work, the file must
-  # have the same name, minus the extension (which can be different).
+  # This method can be used to sanitize the given input, for further use
+  # as a HTML id. A few assumptions will be made for input that is
+  # passed to this method; but, even aside from these assumptions, the
+  # most important point for this method is that it can be consistently
+  # used/re-used.
   # ========================================================================= #
-  def self.evaluate_from_the_same_named_file_then_serve(
-      output_the_result              = :default,
-      optional_use_this_name_instead = nil
+  def sanitize_this_id(i)
+    return ::Cyberweb.sanitize_this_id(i)
+  end
+
+  # ========================================================================= #
+  # === dot109?
+  #
+  # This simply wraps over dot() with a default value and default CSS.
+  # ========================================================================= #
+  def dot109?
+    string_dot(109, 'marr10px')
+  end
+
+  # ========================================================================= #
+  # === clickable_image_as_string?
+  # ========================================================================= #
+  def clickable_image_as_string?
+    _ = clickable_image?
+    # ======================================================================= #
+    # === Handle Symbols next
+    #
+    # Symbols have to be expanded towards their local path.
+    # ======================================================================= #
+    if _.is_a? Symbol
+      _ = map_symbol_to_image_location(_) # Now we have the real path.
+      _.prepend(prepend_path_to_the_images?.dup)
+      _ = '<img src="'+_+'" class="marr10px">'
+    end
+    return _.to_s # Must guarantee that it is a String.
+  end
+
+  # ========================================================================= #
+  # === clickable_image?
+  #
+  # This must stay a simpler getter - no sanitizing is allowed.
+  # ========================================================================= #
+  def clickable_image?
+    @internal_hash[:clickable_image]
+  end
+
+  # ========================================================================= #
+  # === map_symbol_to_image_location
+  # ========================================================================= #
+  def map_symbol_to_image_location(i)
+    return ::Cyberweb::WebImages.map_symbol_to_image_location(i)
+  end
+
+  # ========================================================================= #
+  # === set_clickable_image
+  # ========================================================================= #
+  def set_clickable_image(i)
+    @internal_hash[:clickable_image] = i
+  end
+
+  require 'cyberweb/toplevel_methods/dot.rb'
+  # ========================================================================= #
+  # === string_dot
+  #
+  # This variant will return a String. The regular dot() method on the
+  # other hand will append that String onto the resulting webpage
+  # content, as-is.
+  # ========================================================================= #
+  def string_dot(
+      i                  = 108,
+      optional_css_class = '',
+      optional_the_id    = '',
+      optional_css_style = ''
+    )
+    _ = sg(
+      "dot#{i}".to_sym,
+      optional_css_class,
+      optional_the_id,
+      optional_css_style
+    )
+    return _
+  end; alias dot string_dot # === dot (dot tag)
+
+  # ========================================================================= #
+  # === h1_id_clickable
+  # ========================================================================= #
+  def h1_id_clickable(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    h1_id(i, optional_css_class) { :clickable_image }
+  end; alias h1_fancy_id h1_id_clickable # === h1_fancy_id
+
+  # ========================================================================= #
+  # === h1_id
+  # ========================================================================= #
+  def h1_id(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    use_this_id = i.to_s.dup.downcase.tr(' ','_').delete(':(),').
+                  tr('-','_').squeeze('_')
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :clickable_image
+      # ===================================================================== #
+      when :clickable_image
+        i = "<a href=\"##{use_this_id}\">"+
+            clickable_image_as_string?+
+            "</a>#{i}"
+      end
+    end
+    h1 i, id: use_this_id
+  end
+
+  # ========================================================================= #
+  # === h2_id_clickable
+  # ========================================================================= #
+  def h2_id_clickable(
+      i,
+      optional_css_class = '',
+      optional_id        = nil,
+      &block
+    )
+    h2_id(i, optional_css_class, optional_id) { :clickable_image }
+  end; alias h2_fancy_id h2_id_clickable # === h2_fancy_id
+
+  # ========================================================================= #
+  # === h2_id
+  #
+  # This must be somewhat flexible, to allow for use cases such as:
+  #
+  #   h2_id('Stickstofffixierung - eine symbiotische Beziehung, als '\
+  #         'Teil des Stickstoffkreislaufs') { :clickable_image }
+  #
+  # ========================================================================= #
+  def h2_id(
+      i,
+      optional_css_class = '',
+      optional_id        = nil,
+      &block
+    )
+    if optional_id and !optional_id.empty?
+      use_this_id = sanitize_this_id(optional_id)
+    else
+      use_this_id = sanitize_this_id(i)
+    end
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :clickable_image
+      # ===================================================================== #
+      when :clickable_image
+        i = "<a href=\"##{use_this_id}\">"+
+            clickable_image_as_string?+
+            "</a>#{i}"
+      end
+    end
+    h2 i, id: use_this_id, css_class: optional_css_class
+  end
+
+  # ========================================================================= #
+  # === h3_id_clickable
+  # ========================================================================= #
+  def h3_id_clickable(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    h3_id(i, optional_css_class) { :clickable_image }
+  end; alias h3_fancy_id h3_id_clickable # === h3_fancy_id
+
+  # ========================================================================= #
+  # === h3_id
+  # ========================================================================= #
+  def h3_id(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    use_this_id = sanitize_this_id(i)
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :clickable_image
+      # ===================================================================== #
+      when :clickable_image
+        i = "<a href=\"##{use_this_id}\">"+
+            dot109?+
+            "</a>#{i}"
+      end
+    end
+    h3 i, id: use_this_id
+  end
+
+  # ========================================================================= #
+  # === h4_id_clickable
+  # ========================================================================= #
+  def h4_id_clickable(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    h4_id(i, optional_css_class) { :clickable_image }
+  end; alias h4_fancy_id h4_id_clickable # === h4_fancy_id
+
+  # ========================================================================= #
+  # === h4_id
+  # ========================================================================= #
+  def h4_id(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    use_this_id = sanitize_this_id(i)
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :clickable_image
+      # ===================================================================== #
+      when :clickable_image
+        i = "<a href=\"##{use_this_id}\">"+
+            dot109?+
+            "</a>#{i}"
+      end
+    end
+    h4 i, id: use_this_id
+  end
+
+  # ========================================================================= #
+  # === h5_id_clickable
+  # ========================================================================= #
+  def h5_id_clickable(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    h5_id(i, optional_css_class) { :clickable_image }
+  end; alias h5_fancy_id h5_id_clickable # === h5_fancy_id
+
+  # ========================================================================= #
+  # === h5_id
+  # ========================================================================= #
+  def h5_id(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    use_this_id = sanitize_this_id(i)
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :clickable_image
+      # ===================================================================== #
+      when :clickable_image
+        i = "<a href=\"##{use_this_id}\">"+
+            dot109?+
+            "</a>#{i}"
+      end
+    end
+    h5 i, id: use_this_id
+  end
+
+  # ========================================================================= #
+  # === h6_id_clickable
+  # ========================================================================= #
+  def h6_id_clickable(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    h6_id(i, optional_css_class) { :clickable_image }
+  end; alias h6_fancy_id h6_id_clickable # === h6_fancy_id
+
+  # ========================================================================= #
+  # === h6_id
+  # ========================================================================= #
+  def h6_id(
+      i,
+      optional_css_class = '',
+      &block
+    )
+    use_this_id = sanitize_this_id(i)
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :clickable_image
+      # ===================================================================== #
+      when :clickable_image
+        i = "<a href=\"##{use_this_id}\">"+
+            dot109?+
+            "</a>#{i}"
+      end
+    end
+    h6 i, id: use_this_id
+  end
+
+  # ========================================================================= #
+  # === p_default
+  #
+  # This is similar to p(), but the implicit CSS class 'default' will be
+  # used.
+  # ========================================================================= #
+  def p_default(
+      optional_css_class = '',
+      the_id             = '',
+      optional_css_style = '',
+      &block
+    )
+    if optional_css_class.is_a? Hash
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if optional_css_class.has_key? :id
+        the_id = optional_css_class.delete(:id)
+      end
+      if optional_css_class.is_a?(Hash) and optional_css_class.empty?
+        optional_css_class = ''
+      end
+    end
+    optional_css_class = optional_css_class.to_s.dup
+    optional_css_class.prepend('default ') # Make it the first argument.
+    p(
+      optional_css_class.strip,
+      the_id,
+      optional_css_style,
+      &block
     )
-    _ = Cyberweb::WebObject.new
-    ::Cyberweb.set_web_object(_)
-    _.evaluate_from_the_same_named_file(optional_use_this_name_instead)
-    return _.do_serve(output_the_result)
   end
 
   # ========================================================================= #
@@ -44,10 +390,11 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
   # The first argument to this method can be additional entries that
   # the user may want to display.
   #
-  # Usage examples:
+  # Different usage examples follow next:
   #
   #   science_hyperlinks
   #   science_hyperlinks { :use_unicode_right_arrows }
+  #   science_links {{ use_this_image: LINK_IMAGE }}
   #
   # ========================================================================= #
   def science_hyperlinks(
@@ -76,8 +423,27 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
       short_name = File.basename(this_local_link).delete_suffix('.cgi').dup.
                    tr('_',' ').
                    sub(/local/,'')
-      if yielded == :use_unicode_right_arrows
-        short_name.prepend('→')
+      if yielded.is_a? Hash
+        # =================================================================== #
+        # === :use_this_image
+        # =================================================================== #
+        if yielded.has_key?(:use_this_image)
+          use_this_image = yielded[:use_this_image]
+          short_name = "#{use_this_image}#{short_name.strip}"
+        end
+      else
+        case yielded
+        # =================================================================== #
+        # === pretty_image
+        # =================================================================== #
+        when :pretty_image
+          short_name.prepend(dot109?)
+        # =================================================================== #
+        # === :use_unicode_right_arrows
+        # =================================================================== #
+        when :use_unicode_right_arrows
+          short_name.prepend('→')
+        end
       end
       abr_self(
         this_local_link,
@@ -87,6 +453,642 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
   end; alias add_science_links science_hyperlinks # === add_science_links
        alias science_links     science_hyperlinks # === science_links
 
+  # ========================================================================= #
+  # === listing_css_object
+  # ========================================================================= #
+  def listing_css_object
+    ::Cyberweb.listing_css_object
+  end
+
+  # ========================================================================= #
+  # === counter_li
+  #
+  # This method was added in June 2021.
+  # ========================================================================= #
+  def counter_li(
+      i                  = '',
+      optional_css_class = ''
+    )
+    @internal_hash[:listing_counter] += 1
+    e '('+@internal_hash[:listing_counter].to_s+') '+
+      i.to_s,
+      optional_css_class
+  end; alias listing counter_li # === listing
+       alias counter counter_li # === counter
+
+  # ========================================================================= #
+  # === listing_css
+  # ========================================================================= #
+  def listing_css(i)
+    ::Cyberweb.listing_css_object = i
+  end
+
+  # ========================================================================= #
+  # === listing_counter?
+  # ========================================================================= #
+  def listing_counter?
+    @internal_hash[:listing_counter]
+  end; alias listing_counter listing_counter? # === listing_counter
+
+  # ========================================================================= #
+  # === listing_counter=
+  # ========================================================================= #
+  def listing_counter=(i)
+    @internal_hash[:listing_counter] = i
+  end
+
+  # ========================================================================= #
+  # === cmd3
+  # ========================================================================= #
+  def cmd3(
+      i                  = '',
+      optional_css_class = ::Cyberweb.command3?
+    )
+    e(i, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === l2emb
+  # ========================================================================= #
+  def l2emb(
+      i                  = '',
+      optional_css_class = ''
+    )
+    l2(i, optional_css_class)
+    br
+  end; alias l2br      l2emb # === l2br
+       alias l2embr    l2emb # === l2embr
+       alias lem2      l2emb # === lem2
+       alias lembre2   l2emb # === lembre2
+       alias padl2embr l2emb # === padl2embr
+       alias le2       l2emb # === le2
+       alias lem2br    l2emb # === lem2br
+
+  # ========================================================================= #
+  # === l2
+  # ========================================================================= #
+  def l2(
+      i                  = '',
+      optional_css_class = '',
+      optional_the_id    = ''
+    )
+    if optional_css_class.is_a? Hash
+      # ======================================================================= #
+      # === :id
+      # ======================================================================= #
+      if optional_css_class.has_key? :id
+        optional_the_id = optional_css_class.delete(:id)
+      end
+    end
+    if optional_css_class.frozen?
+      optional_css_class = optional_css_class.dup
+    end
+    unless optional_css_class.include? 'padl2em'
+      optional_css_class << ' padl2em'
+    end 
+    s2(i, optional_css_class.strip, optional_the_id)
+  end; alias l2em    l2 # === l2em
+       alias padl2em l2 # === padl2em
+
+  # ========================================================================= #
+  # === string_link
+  #
+  # This method essentially creates a String representation of the HTML
+  # <a> tag.
+  #
+  # Since as of April 2022 the method "slink" is now an alias to string_link;
+  # it used to be an alias towards "def a()", but this was changed - the
+  # word string_link more logically may refer to slink as its intrinsic
+  # abbreviation.
+  # ========================================================================= #
+  def string_link(
+      i           = '',
+      option_hash = {},
+      &block
+    )
+    # ======================================================================= #
+    # === Handle blocks given to this method next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :pretty
+      # ===================================================================== #
+      when :pretty
+        option_hash[:remote_URL] = beautiful_url(i)
+      end
+    end
+    if i.is_a?(Symbol)
+      if i.start_with?('local_')
+        i = BeautifulUrl.local_menu(i)
+      else
+        i = beautiful_url(i)
+        # =================================================================== #
+        # Also check if the second argument is a String. In this case we
+        # must modify it. Example for input that fulfils this criterium:
+        #
+        #   remote_link(:hydrogenase, 'Hydrogenase')+
+        #
+        # =================================================================== #
+        if option_hash.is_a? String
+          option_hash = { content: option_hash }
+        end
+      end
+    end
+    # ======================================================================= #
+    # === Handle local entries for the "/home/x" directory layout.
+    # ======================================================================= #
+    if i.start_with? '/home/x'
+      i = i.dup
+      i.sub!(/\/home\/x\//, relative_path?)
+    end
+    i = rds(i.to_s.dup)
+    # ======================================================================= #
+    # Delegate onto HtmlTags.a().
+    # ======================================================================= #
+    return HtmlTags.a(
+      i,
+      option_hash
+    )
+  end; alias string_a           string_link # === string_a
+       alias string_href        string_link # === string_href
+       alias string_remote_link string_link # === string_remote_link
+       alias slink              string_link # === slink
+
+  # ========================================================================= #
+  # === return_progress
+  # ========================================================================= #
+  def return_progress(
+      n_percent,
+      &block
+    )
+    return ::Cyberweb::Objectified::HtmlTags::Progress.new(n_percent, &block)
+  end
+
+  # ========================================================================= #
+  # === less_than_or_equal
+  # ========================================================================= #
+  def less_than_or_equal
+    '≤'
+  end; alias kleiner_gleich less_than_or_equal # === kleiner_gleich
+
+  # ========================================================================= #
+  # === oop_progress
+  #
+  # The progress element represents the completion progress of a task. The
+  # method here will simply delegate towards the corresponding objectified
+  # HTML tag.
+  #
+  # Usage example:
+  #
+  #   progress(35)
+  #
+  # ========================================================================= #
+  def oop_progress(
+      n_percent,
+      &block
+    )
+    addnl(
+      return_progress(n_percent, &block).to_s
+    )
+  end; alias progress oop_progress # === progress
+
+  # ========================================================================= #
+  # === l1                                                           (l1 tag)
+  #
+  # The second argument to this method may sometimes be a Hash, such as:
+  #
+  #   'foobar', id: 'mini-car'
+  #
+  # ========================================================================= #
+  def l1(
+      i                  = '',
+      optional_css_class = '',
+      optional_the_id    = ''
+    )
+    if optional_css_class.is_a? Hash
+      # ======================================================================= #
+      # === :id
+      # ======================================================================= #
+      if optional_css_class.has_key? :id
+        optional_the_id = optional_css_class.delete(:id)
+      end
+      if optional_css_class.is_a?(Hash) and optional_css_class.empty?
+        optional_css_class = optional_css_class.to_s
+      end
+    end
+    optional_css_class = optional_css_class.dup
+    optional_css_class << ' padl1em' # Add the padl1em CSS class here.
+    s2(
+      i, optional_css_class.strip, optional_the_id
+    )
+  end; alias l1em    l1 # === l1em
+       alias l1m     l1 # === l1m
+       alias lem1    l1 # === lem1
+       alias padlem  l1 # === padlem
+       alias padl1em l1 # === padl1em
+
+  # ========================================================================= #
+  # === lembre
+  # ========================================================================= #
+  def lembre(
+      i                  = '',
+      optional_css_class = '',
+      optional_the_id    = ''
+    )
+    l1(
+      i,
+      optional_css_class,
+      optional_the_id
+    )
+    br
+  end; alias lem1br    lembre # === lembre
+       alias lem       lembre # === lem
+       alias lemspan   lembre # === lemspan
+       alias lee       lembre # === lee
+       alias lembr     lembre # === lembr
+       alias padl1embr lembre # === padl1embr
+       alias le        lembre # === le
+
+  # ========================================================================= #
+  # === obtain_the_parameters_passed
+  #
+  # This query-method will return which params have been passed into, for
+  # example, a .cgi page.parameters_as_string?
+  #
+  # Typical invocation may go like this:
+  #
+  #   w.obtain_the_parameters_passed
+  #
+  # ========================================================================= #
+  def obtain_the_parameters_passed
+    ::Cyberweb.params? # This is part of params.rb actually.
+  end; alias return_params_hash obtain_the_parameters_passed # === return_params_hash
+       alias web_params?        obtain_the_parameters_passed # === web_params?
+       alias web_params         obtain_the_parameters_passed # === web_params
+       alias params?            obtain_the_parameters_passed # === params?
+       alias params             obtain_the_parameters_passed # === params
+
+  # ========================================================================= #
+  # === params_as_string?
+  # ========================================================================= #
+  def params_as_string?
+    _ = ::Cyberweb.params?
+    if _.is_a? Hash
+      _ = _.keys.join
+    end
+    return _
+  end
+
+  # ========================================================================= #
+  # === first_param_as_string?
+  # ========================================================================= #
+  def first_param_as_string?
+    _ = ::Cyberweb.params?
+    if _.is_a? Hash
+      _ = _.keys.first
+    end
+    return _
+  end; alias first_param_as_string first_param_as_string? # === first_param_as_string
+
+  # ========================================================================= #
+  # === obtain_this_param_as_string
+  #
+  # This method must guarantee to return a String.
+  # ========================================================================= #
+  def obtain_this_param_as_string(i)
+    _ = params?[i]
+    _ = _.first if _.is_a? Array
+    return _.to_s # e. g. {"view"=>["/tmp"]}
+  end
+
+  # ========================================================================= #
+  # === do_copy_the_javascript_code_files_into_current_working_directory
+  #
+  # This method will copy the javascript code to a path such as
+  # "/home/x/Temp/cyberweb/javascript_code/custom_functions.js".
+  #
+  # Note that this refers to my home setup, so for other users this
+  # may be largely irrelevant.
+  # ========================================================================= #
+  def do_copy_the_javascript_code_files_into_current_working_directory
+    use_this_path = "#{Cyberweb.project_base_directory?}javascript_code/"
+    current_directory = return_pwd
+    # ======================================================================= #
+    # The next clause will only copy files - at a later time this may
+    # have to be changed to also copy directories, but for now (Oct 2022)
+    # this is the way to go.
+    #
+    # Since as of December 2022, the file will always be copied if the
+    # File.mtime() is more recent. That has been enabled specifically
+    # for my home system.
+    # ======================================================================= #
+    Dir["#{use_this_path}*"].select {|entry| File.file?(entry) }.each {|entry|
+      mtime_of_the_file_to_be_copied = File.mtime(entry)
+      location_for_the_new_file = current_directory+File.basename(entry)
+      mtime_location_for_the_new_file = File.mtime(location_for_the_new_file)
+      # ===================================================================== #
+      # target will be a String such as:
+      #
+      #   "/home/x/Temp/cyberweb/javascript_code/chmod_displayer.js"
+      #
+      # ===================================================================== #
+      if File.exist?(location_for_the_new_file)
+        if mtime_of_the_file_to_be_copied > mtime_location_for_the_new_file
+          copy_this_file(entry, location_for_the_new_file)
+        else # else we don't have to do anything.
+        end
+      else
+        copy_this_file(entry, location_for_the_new_file)
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === check_whether_to_show_the_source_code
+  #
+  # This is the method that can display the source code of a given .cgi
+  # page.
+  # ========================================================================= #
+  def check_whether_to_show_the_source_code
+    # ======================================================================= #
+    # We must also check whether the configuration file allows us to
+    # show the source code.
+    # ======================================================================= #
+    if show_source? and ::Cyberweb.config['may_show_source']
+      _ = this_file?(:full_path)
+      ee '<html>'
+      ee '<head>'
+      # ===================================================================== #
+      # Add the following in order to enable on-click highlight at a later time.
+      # ===================================================================== #
+      ee HtmlTags.style('.highlight {
+           background:yellow;
+         }')
+      ee '</head>'
+      ee '<body>'
+      ee 'Next displaying the source code of the file <b>'+_+'</b>'
+      # ===================================================================== #
+      # The following has not yet been enabled. It shall follow this
+      # here:
+      #
+      #   http://jsfiddle.net/kB7u2/1/
+      #
+      # ===================================================================== #
+if false
+      output_this_javascript "
+      $('.stripe_table').hover(
+  function() {
+    $(this).addClass('highlight');
+  }, function() {
+    $(this).removeClass('highlight');
+  }
+)"
+end
+      dataset = File.readlines(_)
+      n_lines = dataset.size
+      ee '<h4>'+n_lines.to_s+' lines</h4>'
+      ee '<pre>'
+      # ===================================================================== #
+      # Presently, we will always display the index-number.
+      # ===================================================================== #
+      dataset.each_with_index {|content, index|
+        index += 1
+        ee '<span class="line_'+index.to_s+'"><b>'+index.to_s.ljust(5)+'</b>'+content+'</span>'
+      }
+      ee '</pre>'
+      ee '</body></html>'
+      exit
+    end
+  end
+
+  # ========================================================================= #
+  # === do_show_source
+  # ========================================================================= #
+  def do_show_source
+    @internal_hash[:show_source] = true
+  end
+
+  require 'cyberweb/toplevel_methods/video.rb'
+  # ========================================================================= #
+  # === embed_youtube_video
+  #
+  # This method will "embed" a youtube video into the local web-app.
+  #
+  # Usage example:
+  #
+  #   embed_youtube_video 'https://www.youtube.com/watch?v=sAeMTsvGmoQ',
+  #                        css_class: 'rounded_black2'
+  #
+  # ========================================================================= #
+  def embed_youtube_video(
+      src    = 'gexazLr6pSY',
+      width  = '640',
+      height = '385'
+    )
+    addnl(
+      ::Cyberweb.embed_youtube_video(
+        src,
+        width,
+        height
+      )
+    )
+  end; alias eyv                embed_youtube_video # === eyv
+       alias youtube            embed_youtube_video # === youtube
+       alias youtube_links      embed_youtube_video # === youtube_links
+       alias youtube_link       embed_youtube_video # === youtube_link
+       alias youtube_video      embed_youtube_video # === youtube_video
+       alias embed_video_file   embed_youtube_video # === embed_video_file
+       alias embed_video        embed_youtube_video # === embed_video
+       alias embed_youtube_link embed_youtube_video # === embed_youtube_link
+
+  # ========================================================================= #
+  # === add_this_css_style
+  #
+  # This method can be used to add ad-hoc CSS code to a webpage.
+  # ========================================================================= #
+  def add_this_css_style(i)
+    addnl(
+      return_css_style(i)
+    )
+  end; alias add_to_CSS_rules add_this_css_style # === add_to_CSS_rules
+       alias estyle           add_this_css_style # === estyle
+
+  # ========================================================================= #
+  # === show_the_keyboard
+  #
+  # This method will show a fancy CSS-styled keyboard.
+  # ========================================================================= #
+  def show_the_keyboard(
+      optional_css_class = ''
+    )
+    estyle '.container_for_the_keyboard {
+  margin: 100px 0 0 200px;
+}
+
+.row_for_the_keyboard {
+  width: 100%;
+  height: 60px;
+}
+
+.row_one,
+.row_two,
+.row_three,
+.row_four,
+.row_five {
+  margin: 10px 0 0 0;
+}
+
+button.for_the_keyboard {
+  color: black;
+  font-weight: 500;
+  width: 55px;
+  height: 55px;
+  border: none;
+  background: rgb(214, 214, 214);
+  box-shadow: 0 0 10px #9521f3, 0 0 40px #c600ee, 0 0 80px #f704f7;
+
+  font-size: 15px;
+  margin-left: 5px;
+  outline: none;
+  font-family: Arial, Helvetica, sans-serif;
+  border-radius: 20%;
+}
+
+button.for_the_keyboard:active {
+  box-shadow: 1px 1px 2px #fd0c99,
+              1px 1px 2px #ff00dd;
+}
+
+.print_key {
+  width: 85px !important;
+  border-radius: 10px !important;
+}
+
+.backspace_key {
+  width: 148px !important;
+  border-radius: 10px !important;
+}
+
+.tab_key {
+  width: 115px !important;
+  border-radius: 10px !important;
+}
+
+.slace_key {
+  width: 90px !important;
+  border: 10px !important;
+}
+
+.caps_lock_key {
+  width: 96px !important;
+  border-radius: 10px !important;
+}
+
+.enter_button {
+  width: 109px !important;
+  border-radius: 10px !important;
+}
+
+.shift_key {
+  width: 135px !important;
+  border-radius: 10px !important;
+}
+
+.space_key {
+  width: 398px !important;
+  border-radius: 10px !important;
+}
+
+.last_row {
+  width: 56px !important;
+  border-radius: 10px !important;
+}
+'
+  div(optional_css_class) {
+     e File.read(
+         project_base_directory?+'skeleton/html_keyboard.md',
+         encoding: use_which_encoding?
+     )
+   }
+  end
+
+  # ========================================================================= #
+  # === title?
+  #
+  # Query method for the title of our webpage.
+  #
+  # Note that the method .title() is an alias for .title?(); in the past,
+  # before April 2022, it was an alias for .set_title() instead.
+  # ========================================================================= #
+  def title?
+    ::Cyberweb.title?
+  end; alias use_this_title? title? # === use_this_title?
+       alias title           title? # === use_this_title?
+
+  # ========================================================================= #
+  # === p_default_english
+  #
+  # This method is specifically to keep track of IDs that are written
+  # in the english language. At a later time in point this may become
+  # more relevant.
+  # ========================================================================= #
+  def p_default_english(
+      optional_css_class = '',
+      the_id             = '',
+      optional_css_style = '',
+      &block
+    )
+    if the_id.empty?
+      the_id = "english"
+    else
+      the_id = "english_{the_id}" unless the_id.start_with?('english_')
+    end
+    p_default(optional_css_class, the_id, optional_css_style, &block)
+  end
+
+  # ========================================================================= #
+  # === div_p_default
+  # ========================================================================= #
+  def div_p_default(
+      optional_css_class = '',
+      the_id             = '',
+      optional_css_style = '',
+      &block
+    )
+    div_default(optional_css_class, the_id, optional_css_style) {
+      p_default(optional_css_class, the_id, optional_css_style, &block)
+    }
+  end
+
+  # ========================================================================= #
+  # === current_temperature?
+  # ========================================================================= #
+  def current_temperature?
+    begin
+      require 'wetter'
+    rescue LoadError; end
+    return Wetter.simplified_current_degrees # Wetter.current_degrees
+  end
+
+  # ========================================================================= #
+  # === Cyberweb::WebObject.evaluate_from_the_same_named_file_then_serve
+  #
+  # This is the simplified variant that can be used for .cgi files, if
+  # a nearby .rb file exists. In order for this to work, the file must
+  # have the same name, minus the extension (which can be different).
+  # ========================================================================= #
+  def self.evaluate_from_the_same_named_file_then_serve(
+      output_the_result              = :default,
+      optional_use_this_name_instead = nil
+    )
+    _ = Cyberweb::WebObject.new
+    ::Cyberweb.set_web_object(_)
+    _.evaluate_from_the_same_named_file(optional_use_this_name_instead)
+    return _.do_serve(output_the_result)
+  end
+
   # ========================================================================= #
   # === register_ids?
   # ========================================================================= #
@@ -304,72 +1306,6 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
     main_css "#{i}\n#{TEMPLATE1}"
   end
 
-  # ========================================================================= #
-  # === string_link
-  #
-  # This method essentially creates a String representation of the HTML
-  # <a> tag.
-  #
-  # Since as of April 2022 the method "slink" is now an alias to string_link;
-  # it used to be an alias towards "def a()", but this was changed - the
-  # word string_link more logically may refer to slink as its intrinsic
-  # abbreviation.
-  # ========================================================================= #
-  def string_link(
-      i           = '',
-      option_hash = {},
-      &block
-    )
-    # ======================================================================= #
-    # === Handle blocks given to this method next
-    # ======================================================================= #
-    if block_given?
-      yielded = yield
-      case yielded
-      # ===================================================================== #
-      # === :pretty
-      # ===================================================================== #
-      when :pretty
-        option_hash[:remote_URL] = beautiful_url(i)
-      end
-    end
-    if i.is_a?(Symbol)
-      if i.start_with?('local_')
-        i = BeautifulUrl.local_menu(i)
-      else
-        i = beautiful_url(i)
-        # =================================================================== #
-        # Also check if the second argument is a String. In this case we
-        # must modify it. Example for input that fulfils this criterium:
-        #
-        #   remote_link(:hydrogenase, 'Hydrogenase')+
-        #
-        # =================================================================== #
-        if option_hash.is_a? String
-          option_hash = { content: option_hash }
-        end
-      end
-    end
-    # ======================================================================= #
-    # === Handle local entries for the "/home/x" directory layout.
-    # ======================================================================= #
-    if i.start_with? '/home/x'
-      i = i.dup
-      i.sub!(/\/home\/x\//, relative_path?)
-    end
-    i = rds(i.to_s.dup)
-    # ======================================================================= #
-    # Delegate onto HtmlTags.a().
-    # ======================================================================= #
-    return HtmlTags.a(
-      i,
-      option_hash
-    )
-  end; alias string_a           string_link # === string_a
-       alias string_href        string_link # === string_href
-       alias string_remote_link string_link # === string_remote_link
-       alias slink              string_link # === slink
-
   # ========================================================================= #
   # === default_hyperlinks_template1
   # ========================================================================= #
@@ -822,19 +1758,6 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
     @internal_hash[:string_lateron] << i
   end
 
-  # ========================================================================= #
-  # === title?
-  #
-  # Query method for the title of our webpage.
-  #
-  # Note that the method .title() is an alias for .title?(); in the past,
-  # before April 2022, it was an alias for .set_title() instead.
-  # ========================================================================= #
-  def title?
-    ::Cyberweb.title?
-  end; alias use_this_title? title? # === use_this_title?
-       alias title           title? # === use_this_title?
-
   # ========================================================================= #
   # === add_html_comment
   #
@@ -2713,50 +3636,6 @@ a:hover {
        alias fancy_stars      hr_stars # === fancy_stars
        alias pretty_separator hr_stars # === pretty_separator
 
-  # ========================================================================= #
-  # === div_p_default
-  # ========================================================================= #
-  def div_p_default(
-      optional_css_class = '',
-      the_id             = '',
-      optional_css_style = '',
-      &block
-    )
-    div_default(optional_css_class, the_id, optional_css_style) {
-      p_default(optional_css_class, the_id, optional_css_style, &block)
-    }
-  end
-
-  # ========================================================================= #
-  # === p_default
-  #
-  # This is similar to p(), but the implicit CSS class 'default' will
-  # be used.
-  # ========================================================================= #
-  def p_default(
-      optional_css_class = '',
-      the_id             = '',
-      optional_css_style = '',
-      &block
-    )
-    if optional_css_class.is_a? Hash
-      if optional_css_class.has_key? :id
-        the_id = optional_css_class.delete(:id)
-      end
-      if optional_css_class.is_a?(Hash) and optional_css_class.empty?
-        optional_css_class = ''
-      end
-    end
-    optional_css_class = optional_css_class.to_s.dup
-    optional_css_class.prepend('default ') # Make it the first argument.
-    p(
-      optional_css_class.strip,
-      the_id,
-      optional_css_style,
-      &block
-    )
-  end
-
   # ========================================================================= #
   # === return_stars
   # ========================================================================= #
@@ -2836,24 +3715,6 @@ a:hover {
     end
   end
 
-  # ========================================================================= #
-  # === do_copy_the_javascript_code_files_into_current_working_directory
-  # ========================================================================= #
-  def do_copy_the_javascript_code_files_into_current_working_directory
-    use_this_path = Cyberweb.project_base_directory?+'javascript_code/'
-    current_directory = return_pwd
-    # ======================================================================= #
-    # The next clause will only copy files - at a later time this may
-    # have to be changed to also copy directories, but for now (Oct 2022)
-    # this is the way to go.
-    # ======================================================================= #
-    Dir[use_this_path+'*'].select {|entry| File.file?(entry) }.each {|entry|
-      unless File.exist?(current_directory+File.basename(entry))
-        copy_this_file(entry)
-      end
-    }
-  end
-
   # ========================================================================= #
   # === return_css_style
   #
@@ -3167,16 +4028,6 @@ a:hover {
     e(i, optional_css_class)
   end
 
-  # ========================================================================= #
-  # === cmd3
-  # ========================================================================= #
-  def cmd3(
-      i                  = '',
-      optional_css_class = ::Cyberweb.command3?
-    )
-    e(i, optional_css_class)
-  end
-
   # ========================================================================= #
   # === cmd1_is
   # ========================================================================= #
@@ -3659,13 +4510,6 @@ SQL
     end
   end
 
-  # ========================================================================= #
-  # === listing_css
-  # ========================================================================= #
-  def listing_css(i)
-    ::Cyberweb.listing_css_object = i
-  end
-
   # ========================================================================= #
   # === spacer                                                   (spacer tag)
   # ========================================================================= #
@@ -3731,13 +4575,6 @@ SQL
     end
   end
 
-  # ========================================================================= #
-  # === do_show_source
-  # ========================================================================= #
-  def do_show_source
-    @internal_hash[:show_source] = true
-  end
-
   # ========================================================================= #
   # === show_source?
   # ========================================================================= #
@@ -4010,22 +4847,6 @@ SQL
     end
   end
 
-  # ========================================================================= #
-  # === oop_progress
-  #
-  # The progress element represents the completion progress of a task. The
-  # method here will simply delegate towards the corresponding objectified
-  # HTML tag. 
-  # ========================================================================= #
-  def oop_progress(
-      n_percent,
-      &block
-    )
-    addnl(
-      ::Cyberweb::Objectified::HtmlTags::Progress.new(n_percent, &block).to_s
-    )
-  end; alias progress oop_progress # === progress
-
   # ========================================================================= #
   # === text
   # ========================================================================= #
@@ -4190,64 +5011,6 @@ body {
        alias css_file             add_this_remote_css_page # === css_file
        alias external_style_sheet add_this_remote_css_page # === external_style_sheet
 
-  # ========================================================================= #
-  # === check_whether_to_show_the_source_code
-  #
-  # This is the method that can display the source code of a given .cgi
-  # page.
-  # ========================================================================= #
-  def check_whether_to_show_the_source_code
-    # ======================================================================= #
-    # We must also check whether the configuration file allows us to
-    # show the source code.
-    # ======================================================================= #
-    if show_source? and ::Cyberweb.config['may_show_source']
-      _ = this_file?(:full_path)
-      ee '<html>'
-      ee '<head>'
-      # ===================================================================== #
-      # Add the following in order to enable on-click highlight at a later time.
-      # ===================================================================== #
-      ee HtmlTags.style('.highlight {
-           background:yellow;
-         }')
-      ee '</head>'
-      ee '<body>'
-      ee 'Next displaying the source code of the file <b>'+_+'</b>'
-      # ===================================================================== #
-      # The following has not yet been enabled. It shall follow this
-      # here:
-      #
-      #   http://jsfiddle.net/kB7u2/1/
-      #
-      # ===================================================================== #
-if false
-      output_this_javascript "
-      $('.stripe_table').hover(
-  function() {
-    $(this).addClass('highlight');
-  }, function() {
-    $(this).removeClass('highlight');
-  }
-)"
-end
-      dataset = File.readlines(_)
-      n_lines = dataset.size
-      ee '<h4>'+n_lines.to_s+' lines</h4>'
-      ee '<pre>'
-      # ===================================================================== #
-      # Presently, we will always display the index-number.
-      # ===================================================================== #
-      dataset.each_with_index {|content, index|
-        index += 1
-        ee '<span class="line_'+index.to_s+'"><b>'+index.to_s.ljust(5)+'</b>'+content+'</span>'
-      }
-      ee '</pre>'
-      ee '</body></html>'
-      exit
-    end
-  end
-
   # ========================================================================= #
   # === display_this_file_without_comments
   #
@@ -4979,31 +5742,14 @@ end
   end; alias path= set_fixed_path # === path=
 
   # ========================================================================= #
-  # === set_proper_base_directory
-  # ========================================================================= #
-  def set_proper_base_directory
-    set_fixed_path(
-      ::Cyberweb.converted_path+
-      ::Cyberweb.name_of_img_dir?
-    )
-  end; alias absolute_position= set_proper_base_directory # === absolute_position=
-
-  # ========================================================================= #
-  # === config?
-  #
-  # A getter-method towards the config dataset.
-  #
-  # Usage Example:
-  #
-  #   w.config['use_jquery']
-  #
-  # ========================================================================= #
-  def config?
-    @config
-  end; alias web_object_config? config? # === web_object_config?
-       # alias config config? # === config
-       # ^^^ The above alias may be problematic; may re-enable or remove at
-       #     a later time (August 2018)
+  # === set_proper_base_directory
+  # ========================================================================= #
+  def set_proper_base_directory
+    set_fixed_path(
+      ::Cyberweb.converted_path+
+      ::Cyberweb.name_of_img_dir?
+    )
+  end; alias absolute_position= set_proper_base_directory # === absolute_position=
 
   # ========================================================================= #
   # === fetch_css_classes
@@ -5206,36 +5952,6 @@ end
     )
   end; alias mathml_start mathml # === mathml_start
 
-  # ========================================================================= #
-  # === obtain_the_parameters_passed
-  #
-  # This query-method will return which params have been passed into,
-  # for example, a .cgi page.parameters_as_string?
-  #
-  # Typical invocation may go like this:
-  #
-  #   w.obtain_the_parameters_passed
-  #
-  # ========================================================================= #
-  def obtain_the_parameters_passed
-    ::Cyberweb.params? # This is part of params.rb actually.
-  end; alias return_params_hash obtain_the_parameters_passed # === return_params_hash
-       alias web_params?        obtain_the_parameters_passed # === web_params?
-       alias web_params         obtain_the_parameters_passed # === web_params
-       alias params?            obtain_the_parameters_passed # === params?
-       alias params             obtain_the_parameters_passed # === params
-
-  # ========================================================================= #
-  # === obtain_this_param_as_string
-  #
-  # This method must guarantee to return a String.
-  # ========================================================================= #
-  def obtain_this_param_as_string(i)
-    _ = params?[i]
-    _ = _.first if _.is_a? Array
-    return _.to_s # e. g. {"view"=>["/tmp"]}
-  end; alias params_as_string? obtain_this_param_as_string # === params_as_string?
-
   # ========================================================================= #
   # === param_first_key?
   # ========================================================================= #
@@ -6183,31 +6899,6 @@ end
     e i, 'padl1em'
   end
 
-  require 'cyberweb/toplevel_methods/video.rb'
-  # ========================================================================= #
-  # === embed_youtube_video
-  # ========================================================================= #
-  def embed_youtube_video(
-      src    = 'gexazLr6pSY',
-      width  = '640',
-      height = '385'
-    )
-    addnl(
-      ::Cyberweb.embed_youtube_video(
-        src,
-        width,
-        height
-      )
-    )
-  end; alias eyv                embed_youtube_video # === eyv
-       alias youtube            embed_youtube_video # === youtube
-       alias youtube_links      embed_youtube_video # === youtube_links
-       alias youtube_link       embed_youtube_video # === youtube_link
-       alias youtube_video      embed_youtube_video # === youtube_video
-       alias embed_video_file   embed_youtube_video # === embed_video_file
-       alias embed_video        embed_youtube_video # === embed_video
-       alias embed_youtube_link embed_youtube_video # === embed_youtube_link
-
   # ========================================================================= #
   # === embed_videos
   #
@@ -6704,81 +7395,6 @@ end
     ENV['REQUEST_URI'].to_s
   end
 
-  # ========================================================================= #
-  # === l2
-  # ========================================================================= #
-  def l2(
-      i                  = '',
-      optional_css_class = '',
-      optional_the_id    = ''
-    )
-    if optional_css_class.is_a? Hash
-      # ======================================================================= #
-      # === :id
-      # ======================================================================= #
-      if optional_css_class.has_key? :id
-        optional_the_id = optional_css_class.delete(:id)
-      end
-    end
-    if optional_css_class.frozen?
-      optional_css_class = optional_css_class.dup
-      optional_css_class << ' padl2em'
-    end 
-    s2(i, optional_css_class.strip, optional_the_id)
-  end; alias l2em    l2 # === l2em
-       alias padl2em l2 # === padl2em
-
-  # ========================================================================= #
-  # === l1                                                           (l1 tag)
-  #
-  # The second argument to this method may sometimes be a Hash, such as:
-  #
-  #   'foobar', id: 'mini-car'
-  #
-  # ========================================================================= #
-  def l1(
-      i                  = '',
-      optional_css_class = '',
-      optional_the_id    = ''
-    )
-    if optional_css_class.is_a? Hash
-      # ======================================================================= #
-      # === :id
-      # ======================================================================= #
-      if optional_css_class.has_key? :id
-        optional_the_id = optional_css_class.delete(:id)
-      end
-      if optional_css_class.is_a?(Hash) and optional_css_class.empty?
-        optional_css_class = optional_css_class.to_s
-      end
-    end
-    optional_css_class = optional_css_class.dup
-    optional_css_class << ' padl1em' # Add the padl1em CSS class here.
-    s2(
-      i, optional_css_class.strip, optional_the_id
-    )
-  end; alias l1em    l1 # === l1em
-       alias l1m     l1 # === l1m
-       alias lem1    l1 # === lem1
-       alias padlem  l1 # === padlem
-       alias padl1em l1 # === padl1em
-
-  # ========================================================================= #
-  # === l2emb
-  # ========================================================================= #
-  def l2emb(
-      i                  = '',
-      optional_css_class = ''
-    )
-    l2(i, optional_css_class)
-    br
-  end; alias l2br      l2emb # === l2br
-       alias l2embr    l2emb # === l2embr
-       alias lem2      l2emb # === lem2
-       alias lembre2   l2emb # === lembre2
-       alias padl2embr l2emb # === padl2embr
-       alias le2       l2emb # === le2
-
   # ========================================================================= #
   # === load_yaml_configuration                                  (yaml tag)
   #
@@ -6843,28 +7459,6 @@ end
     return '<hr>'
   end
 
-  # ========================================================================= #
-  # === lembre
-  # ========================================================================= #
-  def lembre(
-      i                  = '',
-      optional_css_class = '',
-      optional_the_id    = ''
-    )
-    l1(
-      i,
-      optional_css_class,
-      optional_the_id
-    )
-    br
-  end; alias lem1br    lembre # === lembre
-       alias lem       lembre # === lem
-       alias lemspan   lembre # === lemspan
-       alias lee       lembre # === lee
-       alias lembr     lembre # === lembr
-       alias padl1embr lembre # === padl1embr
-       alias le        lembre # === le
-
   # ========================================================================= #
   # === on_this_id
   # ========================================================================= #
@@ -6913,23 +7507,6 @@ function '+name_of_the_function_to_use+'{
 '
   end
 
-  # ========================================================================= #
-  # === dimgbr
-  #
-  # This method combines dimg() and br().
-  # ========================================================================= #
-  def dimgbr(
-      url       = '',
-      css_class = '', 
-      the_id    = '',
-      css_style = '',
-      alt_text  = '',
-      &block
-    )
-    dimg(url, css_class, the_id, css_style, alt_text, &block)
-    br
-  end
-
   # ========================================================================= #
   # === stars
   # ========================================================================= #
@@ -7546,42 +8123,6 @@ function simple_clock_timer() {
     return ::Cyberweb.html_comment(of_this_text.to_s)
   end
 
-  # ========================================================================= #
-  # === reset_the_listing_counter
-  # ========================================================================= #
-  def reset_the_listing_counter
-    @internal_hash[:listing_counter] = 0
-  end; alias reset_counter reset_the_listing_counter # === reset_counter
-
-  # ========================================================================= #
-  # === listing_counter?
-  # ========================================================================= #
-  def listing_counter?
-    @internal_hash[:listing_counter]
-  end; alias listing_counter listing_counter? # === listing_counter
-
-  # ========================================================================= #
-  # === listing_counter=
-  # ========================================================================= #
-  def listing_counter=(i)
-    @internal_hash[:listing_counter] = i
-  end
-
-  # ========================================================================= #
-  # === counter_li
-  #
-  # This method was added in June 2021.
-  # ========================================================================= #
-  def counter_li(
-      i                  = '',
-      optional_css_class = ''
-    )
-    @internal_hash[:listing_counter] += 1
-    e '('+@internal_hash[:listing_counter].to_s+') '+
-      i.to_s,
-      optional_css_class
-  end
-
   # ========================================================================= #
   # === database?
   # ========================================================================= #
@@ -8159,17 +8700,6 @@ function simple_clock_timer() {
     return i
   end
 
-  # ========================================================================= #
-  # === add_this_css_style
-  #
-  # This method can be used to add ad-hoc CSS code to a webpage.
-  # ========================================================================= #
-  def add_this_css_style(i)
-    addnl(
-      return_css_style(i)
-    )
-  end; alias add_to_CSS_rules add_this_css_style # === add_to_CSS_rules
-
   # ========================================================================= #
   # === add_all_local_css_files
   #
@@ -8356,32 +8886,13 @@ function simple_clock_timer() {
     )
   end
 
-  require 'cyberweb/toplevel_methods/dot.rb'
-  # ========================================================================= #
-  # === string_dot
-  # ========================================================================= #
-  def string_dot(
-      i                  = 108,
-      optional_css_class = '',
-      optional_the_id    = '',
-      optional_css_style = ''
-    )
-    _ = sg(
-      "dot#{i}".to_sym,
-      optional_css_class,
-      optional_the_id,
-      optional_css_style
-    )
-    return _
-  end; alias dot string_dot # === dot (dot tag)
-
   # ========================================================================= #
   # === dot101?
   #
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot101?
-    dot(101, 'marr10px')
+    string_dot(101, 'marr10px')
   end
 
   # ========================================================================= #
@@ -8390,7 +8901,7 @@ function simple_clock_timer() {
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot102?
-    dot(102, 'marr10px')
+    string_dot(102, 'marr10px')
   end
 
   # ========================================================================= #
@@ -8399,7 +8910,7 @@ function simple_clock_timer() {
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot103?
-    dot(103, 'marr10px')
+    string_dot(103, 'marr10px')
   end
 
   # ========================================================================= #
@@ -8408,7 +8919,7 @@ function simple_clock_timer() {
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot104?
-    dot(104, 'marr10px')
+    string_dot(104, 'marr10px')
   end
 
   # ========================================================================= #
@@ -8417,7 +8928,7 @@ function simple_clock_timer() {
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot105?
-    dot(105, 'marr10px')
+    string_dot(105, 'marr10px')
   end
 
   # ========================================================================= #
@@ -8426,7 +8937,7 @@ function simple_clock_timer() {
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot106?
-    dot(106, 'marr10px')
+    string_dot(106, 'marr10px')
   end
 
   # ========================================================================= #
@@ -8435,7 +8946,7 @@ function simple_clock_timer() {
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot107?
-    dot(107, 'marr10px')
+    string_dot(107, 'marr10px')
   end
 
   # ========================================================================= #
@@ -8444,26 +8955,34 @@ function simple_clock_timer() {
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
   def dot108?
-    dot(108, 'marr10px')
+    string_dot(108, 'marr10px')
   end
 
   # ========================================================================= #
-  # === dot109?
+  # === dot110?
   #
   # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
-  def dot109?
-    dot(109, 'marr10px')
+  def dot110?
+    string_dot(110, 'marr10px')
   end
 
   # ========================================================================= #
-  # === dot110?
+  # === config?
+  #
+  # A getter-method towards the config dataset.
+  #
+  # Usage Example:
+  #
+  #   w.config['use_jquery']
   #
-  # This simply wraps over dot() with a default value and default CSS.
   # ========================================================================= #
-  def dot110?
-    dot(110, 'marr10px')
-  end
+  def config?
+    @config
+  end; alias web_object_config? config? # === web_object_config?
+       # alias config config? # === config
+       # ^^^ The above alias may be problematic; may re-enable or remove at
+       #     a later time (August 2018)
 
   # ========================================================================= #
   # === Cyberweb::WebObject.evaluate_from_this_file_via_beautiful_url