cyberweb 0.5.225 → 0.6.17

data/lib/cyberweb/toplevel_methods/temp_directory.rb

@@ -38,7 +38,9 @@ module Cyberweb
     # ======================================================================= #
     when :default
       if is_on_roebe?
-        i = '/home/Temp/'
+        i = '/home/x/Temp/'
+        # i = '/home/Temp/'
+        # i = '/tmp/'
       else
         i = '/tmp/' # This should be the default for most Linux variants.
       end

data/lib/cyberweb/version/version.rb

@@ -9,12 +9,12 @@ module Cyberweb
   # ========================================================================= #
   # === VERSION
   # ========================================================================= #
-  VERSION = '0.5.225'
+  VERSION = '0.6.17'
 
   # ========================================================================= #
   # === LAST_UPDATE
   # ========================================================================= #
-  LAST_UPDATE = '17.10.2022'
+  LAST_UPDATE = '01.11.2022'
 
   # ========================================================================= #
   # === URL_TO_THE_DOCUMENTATION

data/lib/cyberweb/web_images/map_symbol_to_image_location.rb

@@ -819,7 +819,9 @@ module WebImages
     # ======================================================================= #
     when :maxerl
       _ = "#{IMG_DIR}MAXERL.png"
+    # ======================================================================= #
     # === :message_box_error
+    # ======================================================================= #
     when :message_box_error
       _ = "#{IMG_DIR}MESSAGE_BOX_ERROR.png"
     # ======================================================================= #
@@ -959,6 +961,9 @@ module WebImages
     # ======================================================================= #
     when :note_3, :note3, :noten_3, :noten3
       _ = 'AUDIO/NOTEN_03.png'
+    # ======================================================================= #
+    # === :note_4
+    # ======================================================================= #
     when :note_4, :note4, :noten_4, :noten4
       _ = 'AUDIO/NOTEN_04.png'
     # ======================================================================= #
@@ -1033,6 +1038,9 @@ module WebImages
     # ======================================================================= #
     when :pfeil8
       _ = "#{IMG_DIR}PFEIL8_OUT.png"
+    # ======================================================================= #
+    # === :pfeil9
+    # ======================================================================= #
     when :pfeil9
       _ = "#{IMG_DIR}PFEIL9.png"
     when :pfeil10, :pfeil_rechts, :pfeilrechts
@@ -1405,8 +1413,14 @@ module WebImages
     # ======================================================================= #
     when :star_fancy
       _ = "#{IMG_DIR}STAR_FANCY.png"
+    # ======================================================================= #
+    # === :sword
+    # ======================================================================= #
     when :sword
       _ = 'RPG/WEAPONS/SWORD03.png'
+    # ======================================================================= #
+    # === :in_progress
+    # ======================================================================= #
     when :in_progress
       _ = "#{IMG_DIR}STATUS_IN_PROGRESS.png"
     # ======================================================================= #
@@ -1419,6 +1433,9 @@ module WebImages
     # ======================================================================= #
     when :one_and_half_star
       _ = "#{IMG_DIR}EVAL/1x_STAR.png"
+    # ======================================================================= #
+    # === :two_star
+    # ======================================================================= #
     when :two_star, :two_stars
       _ = "#{IMG_DIR}EVAL/02_STAR.png"
     # ======================================================================= #
@@ -1426,12 +1443,24 @@ module WebImages
     # ======================================================================= #
     when :two_and_half_star
       _ = "#{IMG_DIR}EVAL/2x_STAR.png"
+    # ======================================================================= #
+    # === :three_star
+    # ======================================================================= #
     when :three_star, :three_stars
       _ = "#{IMG_DIR}EVAL/03_STAR.png"
+    # ======================================================================= #
+    # === :three_and_half_star
+    # ======================================================================= #
     when :three_and_half_star
       _ = "#{IMG_DIR}EVAL/3x_STAR.png"
+    # ======================================================================= #
+    # === :four_star
+    # ======================================================================= #
     when :four_star, :four_stars
       _ = "#{IMG_DIR}EVAL/04_STAR.png"
+    # ======================================================================= #
+    # === :four_and_half_star
+    # ======================================================================= #
     when :four_and_half_star
       _ = "#{IMG_DIR}EVAL/4x_STAR.png"
     when :five_star, :five_stars
@@ -1449,6 +1478,9 @@ module WebImages
     # ======================================================================= #
     when :teufelchen
       _ = "#{IMG_DIR}TEUFELCHEN.png"
+    # ======================================================================= #
+    # === :thinking_human
+    # ======================================================================= #
     when :thinking_human
       _ = "#{IMG_DIR}THINKING_HUMAN.png"
     # ======================================================================= #
@@ -1533,6 +1565,9 @@ module WebImages
     # ======================================================================= #
     when :wings
       _ = "#{IMG_DIR}WINGS.png"
+    # ======================================================================= #
+    # === :word
+    # ======================================================================= #
     when :word
       _ = "#{IMG_DIR}WORD.png"
     # ======================================================================= #
@@ -1707,11 +1742,12 @@ end
 end
 
 if __FILE__ == $PROGRAM_NAME
-  puts Cyberweb::WebImages.map_symbol_to_image_location(ARGV)
-  puts Cyberweb.get_webimage(:big_star) # -> /home/Programs/Ruby/2.7.1/lib/ruby/site_ruby/2.7.0/web_object/images/real/BIG_STAR.png
-  puts Cyberweb::WebImages.is_included?(:admin) # => true
-  puts Cyberweb::WebImages[:austria]
-  puts Cyberweb::WebImages.random
-  puts Cyberweb::WebImages.mapper(:phone)
-  puts Cyberweb::WebImages.mapper(:phone) { :prepend_the_image_base_directory }
+  alias e puts
+  e Cyberweb::WebImages.map_symbol_to_image_location(ARGV)
+  e Cyberweb.get_webimage(:big_star) # -> /home/Programs/Ruby/2.7.1/lib/ruby/site_ruby/2.7.0/web_object/images/real/BIG_STAR.png
+  e Cyberweb::WebImages.is_included?(:admin) # => true
+  e Cyberweb::WebImages[:austria]
+  e Cyberweb::WebImages.random
+  e Cyberweb::WebImages.mapper(:phone)
+  e Cyberweb::WebImages.mapper(:phone) { :prepend_the_image_base_directory }
 end

data/lib/cyberweb/web_object/favicon.rb

@@ -10,6 +10,8 @@ module Cyberweb
 
 class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
 
+  require 'cyberweb/modules/favicon.rb'
+
   # ========================================================================= #
   # === set_favicon
   #
@@ -34,112 +36,8 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
   def set_favicon(
       i = 'RPG/RPG_FAVICON.png'
     )
-    if i.is_a? Symbol
-      case i # case tag
-      # ======================================================================= #
-      # === :rpg_favicon
-      # ======================================================================= #
-      when :rpg_favicon,
-           :rpg
-        i = 'RPG/RPG_FAVICON.png'
-      # ======================================================================= #
-      # === :wlan_favicon
-      # ======================================================================= #
-      when :wlan_favicon,
-           :wlan
-        i = 'science/funk/WLAN_FAVICON.png'
-      # ======================================================================= #
-      # === :package
-      # ======================================================================= #
-      when :package
-        i = 'STD/DOWNLOAD_PACKAGE.png'
-      # ======================================================================= #
-      # === :dnd_favicon
-      # ======================================================================= #
-      when :dnd_favicon,
-           :dnd_favicons,
-           :dnd
-        i = 'RPG/DnD/DnD_FAVICON.png'
-      # ======================================================================= #
-      # === :ruby_favicon
-      # ======================================================================= #
-      when :ruby_favicon
-        i = 'programming/ruby/RUBY_FAVICON.png'
-      # ======================================================================= #
-      # === :linux_favicon
-      # ======================================================================= #
-      when :linux_favicon
-        i = 'linux/LINUX_FAVICON.png'
-      # ======================================================================= #
-      # === :sitemap_favicon
-      # ======================================================================= #
-      when :sitemap_favicon
-        i = 'SITEMAP/SITEMAP_FAVICON.png'
-      # ======================================================================= #
-      # === :science_favicon
-      # ======================================================================= #
-      when :science_favicon
-        i = 'science/SCIENCE_FAVICON.png'
-      # ======================================================================= #
-      # === :bioroebe_favicon
-      # ======================================================================= #
-      when :bioroebe_favicon
-        i = 'bioroebe/images/BIOROEBE.png'
-      # ======================================================================= #
-      # === :dsa
-      # ======================================================================= #
-      when :dsa,
-           :dsa_favicon
-        i = 'RPG/DSA/DSA_FAVICON.png'
-      # ======================================================================= #
-      # === :shadowrun_favicon
-      # ======================================================================= #
-      when :shadowrun_favicon,
-           :shadowrun
-        i = 'RPG/SR/SHADOWRUN_FAVICON.png'
-      # ======================================================================= #
-      # === :default
-      # ======================================================================= #
-      when :default
-        i = 'STD/ZITRONE.png'
-      # ======================================================================= #
-      # === :tai_favicon
-      # ======================================================================= #
-      when :tai_favicon
-        i = 'RPG/SARLEM/OSTREICH/TAI/TAI_FAVICON.png'
-      # ======================================================================= #
-      # === :sarlem
-      # ======================================================================= #
-      when :sarlem,
-           :sarlem_favicon
-        i = 'RPG/SARLEM/SARLEM_FAVICON.png'
-      # ======================================================================= #
-      # === :random
-      # ======================================================================= #
-      when :random,
-           :rand
-        i = random_favicon
-      # ======================================================================= #
-      # === :inline
-      #
-      # Add support for "inline" favicons" which are ... no favicons really.
-      #
-      # URLs prefixed with the "data:" scheme allow content creators to
-      # embed small files inline in documents.
-      # ======================================================================= #
-      when :inline,
-           :minimal,
-           :none
-        i = "<link href=data:, rel=icon>#{NL}"
-      else
-        # ===================================================================== #
-        # We assume this symbol to be part of WebImage. This will
-        # handle input such as :big_star, for example.
-        # ===================================================================== #
-        i = ::Cyberweb.get_webimage(i)
-      end
-    end
-    i = return_path_to_the_images_directory+i.to_s
+    i = ::Cyberweb::Favicon.path_of?(i)
+    i = "#{return_path_to_the_images_directory}#{i}"
     add_with_newline(
       return_favicon_string(i)
     )

data/lib/cyberweb/web_object/html_tags.rb

@@ -14,6 +14,120 @@ module Cyberweb
 
 class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
 
+  # ========================================================================= #
+  # === div                                                         (div tag)
+  #
+  # Input to this method can be in this format:
+  #
+  #   div(id: 'drag_div_sitemap_table', css_style: 'z-index: 1') {
+  #
+  # So the first argument can be a Hash.
+  # ========================================================================= #
+  def div(
+      optional_css_class  = '',
+      optional_the_id     = '',
+      optional_css_style  = '',
+      optional_javascript = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes first
+    # ======================================================================= #
+    if optional_css_class.is_a? Hash
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if optional_css_class.has_key? :css_style
+        optional_css_style = optional_css_class.delete(:css_style)
+      end
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if optional_css_class.has_key? :id
+        optional_the_id = optional_css_class.delete(:id)
+      end
+      # ===================================================================== #
+      # === :css_class
+      # ===================================================================== #
+      if optional_css_class.has_key? :css_class
+        optional_css_class = optional_css_class.delete(:css_class)
+      # ===================================================================== #
+      # === :class
+      # ===================================================================== #
+      elsif optional_css_class.has_key? :class
+        optional_css_class = optional_css_class.delete(:class)
+      end
+      if optional_css_class.is_a? Hash
+        optional_css_class = ''
+      end
+    end
+    # ======================================================================= #
+    # We need to delegate to a toplevel method, in order to create
+    # the correct <div> tag.
+    # ======================================================================= #
+    add_this_div(
+      optional_css_class,
+      optional_the_id,
+      optional_css_style,
+      optional_javascript
+    )
+    # ======================================================================= #
+    # === Handle blocks given to <div> next
+    # ======================================================================= #
+    if block_given?
+      yield
+      cdiv
+    end
+  end
+
+  # ========================================================================= #
+  # === pre                                                         (pre tag)
+  #
+  # This method will ultimately generate a <pre> tag.
+  #
+  # The alias called "numbered_table" may be subject to change. One day
+  # it may be a new method that can then be used to number a list of
+  # entries passed as String or Array. For now, though, as of October
+  # 2022 it is just an alias.
+  # ========================================================================= #
+  def pre(
+      i                  = '',
+      optional_css_class = 'FS1_5em',
+      optional_the_id    = '',
+      optional_css_style = '',
+      optional_commands  = nil,
+      &block
+    )
+    if optional_commands
+      case optional_commands
+      # ===================================================================== #
+      # === :remove_html
+      # ===================================================================== #
+      when :remove_html
+        i = Cyberweb.remove_html(i)
+      end
+    end
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield.to_s
+      if yielded and !yielded.empty?
+        i = i.to_s.dup
+        i << yielded
+      end
+    end
+    addn(
+      '<pre'+
+      css_class_or_no_class(optional_css_class)+
+      id_or_no_id(optional_the_id)+
+      css_style_or_no_style(optional_css_style)+
+      '>'+
+      i.to_s+
+      '</pre>'
+    )
+  end; alias numbered_table pre # === numbered_table
+
   # ========================================================================= #
   # === button                                                   (button tag)
   #
@@ -643,6 +757,25 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
     end
   end
 
+  # ========================================================================= #
+  # === add_this_div
+  # ========================================================================= #
+  def add_this_div(
+      optional_css_class  = '',
+      optional_the_id     = '',
+      optional_css_style  = '',
+      optional_javascript = ''
+    )
+    addnl(
+      Cyberweb.string_div(
+        optional_css_class,
+        optional_the_id,
+        optional_css_style,
+        optional_javascript
+      )
+    )
+  end
+
   # ========================================================================= #
   # === ul                                                           (ul tag)
   #
@@ -1116,71 +1249,6 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
     add(_)
   end
 
-  # ========================================================================= #
-  # === div                                                         (div tag)
-  #
-  # Input to this method can be in this format:
-  #
-  #   div(id: 'drag_div_sitemap_table', css_style: 'z-index: 1') {
-  #
-  # So the first argument can be a Hash.
-  # ========================================================================= #
-  def div(
-      optional_css_class  = '',
-      optional_the_id     = '',
-      optional_css_style  = '',
-      optional_javascript = '',
-      &block
-    )
-    if optional_css_class.is_a? Hash
-      # ===================================================================== #
-      # === :css_style
-      # ===================================================================== #
-      if optional_css_class.has_key? :css_style
-        optional_css_style = optional_css_class.delete(:css_style)
-      end
-      # ===================================================================== #
-      # === :id
-      # ===================================================================== #
-      if optional_css_class.has_key? :id
-        optional_the_id = optional_css_class.delete(:id)
-      end
-      # ===================================================================== #
-      # === :css_class
-      # ===================================================================== #
-      if optional_css_class.has_key? :css_class
-        optional_css_class = optional_css_class.delete(:css_class)
-      # ===================================================================== #
-      # === :class
-      # ===================================================================== #
-      elsif optional_css_class.has_key? :class
-        optional_css_class = optional_css_class.delete(:class)
-      end
-      if optional_css_class.is_a? Hash
-        optional_css_class = ''
-      end
-    end
-    # ======================================================================= #
-    # We need to delegate to a toplevel method, in order to create
-    # the correct <div> tag.
-    # ======================================================================= # 
-    addnl(
-      Cyberweb.string_div(
-        optional_css_class,
-        optional_the_id,
-        optional_css_style,
-        optional_javascript
-      )
-    )
-    # ======================================================================= #
-    # === Handle blocks given to <div> next
-    # ======================================================================= #
-    if block_given?
-      yield
-      cdiv
-    end
-  end
-
   # ========================================================================= #
   # === li                                                           (li tag)
   #

data/lib/cyberweb/web_object/images.rb

@@ -10,26 +10,6 @@ module Cyberweb
 
 class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
 
-  # ========================================================================= #
-  # === return_path_to_the_images_directory
-  # ========================================================================= #
-  def return_path_to_the_images_directory(
-      path_to_use = relative_path?
-    )
-    return "#{path_to_use}data/"\
-           "#{return_name_of_the_images_directory}/"
-  end
-
-  # ========================================================================= #
-  # === images_css
-  #
-  # This method allows the user to set the same CSS rules for all
-  # images used on a given WebObject.
-  # ========================================================================= #
-  def images_css(i)
-    @internal_hash[:global_CSS_rules_for_all_images] = i
-  end
-
   # ========================================================================= #
   # === draggable_image
   #
@@ -71,6 +51,26 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
        alias dimg          draggable_image # === dimg
        alias dimage        draggable_image # === dimage
 
+  # ========================================================================= #
+  # === return_path_to_the_images_directory
+  # ========================================================================= #
+  def return_path_to_the_images_directory(
+      path_to_use = relative_path?
+    )
+    return "#{path_to_use}data/"\
+           "#{return_name_of_the_images_directory}/"
+  end
+
+  # ========================================================================= #
+  # === images_css
+  #
+  # This method allows the user to set the same CSS rules for all
+  # images used on a given WebObject.
+  # ========================================================================= #
+  def images_css(i)
+    @internal_hash[:global_CSS_rules_for_all_images] = i
+  end
+
   # ========================================================================= #
   # === img_nbr
   #

data/lib/cyberweb/web_object/javascript_and_jquery.rb

@@ -159,22 +159,6 @@ EOF
        alias report_use_jquery?                                do_we_use_jquery? # === report_use_jquery?
        alias jquery_is_used?                                   do_we_use_jquery? # === jquery_is_used?
 
-  # ========================================================================= #
-  # === do_use_jquery
-  #
-  # Use this method to enable jquery support.
-  #
-  # I recommend to use this method, rather than use_jquery, but if
-  # you want to be lazy, feel free to use either variant. I just
-  # think that the explicit "do_" implies an action, which I
-  # think is more logical.
-  # ========================================================================= #
-  def do_use_jquery
-    @config['use_jquery'] = true # Do a batch-assignment here.
-  end; alias use_jquery    do_use_jquery # === use_jquery
-       alias enable_drag   do_use_jquery # === enable_drag
-       alias enable_jquery do_use_jquery # === enable_jquery
-
   # ========================================================================= #
   # === jquery_resizable_via_the_mouse
   #
@@ -322,4 +306,43 @@ EOF
     )
   end
 
+  # ========================================================================= #
+  # === enable_drag_all_images
+  #
+  # We enable a configuration option through this method call here.
+  #
+  # Note that we will also automatically enable jquery in this case,
+  # as otherwise we could not drag the image in question around,
+  # which would sort of defeat the points of having this method
+  # in the first place - or it would require of you to manually
+  # enable jquery, which seems superfluous.
+  # ========================================================================= #
+  def enable_drag_all_images
+    do_use_jquery unless use_jquery?
+    @config['drag_all_images'] = true
+  end; alias drag_all_images              enable_drag_all_images # === drag_all_images
+       alias drag_everything              enable_drag_all_images # === drag_everything
+       alias do_drag_all_images           enable_drag_all_images # === do_drag_all_image
+       alias do_enable_drag_all_images    enable_drag_all_images # === do_enable_drag_all_image
+       alias drag_everything              enable_drag_all_images # === drag_everything
+       alias all_images_will_be_draggable enable_drag_all_images # === all_images_will_be_draggable
+       alias enable_dragging              enable_drag_all_images # === enable_dragging
+       alias enable_drag_and_drop         enable_drag_all_images # === enable_drag_and_drop
+
+  # ========================================================================= #
+  # === do_use_jquery
+  #
+  # Use this method to enable jquery support.
+  #
+  # I recommend to use this method, rather than use_jquery, but if
+  # you want to be lazy, feel free to use either variant. I just
+  # think that the explicit "do_" implies an action, which I
+  # think is more logical.
+  # ========================================================================= #
+  def do_use_jquery
+    @config['use_jquery'] = true # Do a batch-assignment here.
+  end; alias use_jquery    do_use_jquery # === use_jquery
+       alias enable_drag   do_use_jquery # === enable_drag
+       alias enable_jquery do_use_jquery # === enable_jquery
+
 end; end

data/lib/cyberweb/web_object/link.rb

@@ -10,6 +10,24 @@ module Cyberweb
 
 class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
 
+  # ========================================================================= #
+  # === self_abr
+  #
+  # This method is similar to abr(), but it will automatically use
+  # content: :self as-is.
+  # ========================================================================= #
+  def self_abr(
+      remote_url,
+      optional_hash = {}
+    )
+    if optional_hash.is_a? String
+      optional_hash = {
+        content: optional_hash
+      }
+    end
+    abr(remote_url, optional_hash)
+  end; alias abr_self self_abr # ===  abr_self
+
   # ========================================================================= #
   # === pretty_link
   #
@@ -117,21 +135,6 @@ class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
     br
   end; alias abr linkbr # === abr
 
-  # ========================================================================= #
-  # === self_abr
-  #
-  # This method is similar to abr(), but it will automatically use
-  # content: :self as-is.
-  # ========================================================================= #
-  def self_abr(
-      remote_url,
-      optional_css_class = ''
-    )
-    abr remote_url,
-        content: :self,
-        css_class: optional_css_class
-  end; alias abr_self self_abr # ===  abr_self
-
   # ========================================================================= #
   # === roebe_internal_link
   #