cyberweb 0.6.17 → 0.7.9

data/lib/cyberweb/web_object/misc.rb

@@ -12,6 +12,297 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
 
   require 'cyberweb/javascript/javascript_helper/javascript_helper.rb'
   require 'cyberweb/modules/css_style.rb'
+  require 'cyberweb/utility_scripts/obtain_css_rules.rb'
+
+  begin
+    require 'roebe/classes/to_binary.rb'
+  rescue LoadError; 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
+
+  # ========================================================================= #
+  # === science_hyperlinks
+  #
+  # This method will add some of my default hyperlinks for local files,
+  # in regards to science-related links/content.
+  #
+  # The first argument to this method can be additional entries that
+  # the user may want to display.
+  #
+  # Usage examples:
+  #
+  #   science_hyperlinks
+  #   science_hyperlinks { :use_unicode_right_arrows }
+  #
+  # ========================================================================= #
+  def science_hyperlinks(
+      additional_entries = nil,
+      &block
+    )
+    array_science_entries = %w(
+      local_cellbiology
+      local_biochemistry
+      local_chemistry
+      local_genetics
+      local_gene_expression
+      local_microbiology
+      local_biotechnology
+      local_evolution
+    )
+    if additional_entries
+      array_science_entries << [additional_entries]
+      array_science_entries.flatten!
+      array_science_entries.compact! 
+    end
+    yielded = nil
+    yielded = yield if block_given?
+    array_science_entries.each {|this_local_link|
+      this_local_link = BeautifulUrl.local_menu(this_local_link)
+      short_name = File.basename(this_local_link).delete_suffix('.cgi').dup.
+                   tr('_',' ').
+                   sub(/local/,'')
+      if yielded == :use_unicode_right_arrows
+        short_name.prepend('→')
+      end
+      abr_self(
+        this_local_link,
+        content: short_name
+      )
+    }
+  end; alias add_science_links science_hyperlinks # === add_science_links
+       alias science_links     science_hyperlinks # === science_links
+
+  # ========================================================================= #
+  # === register_ids?
+  # ========================================================================= #
+  def register_ids?
+    @internal_hash[:register_ids]
+  end; alias registered_ids? register_ids? # === registered_ids?
+
+  # ========================================================================= #
+  # === random_alphabet_characters
+  # ========================================================================= #
+  def random_alphabet_characters(
+      n_characters = 10
+    )
+    _ = ''.dup
+    n_characters.times {
+      _ << ('a' .. 'z').to_a.sample
+    }
+    return _
+  end
+
+  # ========================================================================= #
+  # === is_a_duplicate_id?
+  # ========================================================================= #
+  def is_a_duplicate_id?(i)
+    @internal_hash[:register_ids].include?(i)
+  end
+
+  # ========================================================================= #
+  # === register_this_id
+  #
+  # This method will register the ID that is used into the corresponding
+  # Array.
+  # ========================================================================= #
+  def register_this_id(the_id = '')
+    if the_id and the_id.to_s.start_with?('drag')
+      drag_and_drop(the_id)
+    end
+    @internal_hash[:register_ids] << the_id
+    return the_id # Always return it here.
+  end; alias register_id register_this_id # === register_id
+
+  # ========================================================================= #
+  # === header
+  #
+  # This is a variant for h1() essentially.
+  # ========================================================================= #
+  def header(
+      i                   = '',
+      optional_css_class  = '',
+      optional_the_id     = '',
+      optional_css_style  = '',
+      optional_javascript = ''
+    )
+    if optional_the_id.empty?
+      # ===================================================================== #
+      # Determine the id next:
+      # ===================================================================== #
+      optional_the_id = ::Cyberweb.remove_html(i).tr(' ','_')
+    end
+    h1(
+      i,
+      optional_css_class,
+      optional_the_id,
+      optional_css_style,
+      optional_javascript
+    )
+    @internal_hash[:register_ids] << register_this_id(optional_the_id) # optional_the_id
+  end
+
+  # ========================================================================= #
+  # === internal_hash?
+  # ========================================================================= #
+  def internal_hash?
+    @internal_hash
+  end
+
+  # ========================================================================= #
+  # === dynamic_text_shadow
+  #
+  # This method can be used to generate a dynamic text shadow.
+  # ========================================================================= #
+  def dynamic_text_shadow(
+      optional_hash = {
+        padding_to_use: '5vmin',
+        background_hsl: 'hsl(200 50% 50%)'
+      }
+    )
+    _ = optional_hash
+    if _.has_key? :padding
+      padding_to_use = _[:padding].to_s
+    elsif _.has_key? :padding_to_use
+      padding_to_use = _[:padding_to_use].to_s
+    end
+    if _.has_key? :background_hsl
+      background_hsl = _[:background_hsl].to_s
+    else # else use a default
+      background_hsl = 'hsl(200 50% 50%)'
+    end
+    # ======================================================================= #
+    # Next add these to the main CSS rules:
+    # ======================================================================= #
+    return '
+    .dynamic_text_shadow {
+      /* larger font size, more shadow distance  */
+      text-shadow: .1em .1em 0 hsl(200 50% 30%);
+      block-size: 100%;
+      background: '+background_hsl+';
+      color:      hsl(200 50% 90%);
+      font-family: "Fugaz One", cursive;
+      min-block-size: 100%;
+      padding: '+padding_to_use+';
+      display: grid;
+    }'
+  end; alias return_dynamic_text_shadow dynamic_text_shadow # === return_dynamic_text_shadow
+       alias dynamic_header             dynamic_text_shadow # === dynamic_header
+
+  # ========================================================================= #
+  # === caps
+  # ========================================================================= #
+  def caps(i = '')
+    return '<span class="pretty_caps">'+i.to_s+'</span>'
+  end; alias cap caps # === cap
+
+  # ========================================================================= #
+  # === string_tag
+  # ========================================================================= #
+  def string_tag(
+      which_tag       = 'span',
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = '',
+      &block
+    )
+    return ::Cyberweb.string_tag(
+      which_tag,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end; alias stag        string_tag # === stag
+       alias make_tag    string_tag # === make_tag
+       alias string_stag string_tag # === string_stag
+
+  # ========================================================================= #
+  # === README
+  # ========================================================================= #
+  def README(
+      i = 'README.md'
+    )
+    # require 'kramdown'
+    # doc = Kramdown::Document.new(File.read(i))
+    # i = doc.to_html
+    display_this_file(i)
+  end
+
+  # ========================================================================= #
+  # === to_binary
+  # ========================================================================= #
+  def to_binary(i)
+    return Roebe::ToBinary.to(i)
+  end
+
+  # ========================================================================= #
+  # === readonly_input
+  #
+  # Usage example:
+  #
+  #   readonly_input id: 'result_for_circle_calculations'
+  #
+  # ========================================================================= #
+  def readonly_input(
+      i = nil
+    )
+    _ = '<input type="text"'.dup
+    if i and i.is_a? Hash
+      if i.has_key?(:id)
+        _ << ' id="'+i[:id].to_s+'"'
+      end
+    end
+    _ << ' readonly>'
+    addnl(_)
+  end
+
+  # ========================================================================= #
+  # === template1
+  # ========================================================================= #
+  def template1(
+      i = ''
+    )
+    obtain_css_rules = Cyberweb::ObtainCssRules.new
+    if i and i.include?('  .')
+      # ===================================================================== #
+      # In this case we may assume that i contains a custom CSS rule.
+      # ===================================================================== #
+      splitted = i.split("\n")
+      splitted.map! {|this_line| # parse each line
+        if this_line.start_with?('  .')
+          _ = this_line.strip.split(' ').first # Mandate a ' ' here.
+          obtain_css_rules.set_seek_this(_)
+          obtain_css_rules.parse_string(this_line)
+          replace_it_with_this_string = obtain_css_rules.body?
+          # ================================================================= #
+          # Next we have to replace something like '.mars1em;' with
+          # 'margin-right: 1em; margin-left: 1em'.
+          # ================================================================= #
+          this_line = replace_it_with_this_string
+        end
+        this_line # return it here.
+      }
+      i = splitted.join("\n")
+    end
+    main_css "#{i}\n#{TEMPLATE1}"
+  end
 
   # ========================================================================= #
   # === string_link
@@ -39,7 +330,7 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
       # === :pretty
       # ===================================================================== #
       when :pretty
-        i = beautiful_url(i)
+        option_hash[:remote_URL] = beautiful_url(i)
       end
     end
     if i.is_a?(Symbol)
@@ -71,7 +362,8 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
     # Delegate onto HtmlTags.a().
     # ======================================================================= #
     return HtmlTags.a(
-      i, option_hash
+      i,
+      option_hash
     )
   end; alias string_a           string_link # === string_a
        alias string_href        string_link # === string_href
@@ -87,6 +379,10 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
   end; alias default_hyperlinks_template default_hyperlinks_template1 # === default_hyperlinks_template
        alias hyperlinks_template1        default_hyperlinks_template1 # === hyperlinks_template1
        alias hyperlinks_template         default_hyperlinks_template1 # === hyperlinks_template
+       alias hyperlink_template1         default_hyperlinks_template1 # === hyperlink_template1
+       alias default_template1           default_hyperlinks_template1 # === default_template1
+       alias default_template            default_hyperlinks_template1 # === default_template
+       alias default_css_template        default_hyperlinks_template1 # === default_css_template
 
   # ========================================================================= #
   # === draw_triangle
@@ -491,7 +787,8 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
     table2('pad0_5em','glossar') {{
       with_this_data: use_this_dataset
     }}
-  end; alias glossar glossar_table # === glossar
+  end; alias glossar           glossar_table # === glossar
+       alias table_for_glossar glossar_table # === table_for_glossar
 
   # ========================================================================= #
   # === table5_with_heading
@@ -765,43 +1062,6 @@ document.body.innerHTML = "'+with_this_content+'"
     )
   end
 
-  # ========================================================================= #
-  # === science_hyperlinks
-  #
-  # This method will add some of my default hyperlinks for local files,
-  # in regards to science-related links/content.
-  #
-  # Usage examples:
-  #
-  #   science_hyperlinks
-  #   science_hyperlinks { :use_unicode_right_arrows }
-  #
-  # ========================================================================= #
-  def science_hyperlinks(&block)
-    array_science_entries = %w(
-      local_cellbiology
-      local_biochemistry
-      local_chemistry
-      local_genetics
-      local_gene_expression
-      local_microbiology
-      local_biotechnology
-    )
-    yielded = nil
-    yielded = yield if block_given?
-    array_science_entries.each {|this_local_link|
-      this_local_link = BeautifulUrl.local_menu(this_local_link)
-      short_name = File.basename(this_local_link).delete_suffix('.cgi').dup
-      if yielded == :use_unicode_right_arrows
-        short_name.prepend('→')
-      end
-      abr_self(
-        this_local_link,
-        content: short_name
-      )
-    }
-  end; alias add_science_links science_hyperlinks # === add_science_links
-
   # ========================================================================= #
   # === string_table7
   # ========================================================================= #
@@ -1115,15 +1375,6 @@ EOF
     )
   end; alias autoextend enable_namespace # === autoextend
 
-  # ========================================================================= #
-  # === img_dir?
-  # ========================================================================= #
-  def img_dir?
-    "#{server_base_directory?}"\
-    "data/"\
-    "#{return_name_of_the_images_directory}/"
-  end
-
   # ========================================================================= #
   # === append_onto_the_main_CSS_rules
   # ========================================================================= #
@@ -1197,21 +1448,6 @@ a:hover {
     }
   end
 
-  # ========================================================================= #
-  # === return_this_base64_image
-  # ========================================================================= #
-  def return_this_base64_image(
-      i,
-      optional_css_class = '',
-      optional_css_id    = ''
-    )
-    return ::Cyberweb.return_this_base64_image(
-      i,
-      optional_css_class,
-      optional_css_id
-    )
-  end
-
   # ========================================================================= #
   # === use_the_internal_CSS_files?
   # ========================================================================= #
@@ -1771,39 +2007,6 @@ a:hover {
     end
   end
 
-  # ========================================================================= #
-  # === display_all_images
-  #
-  # Use this when you just want to display all images.
-  #
-  # The first argument should be the location towards the
-  # directory that holds all images.
-  # ========================================================================= #
-  def display_all_images(
-      dir          = ::Cyberweb.return_pwd,
-      optional_css = 'bblack1'
-    )
-    if dir.is_a? Hash
-      dir = dir.delete(:from) if dir.has_key? :from
-    end
-    if dir.include? '$'
-      dir = ConvertGlobalEnv[dir]
-    end
-    unless Dir.exist? dir
-      e 'It seems as if the directory at `'+dir+'` does not exist.'
-    end
-    all_the_images = get_images_from(dir)
-    all_the_images.each {|file|
-      file = rds(file)
-      h3 file, 'slateblue'
-      imgbr(
-        file,
-        optional_css
-      )
-    }
-  end; alias display_images_from display_all_images # === display_images_from
-       alias display_images      display_all_images # === display_images
-
   # ========================================================================= #
   # === advanced_handle_these_calls_for_german
   # ========================================================================= #
@@ -1975,13 +2178,6 @@ a:hover {
     Cyberweb.server_base_directory?
   end
 
-  # ========================================================================= #
-  # === template1
-  # ========================================================================= #
-  def template1(i = '')
-    main_css "#{i}\n#{TEMPLATE1}"
-  end
-
   # ========================================================================= #
   # === add_unicode_charset
   # ========================================================================= #
@@ -2047,7 +2243,9 @@ a:hover {
       also_enable_link = false
     )
     case also_enable_link
+    # ======================================================================= #
     # === :also_enable_link
+    # ======================================================================= #
     when :also_enable_link
       also_enable_link = true
     end
@@ -2116,20 +2314,9 @@ a:hover {
   #
   # This will forbid serving the site to unallowed visitors.
   # ========================================================================= #
-  def ip_is_allowed?
-    exit unless ALLOWED_IPS.include? VISITOR_IP
-  end; alias forbidden ip_is_allowed? # === forbidden
-
-  # ========================================================================= #
-  # === do_use_in_dir_images
-  # ========================================================================= #
-  def do_use_in_dir_images
-    @config['use_in_dir_images'] = true
-    # ======================================================================= #
-    # Also keep track of the new path.
-    # ======================================================================= #
-    ::Cyberweb.set_path_to_images('')
-  end; alias use_in_dir_images do_use_in_dir_images # === use_in_dir_images
+  def ip_is_allowed?
+    exit unless ALLOWED_IPS.include? VISITOR_IP
+  end; alias forbidden ip_is_allowed? # === forbidden
 
   # ========================================================================= #
   # === return_only_duplicates
@@ -2416,56 +2603,6 @@ a:hover {
        alias highlight_tag      on_click_change_opacity # === highlight_tag
        alias highlight          on_click_change_opacity # === highlight
 
-  # ========================================================================= #
-  # === base64_image
-  #
-  # This is distinct to other base64-related images within the Cyberweb
-  # project. It will simply, and directly, add the given data.
-  # ========================================================================= #
-  def base64_image(
-      i, image_type_to_use = :infer
-    )
-    addnl(
-      return_base64_image(i, image_type_to_use)
-    )
-  end
-
-  # ========================================================================= #
-  # === return_base64_image
-  # ========================================================================= #
-  def return_base64_image(
-      i,
-      image_type_to_use  = :infer,
-      optional_css_class = '',
-      optional_the_id    = '',
-      optional_css_style = ''
-    )
-    case image_type_to_use
-    # ======================================================================= #
-    # === :infer
-    # ======================================================================= #
-    when :infer
-      image_type_to_use = File.extname(i)
-      if image_type_to_use.empty?
-        image_type_to_use = 'png' # Rescue in this case.
-      end
-    end
-    _ = '<img src="data:image/'+
-        image_type_to_use.to_s.delete('.')+
-        ';base64,'+i+'"'.dup
-    if optional_css_class
-      _ << css_class_or_no_class(optional_css_class)
-    end
-    if optional_the_id
-      _ << id_or_no_id(optional_the_id)
-    end
-    if optional_css_style
-      _ << css_style_or_no_style(optional_css_style)
-    end
-    _ << '>'
-    return _
-  end
-
   # ========================================================================= #
   # === pfeil_rechts
   # ========================================================================= #
@@ -2656,7 +2793,7 @@ a:hover {
   # ========================================================================= #
   def five_stars(optional_css_class = '')
     return_stars(5, optional_css_class)
-  end
+  end; alias return_five_stars five_stars # === return_five_stars
 
   # ========================================================================= #
   # === efive_stars
@@ -2957,7 +3094,6 @@ a:hover {
       File.extname(absolute_path_to_the_image)
     ).downcase
     dataset = convert_image_to_base64(absolute_path_to_the_image)
-
     addnl(
       return_base64_image(
         dataset, :infer, css_class, use_this_id, css_style
@@ -2965,58 +3101,6 @@ a:hover {
     )
   end; alias draggable_base64img draggable_img_base64 # === draggable_base64img
 
-  # ========================================================================= #
-  # === local_image_or_remote_image
-  #
-  # This method can be used to add a substitute image in the event that
-  # a local image could not be found. Otherwise it behaves exactly like
-  # image() does.
-  # ========================================================================= #
-  def local_image_or_remote_image(
-      local_image             = '',
-      remote_image_substitute = '', # This one should be the remote URL.
-      optional_css_class      = '',
-      optional_the_id         = '',
-      optional_css_style      = '',
-      alt_text                = '',
-      &block
-    )
-    # ======================================================================= #
-    # We first have to decide whether the image exists or whether it does
-    # not exist, at the specified location. If it exists then we can use
-    # the regular img() call; otherwise we have to use the second argument
-    # to this method.
-    # ======================================================================= #
-    assumed_path = rds(
-      path_to_the_image_directory?+
-      local_image
-    )
-    if File.exist?(assumed_path) and !local_image.empty?
-      img(
-        local_image,
-        optional_css_class,
-        optional_the_id,
-        optional_css_style,
-        alt_text,
-        &block
-      )
-    else
-      # ===================================================================== #
-      # else we use a remote URL or a rescue URL anyway.
-      # ===================================================================== #
-      remote_img(
-        remote_image_substitute,
-        {
-          css_class: optional_css_class,
-          id:        optional_the_id,
-          css_style: optional_css_style
-        },
-        &block
-        # alt_text is currently not handled here.
-      )
-    end
-  end
-
   # ========================================================================= #
   # === save_into_this_html_page?
   # ========================================================================= #
@@ -4410,19 +4494,6 @@ end
        alias t=        set_title # === t=
        alias title=    set_title # === title= # <-- This alias here may be more popular than set_title().
 
-  # ========================================================================= #
-  # === embed_this_image
-  # ========================================================================= #
-  def embed_this_image(
-      i                  = 'lyxandras-das-Dorf-Nadorp.jpg',
-      optional_css_class = 'bblack1',
-      optional_the_id    = ''
-    )
-    addnl(
-      ::Cyberweb.embed_this_image(i, optional_css_class, optional_the_id)
-    )
-  end
-
   # ========================================================================= #
   # === check_for_links_markdown_file
   #
@@ -5024,32 +5095,6 @@ end
     }
   end
 
-  # ========================================================================= #
-  # === relative_background_image
-  #
-  # We have to build the proper path, e. g.:
-  #
-  #   url(data/images/WALLPAPERS/TheCalling_AnimeWallpaper.jpg);
-  #
-  # ========================================================================= #
-  def relative_background_image(this_image)
-    _ = ('../' * n_steps_to_the_base_directory?) + 
-        "#{name_of_img_dir?}".dup
-    _ << this_image
-    background_image = "background-image: url(#{_});" # The string to append.
-    # ======================================================================= #
-    # Next, add some default assumptions here. No repeat is ok to
-    # use, centered background position - not sure.
-    #   background-position: center;
-    # ======================================================================= #
-    add_this_css_style(
-      'body {
-         '+background_image+'
-         background-repeat: no-repeat;
-       }'
-    )
-  end
-
   # ========================================================================= #
   # === br                                                           (br tag)
   # ========================================================================= #
@@ -5161,61 +5206,6 @@ end
     )
   end; alias mathml_start mathml # === mathml_start
 
-  # ========================================================================= #
-  # === background_image=
-  #
-  # Use this method to set the background image for a page.
-  #
-  #   body {background-image: url("../IMG/");}'
-  #
-  # Since as of December 2011, if you pass an argument such as 'NJOY/#RAND'
-  # then we use this as instruction to fetch a random entry from this
-  # directory.
-  #
-  # Usage Example:
-  #
-  #   w.background_image = 'NJOY/#RAND'
-  #
-  # ========================================================================= #
-  def background_image=(
-      i = '/blaaa/foo.png'
-    )
-    _ = "#{name_of_img_dir?}/".dup # Hardcoded for now. Yes, I am aware that this sucks.
-    if i.to_s.downcase.include? '#rand' # Then get path given. Example: w.background_image = 'NJOY/#RAND'
-      first_part = i.split('#').first
-      _ << first_part
-      _ << get_files_from(::Cyberweb.path_to_images?).sample.to_s
-    else
-      case i
-      when :random
-        _ << Dir[::Cyberweb.path_to_images?+'NJOY/*'].sample.
-             sub(/\/home\/x\/DATA\/IMG\//, '')
-      else
-        _ << i
-      end
-    end
-    background_img = "background-image: url(#{::Cyberweb.path_to_images?}#{_});" # The string to append.
-    # ======================================================================= #
-    # Next, add some default assumptions here. No repeat is ok to
-    # use, centered background position - not sure.
-    #   background-position: center;
-    # ======================================================================= #
-    add_this_css_style(
-      'body {
-         '+background_img+'
-         background-repeat: no-repeat;
-       }'
-    )
-  end; alias body_background_image background_image= # === body_background_image
-       alias background_image      background_image= # === background_image
-
-  # ========================================================================= #
-  # === return_the_registered_base64_images
-  # ========================================================================= #
-  def return_the_registered_base64_images
-    ::Cyberweb.base64_images
-  end
-
   # ========================================================================= #
   # === obtain_the_parameters_passed
   #
@@ -5376,15 +5366,6 @@ end
     )
   end
 
-  # ========================================================================= #
-  # === disable_webimages
-  #
-  # We wont use the webimages if we use this method here.
-  # ========================================================================= #
-  def disable_webimages
-    ::Cyberweb.config?['use_webimages'] = false
-  end
-
   # ========================================================================= #
   # === add_the_title_to_the_webobject
   # ========================================================================= #
@@ -6547,29 +6528,6 @@ end
   end; alias beautiful_legend field_with_legend # Alias beautiful_legend() towards field_with_legend().
        alias mini_header      field_with_legend # Alias mini_header()      towards field_with_legend().
 
-  # ========================================================================= #
-  # === string_tag
-  # ========================================================================= #
-  def string_tag(
-      which_tag       = 'span',
-      css_class       = '',
-      the_id          = '',
-      css_style       = '',
-      javascript_code = '',
-      &block
-    )
-    return ::Cyberweb.string_tag(
-      which_tag,
-      css_class,
-      the_id,
-      css_style,
-      javascript_code,
-      &block
-    )
-  end; alias stag        string_tag # === stag
-       alias make_tag    string_tag # === make_tag
-       alias string_stag string_tag # === string_stag
-
   # ========================================================================= #
   # === external_javascript_file
   # ========================================================================= #
@@ -7227,21 +7185,6 @@ function '+name_of_the_function_to_use+'{
     end
   end
 
-  # ========================================================================= #
-  # === get_images
-  #
-  # This method will obtain all files from all subdirectories there as
-  # well.
-  # ========================================================================= #
-  def get_images(
-      from_this_dir = return_pwd
-    )
-    Dir["#{from_this_dir}/**/**"].select {|entry|
-      ::Cyberweb.is_an_image?(entry)
-    }
-  end; alias get_images_from        get_images # === get_images_from
-       alias return_all_images_from get_images # === return_all_images_from
-
   # ========================================================================= #
   # === display_simple_clock
   #
@@ -7335,46 +7278,6 @@ function simple_clock_timer() {
        alias drag_drop           javascript_drag_and_drop # === drag_drop
        alias enable_drag_for     javascript_drag_and_drop # === enable_drag_for
 
-  # ========================================================================= #
-  # === dynamic_text_shadow
-  #
-  # This method can be used to generate a dynamic text shadow.
-  # ========================================================================= #
-  def dynamic_text_shadow(
-      optional_hash = {
-        padding_to_use: '5vmin',
-        background_hsl: 'hsl(200 50% 50%)'
-      }
-    )
-    _ = optional_hash
-    if _.has_key? :padding
-      padding_to_use = _[:padding].to_s
-    elsif _.has_key? :padding_to_use
-      padding_to_use = _[:padding_to_use].to_s
-    end
-    if _.has_key? :background_hsl
-      background_hsl = _[:background_hsl].to_s
-    else # else use a default
-      background_hsl = 'hsl(200 50% 50%)'
-    end
-    # ======================================================================= #
-    # Next add these to the main CSS rules:
-    # ======================================================================= #
-    return '
-    .dynamic_text_shadow {
-      /* larger font size, more shadow distance  */
-      text-shadow: .1em .1em 0 hsl(200 50% 30%);
-      block-size: 100%;
-      background: '+background_hsl+';
-      color:      hsl(200 50% 90%);
-      font-family: "Fugaz One", cursive;
-      min-block-size: 100%;
-      padding: '+padding_to_use+';
-      display: grid;
-    }'
-  end; alias return_dynamic_text_shadow dynamic_text_shadow # === return_dynamic_text_shadow
-       alias dynamic_header             dynamic_text_shadow # === dynamic_header
-
   # ========================================================================= #
   # === add_dynamic_text_shadow
   # ========================================================================= #
@@ -7419,13 +7322,6 @@ function simple_clock_timer() {
     addnl(Cyberweb.container_for_the_CSS_coffee_animation)
   end
 
-  # ========================================================================= #
-  # === done_image
-  # ========================================================================= #
-  def done_image
-    sg(:done, 'marr10px')
-  end
-
   # ========================================================================= #
   # === add_doctype_then_html_start_tag_then_head_tag_then_charset
   #
@@ -7818,63 +7714,6 @@ function simple_clock_timer() {
     enable_drag_for(_) if _
   end
 
-  # ========================================================================= #
-  # === register_this_id
-  # ========================================================================= #
-  def register_this_id(the_id = '')
-    if the_id and the_id.to_s.start_with?('drag')
-      drag_and_drop(the_id)
-    end
-    @internal_hash[:register_ids] << the_id
-    return the_id
-  end; alias register_id register_this_id # === register_id
-
-  # ========================================================================= #
-  # === header
-  #
-  # This is a variant for h1() essentially.
-  # ========================================================================= #
-  def header(
-      i                   = '',
-      optional_css_class  = '',
-      optional_the_id     = '',
-      optional_css_style  = '',
-      optional_javascript = ''
-    )
-    if optional_the_id.empty?
-      optional_the_id = i.tr(' ','_')
-    end
-    h1(
-      i,
-      optional_css_class,
-      optional_the_id,
-      optional_css_style,
-      optional_javascript
-    )
-    @internal_hash[:register_ids] << optional_the_id
-  end
-
-  # ========================================================================= #
-  # === draggable_string_image
-  # ========================================================================= #
-  def draggable_string_image(
-      url       = '',
-      css_class = '', 
-      the_id    = '',
-      css_style = '',
-      alt_text  = '',
-      &block
-    )
-    if the_id and the_id.empty?
-      the_id = 'drag_'+File.basename(url).downcase.delete_suffix(File.extname(url))
-    end
-    if the_id and !the_id.empty? and !the_id.start_with?('drag_')
-      the_id = the_id.dup
-      the_id.prepend('drag_')
-    end
-    string_img(url, css_class, the_id, css_style, alt_text) { :draggable_attribute }
-  end
-
   # ========================================================================= #
   # === add_dragula_drag_for
   #
@@ -8018,39 +7857,6 @@ function simple_clock_timer() {
     end
   end
 
-  # ========================================================================= #
-  # === a                                                   (a tag, link tag)
-  #
-  # This method essentially refers to the <a> tag.
-  #
-  # If the first input argument is a Symbol then we will tap into
-  # BeautifulUrl,via Cyberweb.beautiful_url().
-  # ========================================================================= #
-  def a(
-      i           = '',
-      option_hash = {}
-    )
-    if i.is_a? Symbol
-      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
-    addn(
-      string_link(i, option_hash)
-    )
-  end; alias link        a # === a
-       alias link_to     a # === link_to
-       alias alink       a # === alink
-       alias remote_link a # === remote_link
-
   # ========================================================================= #
   # === set_font_size
   #
@@ -8072,7 +7878,7 @@ function simple_clock_timer() {
     # Remove leading 'FS' strings - at the least this is the main rationale
     # for the following .sub!() method call.
     # ======================================================================= #
-    this_font_size.sub!(/FS/,'') if this_font_size.include? 'FS'
+    this_font_size.sub!(/FS/,'')  if this_font_size.include? 'FS'
     this_font_size.gsub!(/_/,'.') if this_font_size.include? '_'
     case this_font_size
     # ======================================================================= #
@@ -8672,23 +8478,6 @@ function simple_clock_timer() {
     return _.do_serve
   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
-
   # ========================================================================= #
   # === Cyberweb::WebObject[]
   # ========================================================================= #
@@ -8993,4 +8782,17 @@ def self.css_rules_for_the_coffee_animation
 '
 end
 
+# =========================================================================== #
+# === Cyberweb.evaluate_from_the_same_named_file_then_serve
+# =========================================================================== #
+def self.evaluate_from_the_same_named_file_then_serve(
+    output_the_result              = :default,
+    optional_use_this_name_instead = nil
+  )
+  return ::Cyberweb::WebObject.evaluate_from_the_same_named_file_then_serve(
+    output_the_result,
+    optional_use_this_name_instead
+  )
+end
+  
 end