cyberweb 0.5.225 → 0.6.17

data/lib/cyberweb/{favicon → modules}/favicon.rb

@@ -4,35 +4,30 @@
 # =========================================================================== #
 # === Cyberweb::Favicon
 #
-# This class can download remote favicons. OpenSSL is required for this
-# functionality if you connect to remote https hosts.
+# This module can download remote favicons. OpenSSL is required for this
+# functionality if you wish to connect to remote https hosts.
 #
-# The three optional dependencies for this class are on:
+# The three optional dependencies for this module are on:
 #
 #   → nokogiri
 #   → open-uri, and
 #   → addressable
 #
+# This is only relevant for the method Cyberweb::Favicon.download, though.
+#
+# The second primary use case for this module is via the method called
+# Cyberweb::Favicon.path_of?(). This functionality will also be used
+# for the HtmlTemplate class.
 # =========================================================================== #
-# require 'cyberweb/favicon/favicon.rb'
+# require 'cyberweb/modules/favicon.rb'
+# include Cyberweb::Favicon
 # =========================================================================== #
 module Cyberweb
 
-class Favicon # === Cyberweb::Favicon
+module Favicon # === Cyberweb::Favicon
 
   require 'cyberweb/constants/constants.rb'
-
-  begin
-    require 'nokogiri'
-  rescue LoadError; end
-
-  begin
-    require 'open-uri'
-  rescue LoadError; end
-
-  begin
-    require 'addressable/uri'
-  rescue LoadError; end
+  require 'cyberweb/web_images/map_symbol_to_image_location.rb'
 
   attr_accessor :data
 
@@ -43,6 +38,124 @@ class Favicon # === Cyberweb::Favicon
   class InvalidFavicon < Error; end
   class MissingFavicon < Error; end
 
+  # ========================================================================= #
+  # === Cyberweb::Favicon.path_of?
+  # ========================================================================= #
+  def self.path_of?(i)
+    if i.is_a? Array
+      i = i.first
+    end
+    # ======================================================================= #
+    # === Handle Symbols here
+    # ======================================================================= #
+    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
+    return i
+  end
+
   # ========================================================================= #
   # === url?
   # ========================================================================= #
@@ -66,6 +179,15 @@ class Favicon # === Cyberweb::Favicon
   # Nokogiri will search for any favicon in the remote URL.
   # ========================================================================= #
   def self.download(url)
+    begin
+      require 'open-uri'
+    rescue LoadError; end
+    begin
+      require 'nokogiri'
+    rescue LoadError; end
+    begin
+      require 'addressable/uri'
+    rescue LoadError; end
     uri = Addressable::URI.heuristic_parse(url)
     uri = Addressable::URI.encode(uri) # needed for chars with accents in url
     doc = Nokogiri::HTML(open(uri))
@@ -124,6 +246,24 @@ class Favicon # === Cyberweb::Favicon
 
 end
 
+# =========================================================================== #
+# === Cyberweb.create_random_cfdg_favicon
+#
+# This is a special method, should be used internally only! (cfdg tag)
+# =========================================================================== #
+def self.create_random_cfdg_favicon(
+    img_dir = '/home/x/programming/ruby/src/image_paradise/lib/image_paradise/'
+  )
+  print_html_header
+  directory_with_cfdg_images = img_dir+'cfdg/'
+  favicon_name = 'DEFAULT_FAVICON.png'
+  _ = 'CFDG/'+get_files_from(directory_with_cfdg_images).sample(1)[0]
+  string = 'cfdg '+img_dir+'/'+_+' -b 2 -w 48 -h 48 '+img_dir+'/'+favicon_name
+  # ee string+'<br>'
+  system("#{string} 2>&1")
+  return favicon_name
+end
+
 # =========================================================================== #
 # === Cyberweb.download_favicon
 #
@@ -176,22 +316,11 @@ def self.return_favicon(
   return _ # Return the result finally, as string.
 end
 
-# =========================================================================== #
-# === Cyberweb.create_random_cfdg_favicon
-#
-# This is a special method, should be used internally only! (cfdg tag)
-# =========================================================================== #
-def self.create_random_cfdg_favicon(
-    img_dir = '/home/x/programming/ruby/src/image_paradise/lib/image_paradise/'
-  )
-  print_html_header
-  directory_with_cfdg_images = img_dir+'cfdg/'
-  favicon_name = 'DEFAULT_FAVICON.png'
-  _ = 'CFDG/'+get_files_from(directory_with_cfdg_images).sample(1)[0]
-  string = 'cfdg '+img_dir+'/'+_+' -b 2 -w 48 -h 48 '+img_dir+'/'+favicon_name
-  # ee string+'<br>'
-  system("#{string} 2>&1")
-  return favicon_name
 end
 
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  # e Cyberweb::Favicon.path_of?(ARGV)
+  e Cyberweb::Favicon.path_of?(:ruby_favicon)
+  e Cyberweb::Favicon.path_of?(:backup_image)
 end

data/lib/cyberweb/requires/require_the_cyberweb_project.rb

@@ -47,7 +47,7 @@ require 'cyberweb/colours/colour_chart.rb' # This pulls in 'cyberweb/colours/col
 # =========================================================================== #
 # Load up favicon-related code next.
 # =========================================================================== #
-require 'cyberweb/favicon/favicon.rb'
+require 'cyberweb/modules/favicon.rb'
 
 # =========================================================================== #
 # Add encoding support:
@@ -150,4 +150,8 @@ Cyberweb.include_greek_letters # Include the greek letters here.
 
 require 'cyberweb/css_manager/css_manager.rb'
 
-require 'cyberweb/utility_scripts/images_to_html/images_to_html.rb'
+require 'cyberweb/utility_scripts/images_to_html/images_to_html.rb'
+
+# Include the SimpleForum as well:
+require 'cyberweb/cybersprawl/simple_forum/simple_forum.rb'
+ 

data/lib/cyberweb/toplevel_methods/download_webpage.rb

@@ -14,16 +14,30 @@ module Cyberweb
   # === Cyberweb.download_webpage
   #
   # The argument should be a remote website.
+  #
+  # Usage example:
+  #
+  #   Cyberweb.download_webpage('https://www.cardmarket.com/en/Magic/Orders/Sales/ShoppingCart')
+  #   x = Cyberweb.download_webpage('https://www.cardmarket.com/en/Magic/Orders/Sales/ShoppingCart', { http_basic_authentication: ['shev55y@inbox.ar', 'JJJieie33aeeeggkhlhgejk7878eKIEUIbeue'] })
+  #
   # ========================================================================= #
   def self.download_webpage(
-      remote_URL = ARGV
+      remote_URL = ARGV,
+      options    = {}
     )
     require 'cyberweb/coloured_tags/coloured_tags.rb'
     require 'open-uri'
     if remote_URL.is_a? Array
       remote_URL = remote_URL.first
     end
-    what = URI.open(remote_URL).read
+    if options and options.is_a?(Hash) and options.has_key?(:http_basic_authentication)
+pp options
+pp 1
+      what = URI.open(remote_URL, options[:http_basic_authentication]).read
+    else
+pp 2
+      what = URI.open(remote_URL).read
+    end
     into = File.basename(remote_URL)+'.html'
     if block_given?
       yielded = yield

data/lib/cyberweb/toplevel_methods/html_tables.rb

@@ -18,11 +18,17 @@ module Cyberweb
   require 'cyberweb/toplevel_methods/css.rb'
 
   # ========================================================================= #
-  # === Cyberweb.string_table3
+  # === Cyberweb.string_table2
   #
   # This returns the string form of a <table> tag.
+  #
+  # Arguments to this method could look like this:
+  #
+  #   Cyberweb.string_table2('mars1em') { an_array_here } # To pass an array as the main dataset.
+  #   Cyberweb.string_table2('mars1em') { [1,2,3,4,5,6] } # ^^^ as stated above
+  #
   # ========================================================================= #
-  def self.string_table3(
+  def self.string_table2(
       css_class = '',
       id        = '',
       css_style = '',
@@ -36,6 +42,12 @@ module Cyberweb
     if block_given?
       yielded = yield
       if yielded.is_a? Hash
+        # =================================================================== #
+        # === :with_this_data
+        # =================================================================== #
+        if yielded.has_key? :with_this_data
+          content = yielded.delete(:with_this_data)
+        end
         # =================================================================== #
         # === :read_in_this_file
         # =================================================================== #
@@ -57,7 +69,16 @@ module Cyberweb
           end
         end
       end
+      # ===================================================================== #
+      # If content is empty then we will replace the content with the
+      # value of the passed block next.
+      # ===================================================================== #
+      if content.empty? and !yielded.empty?
+        content = yielded
+      end
     end
+    css_class = css_class.to_s
+
     _ = '<table'.dup
     _ << return_css_class(css_class)
     _ << return_the_id(id)
@@ -65,29 +86,22 @@ module Cyberweb
     _ << '>'
     _ << "\n"
     content.each_with_index { |item, index|
-      if index % 3 == 0
-        _ << '<tr>'+N+'  <td>'+item+'</td>'+N
-      elsif index % 3 == 2
-        _ << '  <td>'+item+'</td>'+N+'</tr>'+N
+      if index % 2 == 0
+        _ << '<tr>'+N+'  <td>'+item.to_s+'</td>'+N
       else
-        _ << '  <td>'+item+'</td>'+N+N
+        _ << "  <td>#{item}</td>#{N}</tr>#{N}"
       end
     }
     _ << ::Cyberweb.string_ctable.to_s
-  end
+    return _
+  end; self.instance_eval { alias string_table string_table2 } # === Cyberweb.string_table
 
   # ========================================================================= #
-  # === Cyberweb.string_table2
+  # === Cyberweb.string_table3
   #
   # This returns the string form of a <table> tag.
-  #
-  # Arguments to this method could look like this:
-  #
-  #   Cyberweb.string_table2('mars1em') { an_array_here } # To pass an array as the main dataset.
-  #   Cyberweb.string_table2('mars1em') { [1,2,3,4,5,6] } # ^^^ as stated above
-  #
   # ========================================================================= #
-  def self.string_table2(
+  def self.string_table3(
       css_class = '',
       id        = '',
       css_style = '',
@@ -101,6 +115,12 @@ module Cyberweb
     if block_given?
       yielded = yield
       if yielded.is_a? Hash
+        # =================================================================== #
+        # === :with_this_data
+        # =================================================================== #
+        if yielded.has_key? :with_this_data
+          content = yielded.delete(:with_this_data)
+        end
         # =================================================================== #
         # === :read_in_this_file
         # =================================================================== #
@@ -122,16 +142,7 @@ module Cyberweb
           end
         end
       end
-      # ===================================================================== #
-      # If content is empty then we will replace the content with the
-      # value of the passed block next.
-      # ===================================================================== #
-      if content.empty? and !yielded.empty?
-        content = yielded
-      end
     end
-    css_class = css_class.to_s
-
     _ = '<table'.dup
     _ << return_css_class(css_class)
     _ << return_the_id(id)
@@ -139,15 +150,16 @@ module Cyberweb
     _ << '>'
     _ << "\n"
     content.each_with_index { |item, index|
-      if index % 2 == 0
-        _ << '<tr>'+N+'  <td>'+item.to_s+'</td>'+N
+      if index % 3 == 0
+        _ << '<tr>'+N+'  <td>'+item+'</td>'+N
+      elsif index % 3 == 2
+        _ << '  <td>'+item+'</td>'+N+'</tr>'+N
       else
-        _ << "  <td>#{item}</td>#{N}</tr>#{N}"
+        _ << '  <td>'+item+'</td>'+N+N
       end
     }
     _ << ::Cyberweb.string_ctable.to_s
-    return _
-  end; self.instance_eval { alias string_table string_table2 } # === Cyberweb.string_table
+  end
 
   # ========================================================================= #
   # === Cyberweb.string_table2_with_heading

data/lib/cyberweb/toplevel_methods/log_directory.rb

@@ -46,7 +46,7 @@ module Cyberweb
     # ======================================================================= #
     when :depot_temp_dir_cyberweb,
          :depot_temp_dir_web_object
-      i = '/Depo/Temp/cyberweb/'
+      i = '/Depot/Temp/cyberweb/'
     end
     unless i.end_with? '/'
       i = i.dup if i.frozen?
@@ -55,13 +55,6 @@ module Cyberweb
     @log_directory = i.freeze
   end; self.instance_eval { alias set_log_dir set_log_directory } # === Cyberweb.set_log_dir
 
-  # ========================================================================= #
-  # === Cyberweb.log_directory?
-  # ========================================================================= #
-  def self.log_directory?
-    @log_directory
-  end
-
   # ========================================================================= #
   # === log_directory?
   # ========================================================================= #
@@ -77,6 +70,16 @@ module Cyberweb
   MISSING_IMAGES_ARE_STORED_HERE =
     "#{@log_directory}web_object_errors.log"
 
+  # ========================================================================= #
+  # === Cyberweb.log_directory?
+  #
+  # On my home system this method will return a String such as
+  # "/home/Temp/cyberweb/".
+  # ========================================================================= #
+  def self.log_directory?
+    @log_directory
+  end; self.instance_eval { alias log_dir? log_directory? } # === Cyberweb.log_dir?
+
 end
 
 if __FILE__ == $PROGRAM_NAME

data/lib/cyberweb/toplevel_methods/misc.rb

@@ -62,6 +62,90 @@ module Cyberweb
   require 'cyberweb/toplevel_methods/write_what_into.rb'
   require 'cyberweb/html_tags/option.rb'
 
+  # ========================================================================= #
+  # === Cyberweb.draw_triangle
+  #
+  # This method will draw a triangle, via CSS.
+  #
+  # Usage example:
+  #
+  #   Cyberweb.draw_triangle(width: 200, height: 500, background_color: :steelblue, border_radius: '30%')
+  #
+  # ========================================================================= #
+  def self.draw_triangle(
+      hash = {
+        width:            0, # in px
+        height:           0, # in px
+        colour_to_use:    '#2762e9',
+        border_rules:    '
+        border-left: 50px solid transparent;
+        border-right: 50px solid transparent;
+        border-bottom: 100px solid '+colour_to_use+';
+        '
+      },
+      counter = @internal_hash[:counter_for_the_dynamic_circle] # Repurpose it here.
+    )
+    _ = "\n".dup
+    _ << "<style>\n"
+    _ << "div.dynamic_triangle#{counter} {\n"
+    _ << "  width: #{hash[:width]};\n"
+    _ << "  height: #{hash[:height]};\n"
+    _ << "  background: #{hash[:colour_to_use]};\n"
+    _ << "  #{hash[:border_rulres]};\n"
+    _ << "}\n"
+    _ << "</style>\n"
+    _ << "<div class=\"dynamic_triangle#{counter}\"></div>"
+    increment_draw_circle_counter
+    return _
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.draw_circle
+  #
+  # This method will draw a circle, via CSS.
+  #
+  # Usage example:
+  #
+  #   Cyberweb.draw_circle(width: 200, height: 500, background_color: :steelblue, border_radius: '30%')
+  #
+  # ========================================================================= #
+  def self.draw_circle(
+      hash = {
+        width:            200, # in px
+        height:           200, # in px
+        background_color: :crimson,
+        border_radius:    '50%'
+      },
+      counter = @internal_hash[:counter_for_the_dynamic_circle]
+    )
+    _ = "\n".dup
+    _ << "<style>\n"
+    _ << "div.dynamic_circle#{counter} {\n"
+    _ << "  width: #{hash[:width]}px;\n"
+    _ << "  height: #{hash[:height]}px;\n"
+    _ << "  background: #{hash[:background_color]};\n"
+    _ << "  border-radius: #{hash[:border_radius]};\n"
+    _ << "}\n"
+    _ << "</style>\n"
+    _ << "<div class=\"dynamic_circle#{counter}\"></div>"
+    increment_draw_circle_counter
+    return _
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.increment_draw_circle_counter
+  # ========================================================================= #
+  def self.increment_draw_circle_counter
+    @internal_hash[:counter_for_the_dynamic_circle] += 1
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.return_pretty_stars
+  # ========================================================================= #
+  def self.return_pretty_stars
+    return '<hr class="hr_stars">'
+  end
+
   # ========================================================================= #
   # === send_email
   #
@@ -404,46 +488,6 @@ and <b>newlines</b>.</p>
     end
   end
 
-  # ========================================================================= #
-  # === Cyberweb.draw_circle
-  #
-  # This method will draw a circle, via CSS.
-  #
-  # Usage example:
-  #
-  #   Cyberweb.draw_circle(width: 200, height: 500, background_color: :steelblue, border_radius: '30%')
-  #
-  # ========================================================================= #
-  def self.draw_circle(
-      hash = {
-        width:            200, # in px
-        height:           200, # in px
-        background_color: :crimson,
-        border_radius:    '50%'
-      },
-      counter = @internal_hash[:counter_for_the_dynamic_circle]
-    )
-    _ = "\n".dup
-    _ << "<style>\n"
-    _ << "div.dynamic_circle#{counter} {\n"
-    _ << "  width: #{hash[:width]}px;\n"
-    _ << "  height: #{hash[:height]}px;\n"
-    _ << "  background: #{hash[:background_color]};\n"
-    _ << "  border-radius: #{hash[:border_radius]};\n"
-    _ << "}\n"
-    _ << "</style>\n"
-    _ << "<div class=\"dynamic_circle#{counter}\"></div>"
-    increment_draw_circle_counter
-    return _
-  end
-
-  # ========================================================================= #
-  # === Cyberweb.increment_draw_circle_counter
-  # ========================================================================= #
-  def self.increment_draw_circle_counter
-    @internal_hash[:counter_for_the_dynamic_circle] += 1
-  end
-
   # ========================================================================= #
   # === Cyberweb.is_a_video_file?
   #
@@ -483,13 +527,6 @@ and <b>newlines</b>.</p>
     return _
   end
 
-  # ========================================================================= #
-  # === Cyberweb.return_pretty_stars
-  # ========================================================================= #
-  def self.return_pretty_stars
-    return '<hr class="hr_stars">'
-  end
-
   # ========================================================================= #
   # === show_ruby_file
   #

data/lib/cyberweb/toplevel_methods/path.rb

@@ -9,6 +9,33 @@ module Cyberweb
   require 'cyberweb/toplevel_methods/server_base_directory.rb'
   require 'cyberweb/toplevel_methods/return_pwd.rb'
 
+  # ========================================================================= #
+  # === Cyberweb.converted_path_to_the_directory_containing_the_copied_javascript_files
+  #
+  # This method may return a String such as
+  # "../../../../Temp/cyberweb/javascript_code/".
+  # ========================================================================= #
+  def self.converted_path_to_the_directory_containing_the_copied_javascript_files
+    "#{converted_path}#{converted_path}Temp/cyberweb/javascript_code/"
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.converted_path_to_project_base_dir
+  #
+  # This method may return a String such as
+  # "../../../../cyberweb/lib/cyberweb/".
+  # ========================================================================= #
+  def self.converted_path_to_project_base_dir
+    "#{converted_path}cyberweb/lib/cyberweb/"
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.converted_path_to_data
+  # ========================================================================= #
+  def self.converted_path_to_data
+    "#{converted_path}data/"
+  end; self.instance_eval { alias path_to_data? converted_path_to_data } # === Cyberweb.path_to_data?
+
   # ========================================================================= #
   # === Cyberweb.converted_path
   #
@@ -18,20 +45,14 @@ module Cyberweb
   # It can be overruled on a per-directory setting, using a yaml file.
   # ========================================================================= #
   def self.converted_path(
-      result = '../' * ::Cyberweb.n_slashes_towards_the_server_base_directory
+      result = '../' *
+               ::Cyberweb.n_slashes_towards_the_server_base_directory
     )
     return result
   end; self.instance_eval { alias cyberweb_fixed_path? converted_path } # === Cyberweb.cyberweb_fixed_path?
        self.instance_eval { alias fixed_path?          converted_path } # === Cyberweb.fixed_path?
        self.instance_eval { alias path?                converted_path } # === Cyberweb.path?
        self.instance_eval { alias local_base?          converted_path } # === Cyberweb.local_base?
-
-  # ========================================================================= #
-  # === Cyberweb.converted_path_to_data
-  # ========================================================================= #
-  def self.converted_path_to_data
-    "#{converted_path}data/"
-  end; self.instance_eval { alias path_to_data? converted_path_to_data } # === Cyberweb.path_to_data?
  
   # ========================================================================= #
   # === Cyberweb.n_slashes_towards_the_server_base_directory