cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/cascading_style_sheets/text_shadow.css

@@ -17,3 +17,24 @@
 .shadow5 {
   text-shadow: 5px 5px 5px #ddccb5;
 }
+
+.shadow6 {
+  text-shadow: 2px 2px 2px #CCCCCC;
+}
+
+/*
+ * Inset shadows create a more deeply "embedded" effect.
+ */
+.inset_shadow1 {
+  text-shadow: 0 1px 0 #FFFFFF;
+}
+
+/*
+ * Add 1 px black "border" around each character.
+ */
+.black_border_around_each_character {
+  text-shadow: 1px 0 0 #000,
+               0 -1px 0 #000,
+               0 1px 0 #000,
+               -1px 0 0 #000;
+}

data/lib/cyberweb/cgi/constants.rb

@@ -6,8 +6,7 @@ module Cyberweb
 
 class CGI # === Cyberweb::CGI
 
-  require 'cyberweb/constants/standalone_constants.rb'
-  require 'cyberweb/constants/http_status_codes.rb'
+  require 'cyberweb/constants/constants.rb'
 
   # ========================================================================= #
   # === Cyberweb::CGI::ARRAY_PREDEFINED_CGI_ENV_VARIABLES

data/lib/cyberweb/cgi/exceptions.rb

@@ -7,7 +7,7 @@
 module Cyberweb
 
   require 'cyberweb/configuration/load_the_configuration_file.rb'
-  require 'cyberweb/constants/standalone_constants.rb'
+  require 'cyberweb/constants/constants.rb'
   require 'cyberweb/toplevel_methods/escape_html.rb'
   require 'cyberweb/toplevel_methods/spacer.rb'
 

data/lib/cyberweb/coloured_tags/coloured_tags.rb

@@ -2,7 +2,7 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# Automatically generated at 24.05.2021 from the file
+# Automatically generated at 02.05.2022 from the file
 # create_coloured_tags.rb
 # =========================================================================== #
 # require 'cyberweb/coloured_tags/coloured_tags.rb'

data/lib/cyberweb/colours/colour_chart.rb

@@ -2,14 +2,19 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# Require the html_colours, as the method all_colours() needs it.
-# =========================================================================== #
 # require 'cyberweb/colours/colour_chart.rb'
 # =========================================================================== #
 module Cyberweb
 
-  require 'cyberweb/html_tags/span.rb'
+  # ========================================================================= #
+  # === colour_chart
+  # ========================================================================= #
+  def colour_chart(i)
+    ::Cyberweb.colour_chart(i)
+  end; alias colour_table colour_chart # === colour_table
+       alias ct           colour_chart # === ct
 
+  require 'cyberweb/colours/colours.rb'
   # ========================================================================= #
   # === Cyberweb.colour_chart         (colour code chart, ct tag, cs tag .cs,
   #                                    colour tag, col tag color tag)
@@ -33,6 +38,8 @@ module Cyberweb
   def self.colour_chart(
       background_colour = '000000'
     )
+    require 'cyberweb/html_tags/div.rb'
+    require 'cyberweb/html_tags/span.rb:'
     result = ''.dup
     use_div = false
     use_this_css_style = ''
@@ -61,57 +68,4 @@ module Cyberweb
   end; self.instance_eval { alias colour_table colour_chart } # === Cyberweb.colour_table
        self.instance_eval { alias ct           colour_chart } # === Cyberweb.ct
 
-  # ========================================================================= #
-  # === Cyberweb.show_html_colour_chart
-  #
-  # Take note that this method is significantly more sophisticated than
-  # the older method called Cyberweb.colour_chart; it also has a slightly
-  # different use case. The method here is ready-for-use, that is,
-  # for display in a webpage.
-  # ========================================================================= #
-  def self.show_html_colour_chart(
-      use_this_css_style = 'margin-left: 2.5em; margin-right: 2.5em;'\
-                           'padding-left: 1.5em; padding-right: 1.5em',
-      width_of_the_box   = '75px',
-      height_of_the_box  = '35px'
-    )
-    p('','',use_this_css_style){
-      ee '<table style="margin-left: 0.75em; margin-right: 0.75em;">'
-      Colours.html_colours.each {|this_html_colour|
-        ee '<tr>'
-        ee '<td>'
-        ee '<div class="marl2em bblack1 pad4px mar2px" style="width:'+
-           width_of_the_box+'; height:'+height_of_the_box+'; background-color: '+this_html_colour+'">'
-        ee '</div>'
-        ee '</td>'
-        ee '<td>'
-        ee '<b>'+this_html_colour+'</b>'
-        ee '</td>'
-        ee '<td><b>Hex value</b>: <b>'
-        ee Colours.html_colour_to_hex_value(this_html_colour)
-        ee '</b></td>'
-        ee '<td>'
-        # ===================================================================== #
-        # Next we will also show the RGB value.
-        # ===================================================================== #
-        ee '<b>RGB value</b>: <b>'+
-           Colours.html_colour_to_rgb_value(this_html_colour).
-           tr(';',',')+'
-           </b>'
-        ee '</td>'
-        ee '</tr>'
-        ee "\n"
-      }
-      c :table
-    }
-  end
-
-  # ========================================================================= #
-  # === colour_chart
-  # ========================================================================= #
-  def colour_chart(i)
-    ::Cyberweb.colour_chart(i)
-  end; alias colour_table colour_chart # === colour_table
-       alias ct           colour_chart # === ct
-
 end

data/lib/cyberweb/colours/colours.rb

@@ -2,8 +2,6 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# Require the html_colours, as the method all_colours() needs it.
-# =========================================================================== #
 # require 'cyberweb/colours/colours.rb'
 # =========================================================================== #
 module Cyberweb
@@ -12,8 +10,7 @@ module Cyberweb
     require 'colours'
   rescue LoadError; end
 
-  require 'cyberweb/colours/colour_chart.rb'
-  require 'cyberweb/colours/random_colour.rb'
+  require 'cyberweb/constants/constants.rb'
 
   # ========================================================================= #
   # === Cyberweb.show_all_colours
@@ -38,6 +35,154 @@ module Cyberweb
     end
   end; self.instance_eval { alias colours? show_all_colours } # === Cyberweb.colours?
 
+  # ========================================================================= #
+  # === Cyberweb.all_colours
+  #
+  # This will return all available colours. We make use of project
+  # HtmlColours for this.
+  # ========================================================================= #
+  def self.all_colours
+    Colours.html_colours
+  end; self.instance_eval { alias all_html_colours all_colours } # === Cyberweb.all_html_colours
+
+  # ========================================================================= #
+  # === Cyberweb.return_random_colour
+  #
+  # This method will return a String such as "mediumslateblue".
+  # ========================================================================= #
+  def self.return_random_colour
+    all_colours.sample
+  end; self.instance_eval { alias random_colour? return_random_colour } # === Cyberweb.random_colour?
+
+  # ========================================================================= #
+  # === Cyberweb.sanitize_for_colours
+  #
+  # This method can be used to scan a string for the keyword RAND or
+  # other similar keywords. If such a keyword is found, it will be
+  # replaced with the proper colour(s). RANDOM_COLOUR would thus
+  # become a real, random colour.
+  #
+  # This method here is called from return_css_style().
+  #
+  # It will also check for the keyword BACKGROUND.
+  # ========================================================================= #
+  def self.sanitize_for_colours(
+      i = ''
+    )
+    i = i.to_s.dup # Dup so that we don't work on a frozen string.
+    # ======================================================================= #
+    # === RANDOM_COLOUR
+    # ======================================================================= #
+    if i.include? 'RANDOM_COLOUR'
+      i.gsub!(/RANDOM_COLOUR/, return_random_colour)
+    end
+    # ======================================================================= #
+    # Handle macro entries for BACKGROUND next:
+    #   background: url(images/menu7.gif)
+    #   BACKGROUND: BG_COLOURBAR_LIGHT.jpg
+    # ======================================================================= #
+    if i.include? 'BACKGROUND'
+      i.gsub!(/BACKGROUND: (\w+\.\w+)/, 
+        'background: url(../../../../../images/WALLPAPERS/\1); 
+         background-repeat: no-repeat;')
+    end
+    i.gsub!(/RBORDER1/,  return_random_border ) if i.include? 'RBORDER1'
+    i.gsub!(/RBORDER/,   return_random_border ) if i.include? 'RBORDER1'
+    # ======================================================================= #
+    # If the following input includes at least the substring 'RCOL'.
+    # ======================================================================= #
+    if i.include? 'RCOL'
+      i.gsub!(/RCOLOUR/, return_random_colour )
+      i.gsub!(/RCOL/,    return_random_colour )
+    end
+    # ======================================================================= #
+    # Cut off UPCASED PX. From this point no PX is possible within
+    # the string. This may fail for images that have PX as part of
+    # their name though, hence why this check is a bit more complicated.
+    # ======================================================================= #
+    if i.include? 'PX'
+      unless i.include?('.png') or i.include?('.jpg')
+        i.gsub!(/PX/,'')
+      end
+    end
+    if i.include? 'RAND'
+      i.gsub!(/RANDOM/,'RAND') # exchange RANDOM with RAND
+      i.gsub!(/BORDER_RAND/,'RAND_BORDER') # want proper names
+      i.gsub!(/RAND/,                return_random_colour )
+      # ======================================================================= #
+      # From this point forward, we invoke the method return_random_colour()
+      # RAND_BORDER_1 means "create a random border here" with 1 px
+      # ======================================================================= #
+      i.gsub!(/RAND_BORDER_(.+)/,    return_random_border('\\1') )
+      # ======================================================================= #
+      # Create: border-left: 1 px RANDOM_COLOUR
+      # ======================================================================= #
+      i.gsub!(/BORD_LEFT_RAND_(.+)/, return_random_border('\\1') )
+      i.gsub!(/RAND_BORD_(.+)/,      return_random_border('\\1') )
+      i.gsub!(/RAND_COLOUR/,         return_random_colour )
+    elsif i.include? 'BORD'
+      # ======================================================================= #
+      # As above but with shorter BORD_ notation.
+      # ======================================================================= #
+      i.gsub!(/BORD_(.+)PX/,
+        'border: \\1px '+ARRAY_CSS_BORDER_STYLES.sample(1).first+
+        ' '+return_random_colour+';')
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === sanitize_for_colours
+  # ========================================================================= #
+  def sanitize_for_colours(i = '')
+    ::Cyberweb.sanitize_for_colours(i)
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.show_html_colour_chart
+  #
+  # Take note that this method is significantly more sophisticated than
+  # the older method called Cyberweb.colour_chart; it also has a slightly
+  # different use case. The method here is ready-for-use, that is,
+  # for display in a webpage.
+  # ========================================================================= #
+  def self.show_html_colour_chart(
+      use_this_css_style = 'margin-left: 2.5em; margin-right: 2.5em;'\
+                           'padding-left: 1.5em; padding-right: 1.5em',
+      width_of_the_box   = '75px',
+      height_of_the_box  = '35px'
+    )
+    p('','',use_this_css_style){
+      ee '<table style="margin-left: 0.75em; margin-right: 0.75em;">'
+      Colours.html_colours.each {|this_html_colour|
+        ee '<tr>'
+        ee '<td>'
+        ee '<div class="marl2em bblack1 pad4px mar2px" style="width:'+
+           width_of_the_box+'; height:'+height_of_the_box+'; background-color: '+this_html_colour+'">'
+        ee '</div>'
+        ee '</td>'
+        ee '<td>'
+        ee '<b>'+this_html_colour+'</b>'
+        ee '</td>'
+        ee '<td><b>Hex value</b>: <b>'
+        ee Colours.html_colour_to_hex_value(this_html_colour)
+        ee '</b></td>'
+        ee '<td>'
+        # ===================================================================== #
+        # Next we will also show the RGB value.
+        # ===================================================================== #
+        ee '<b>RGB value</b>: <b>'+
+           Colours.html_colour_to_rgb_value(this_html_colour).
+           tr(';',',')+'
+           </b>'
+        ee '</td>'
+        ee '</tr>'
+        ee "\n"
+      }
+      ctable
+    }
+  end
+
 end
 
 if __FILE__ == $PROGRAM_NAME

data/lib/cyberweb/commandline/commandline_interface.rb

@@ -9,7 +9,6 @@
 # =========================================================================== #
 module Cyberweb
 
-  require 'cyberweb/utility_scripts/download_balloon_css.rb'
   require 'cyberweb/toplevel_methods/edit_configuration_file.rb'
 
   # ========================================================================= #
@@ -21,23 +20,29 @@ module Cyberweb
     else
       case i
       # ===================================================================== #
+      # === cyberweb --download-balloon
+      # ===================================================================== #
+      when /^-?-?download(-|_)?balloon$/
+        require 'cyberweb/utility_scripts/download_balloon_css.rb'
+        ::Cyberweb::DownloadBalloonCss.new
+      # ===================================================================== #
       # === cyberweb --systemsettings
+      #
+      # This entry point will generate the system-settings for the
+      # cyberweb project.
       # ===================================================================== #
       when /^-?-?systemsettings$/
          require 'roebe/classes/generate_system_values.rb'
          Roebe::GenerateSystemValues.new
-        exit
+         exit
       # ===================================================================== #
       # === cyberweb --edit
       # ===================================================================== #
-      when 'EDIT',/^-?-?edit/,'ed','bearbeite','e' # Allow user the edit the configuration file.
+      when 'EDIT',
+           /^-?-?edit$/i,
+           'ed','bearbeite','e' # Allow user the edit the configuration file.
         ::Cyberweb.edit_configuration_file # Invoke this via: 'cyberweb edit'
         exit
-      # ===================================================================== #
-      # === cyberweb --download-balloon
-      # ===================================================================== #
-      when /^-?-?download(-|_)?balloon$/
-        ::Cyberweb::DownloadBalloonCss.new
       end
     end
   end

data/lib/cyberweb/configuration/load_the_configuration_file.rb

@@ -10,7 +10,7 @@
 module Cyberweb
 
   require 'yaml'
-  require 'cyberweb/constants/configuration_file.rb'
+  require 'cyberweb/constants/constants.rb'
   require 'cyberweb/configuration/configuration.rb'
   require 'cyberweb/images/path_to_images.rb' # Because we set the path to images here.