cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/css_manager/css_manager.rb

@@ -0,0 +1,237 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::CssManager
+#
+# The purpose of this class is to generate ad-hoc CSS rules on the fly.
+#
+# Only defined end points should be handled by this class, though.
+#
+# Usage example:
+#
+#   css_manager = Cyberweb::CssManager.new(ARGV)
+#   css_manager.css_rule_for_hover_pulse_grow(5)
+#
+# =========================================================================== #
+# require 'cyberweb/css_manager/css_manager.rb'
+# css_manager = Cyberweb::CssManager.new(ARGV)
+# css_manager.css_rule_for_hover_pulse_grow(5)
+# css_manager.result?
+# =========================================================================== #
+require 'cyberweb/base/base.rb'
+
+module Cyberweb
+
+class CssManager < Base # === Cyberweb::CssManager
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # === @result
+    # ======================================================================= #
+    @result = ''.dup
+  end
+
+  # ========================================================================= #
+  # === add                                                         (add tag)
+  # ========================================================================= #
+  def add(i)
+    @result << i
+  end
+
+  # ========================================================================= #
+  # === css_rule_for_hover_pulse_grow
+  #
+  # This method can be used to generate an ad-hoc pulse-grow CSS rule.
+  #
+  # Usage example:
+  #
+  #   css_rule_for_hover_pulse_grow(5)
+  #
+  # ========================================================================= #
+  def css_rule_for_hover_pulse_grow(
+      iterate_n_times                = :infinite,
+      use_this_as_the_CSS_class_name = 'hover_pulse_grow'
+    )
+    case iterate_n_times
+    # ======================================================================= #
+    # === :infinity
+    # ======================================================================= #
+    when :infinity,
+         :default,
+         nil # This is also the default entry point.
+      iterate_n_times = :infinite
+    end
+    iterate_n_times = iterate_n_times.to_s
+    add '/* Pulse Grow */
+@-webkit-keyframes '+use_this_as_the_CSS_class_name.to_s+' {
+  to {
+    -webkit-transform: scale(1.1);
+    transform: scale(1.1);
+  }
+}
+@keyframes '+use_this_as_the_CSS_class_name.to_s+' {
+  to {
+    -webkit-transform: scale(1.1);
+    transform: scale(1.1);
+  }
+}
+.'+use_this_as_the_CSS_class_name.to_s+' {
+  display: inline-block;
+  vertical-align: middle;
+  -webkit-transform: perspective(1px) translateZ(0);
+  transform: perspective(1px) translateZ(0);
+  box-shadow: 0 0 1px rgba(0, 0, 0, 0);
+}
+.'+use_this_as_the_CSS_class_name.to_s+':hover,
+.'+use_this_as_the_CSS_class_name.to_s+':focus,
+.'+use_this_as_the_CSS_class_name.to_s+':active {
+  -webkit-animation-name: '+use_this_as_the_CSS_class_name.to_s+';
+  animation-name: '+use_this_as_the_CSS_class_name.to_s+';
+  -webkit-animation-duration: 0.3s;
+  animation-duration: 0.3s;
+  -webkit-animation-timing-function: linear;
+  animation-timing-function: linear;
+  -webkit-animation-direction: alternate;
+  animation-direction: alternate;
+
+  -webkit-animation-iteration-count: '+iterate_n_times+'; /* or infinite; */
+  animation-iteration-count:         '+iterate_n_times+'; /* or infinite; */
+}'
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+  end
+
+  # ========================================================================= #
+  # === to_str
+  # ========================================================================= #
+  def to_str
+    @result.to_s
+  end; alias to_s    to_str # === to_s
+       alias result? to_str # === result?
+
+  # ========================================================================= #
+  # === result_as_CSS_style?
+  # ========================================================================= #
+  def result_as_CSS_style?
+    "<style>\n#{result?}\n</style>"
+  end
+
+  # ========================================================================= #
+  # === css_rule_for_drop_shadow
+  #
+  # This method can be used to generate a drop-shadow effect for text.
+  #
+  # Usage example:
+  #
+  #   css_rule_for_drop_shadow(:steelblue)
+  #
+  # ========================================================================= #
+  def css_rule_for_drop_shadow(
+      use_this_colour = :steelblue,
+      n_px_width      = 5
+    )
+    use_this_colour = use_this_colour.to_s.delete(':')
+    add '/* drop-shadow effect */
+    .drop_shadow_'+use_this_colour+' {
+      filter: drop-shadow('+
+              n_px_width.to_s+'px '+
+              n_px_width.to_s+'px '+
+              n_px_width.to_s+'px '+use_this_colour+');
+    }
+
+    '
+  end
+
+  # ========================================================================= #
+  # === evaluate_this_block
+  # ========================================================================= #
+  def evaluate_this_block(&block)
+    if block_given?
+      eval(yield)
+    end
+  end
+
+  # ========================================================================= #
+  # === Cyberweb::CssManager[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Cyberweb.css_manager
+#
+# This currently (November 2021) does not work.
+#
+# Invocation example:
+#
+#   Cyberweb.css_manager { css_rule_for_drop_shadow(:lightgreen) }.css_style?
+#
+# =========================================================================== #
+def self.css_manager(&block)
+  if block_given?
+    css_manager = Cyberweb::CssManager.new
+    css_manager.evaluate_this_block(&block)
+    # ======================================================================= #
+    # _ = Cyberweb.oop_h1('Batterien', 'martb1px')
+    # _.css_class 'martb1px drop_shadow_lightgreen'
+    # _.css_manager 'css_rule_for_drop_shadow(:lightgreen)'
+    #
+    # css_manager.css_rule_for_drop_shadow(:lightgreen)
+    # _.add_to_pre_content css_manager.result_as_CSS_style?
+    # _.add_to_pre_content( Cyberweb.css_manager { css_rule_for_drop_shadow(:lightgreen) }.css_style? )
+    # ======================================================================= #
+  end
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  require 'colours/autoinclude'
+  require 'cliner'
+  cliner
+  css_manager = Cyberweb::CssManager.new(ARGV)
+  css_manager.css_rule_for_hover_pulse_grow(5)
+  puts css_manager
+  cliner
+  css_manager = Cyberweb::CssManager.new(ARGV)
+  css_manager.css_rule_for_hover_pulse_grow(12, 'another_name')
+  puts css_manager
+  cliner
+  e Cyberweb.css_manager { css_rule_for_drop_shadow(:lightgreen) }.css_style?
+end # css_manager.rb

data/lib/cyberweb/databases/sqlite.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::Databases::Sqlite
+# =========================================================================== #
+# require 'cyberweb/databases/sqlite.rb'
+# =========================================================================== #
+module Cyberweb
+
+module Databases
+
+module Sqlite
+
+  begin
+    require 'sequel'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === Cyberweb::Databases::Sqlite.create_new_sqlite_database
+  # ========================================================================= #
+  def self.create_new_sqlite_database(
+       name_of_the_database
+     )
+    DB = Sequel.sqlite # memory database, requires sqlite3
+
+    DB.create_table(:items) {
+      primary_key :id
+      String :name
+      Float :price
+    }
+    items = DB[:items] # Create a dataset
+
+    # ======================================================================= #
+    # Populate the table
+    # ======================================================================= #
+    items.insert(name: 'abc', price: rand * 100)
+    items.insert(name: 'def', price: rand * 100)
+    items.insert(name: 'ghi', price: rand * 100)
+
+    # ======================================================================= #
+    # Print out the number of records
+    # ======================================================================= #
+    puts "Item count: #{items.count}"
+
+    # ======================================================================= #
+    # Print out the average price
+    # ======================================================================= #
+    puts "The average price is: #{items.avg(:price)}"
+  end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Cyberweb::Databases::Sqlite.create_new_sqlite_database()
+end

data/lib/cyberweb/debug/debug.rb

@@ -24,7 +24,7 @@ module Cyberweb
   else # else we will not debug by default.
     DEBUG = false
   end
-  
+
   # ========================================================================= #
   # === @debug
   #

data/lib/cyberweb/encoding/encoding.rb

@@ -65,8 +65,19 @@ def self.main_encoding?
   ::Cyberweb::Encoding::MAIN_ENCODING
 end
 
+# =========================================================================== #
+# === Cyberweb.unicode_encoding?
+# =========================================================================== #
+def self.unicode_encoding?
+  Encoding::ENCODING_UTF8
+end
+
 # =========================================================================== #
 # === Cyberweb.ensure_main_encoding
+#
+# This method will ensure that the given string matches a specific
+# encoding - usually our main encoding in use for the cyberweb
+# project.
 # =========================================================================== #
 def self.ensure_main_encoding(of_this_string)
   ::Cyberweb::Encoding.ensure_main_encoding(of_this_string)

data/lib/cyberweb/evaluate_from_the_same_named_file_then_serve.rb

@@ -2,7 +2,7 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# http://localhost/DATA/PROGRAMMING_LANGUAGES/RUBY/src/roebe/lib/roebe/www/zoologie/zoologie.cgi
+# http://localhost/programming/ruby/src/roebe/lib/roebe/www/zoologie/zoologie.cgi
 # =========================================================================== #
 require 'cyberweb'
 

data/lib/cyberweb/favicon/favicon.rb

@@ -20,7 +20,7 @@ module Cyberweb
 
 class Favicon # === Cyberweb::Favicon
 
-  require 'cyberweb/constants/nl.rb'
+  require 'cyberweb/constants/constants.rb'
 
   begin
     require 'nokogiri'
@@ -145,8 +145,8 @@ end; self.instance_eval { alias get_favicon download_favicon } # === Cyberweb.ge
 # Assign a favicon with this method. The argument `change_to` should be
 # a Fixnum, and icon_path should be a string.
 #
-# Since Sep 2011, if we pass a symbol as argument to `icon_path`, we
-# will try to use webicons instead (which as you can see, will use 
+# Since as of September 2011, if we pass a symbol as argument to `icon_path`,
+# we will try to use webicons instead (which as you can see, will use 
 # the method get_webimage()).
 # =========================================================================== #
 def self.return_favicon(
@@ -181,15 +181,16 @@ end
 #
 # This is a special method, should be used internally only! (cfdg tag)
 # =========================================================================== #
-def self.create_random_cfdg_favicon
+def self.create_random_cfdg_favicon(
+    img_dir = '/home/x/programming/ruby/src/image_paradise/lib/image_paradise/'
+  )
   print_html_header
-  img_dir = IMAGE_DIRECTORY
-  directory_with_cfdg_images = img_dir+'CFDG/'
+  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')
+  system("#{string} 2>&1")
   return favicon_name
 end
 

data/lib/cyberweb/forum/README.md

@@ -0,0 +1,4 @@
+This directory will include code that can be used as a
+substitute for a web-forum. The idea here is to keep it
+simple but useful. It should also support different 
+formats, starting with YAML files.

data/lib/cyberweb/foto_gallery/foto_gallery.rb

@@ -0,0 +1,158 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::FotoGallery
+#
+# This is the base class to enable a foto-gallery.
+#
+# Usage example:
+#
+#   Cyberweb::FotoGallery.new(ARGV)
+#
+# =========================================================================== #
+# require 'cyberweb/foto_gallery/foto_gallery.rb'
+# =========================================================================== #
+require 'cyberweb/base/base.rb'
+
+module Cyberweb
+
+class FotoGallery < Base # === Cyberweb::FotoGallery
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    case run_already
+    # ======================================================================= #
+    # === :do_not_run_yet
+    # ======================================================================= #
+    when :do_not_run_yet
+      run_already = false
+    end
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :do_not_run_yet
+      # ===================================================================== #
+      when :do_not_run_yet
+        run_already = false
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # === @use_this_directory
+    # ======================================================================= #
+    @use_this_directory = return_pwd
+    # ======================================================================= #
+    # === @fetch_images_from_subdirectories_as_well
+    #
+    # If this variable is true then we will fetch images from
+    # subdirectories as well.
+    # ======================================================================= #
+    @fetch_images_from_subdirectories_as_well = true
+    # ======================================================================= #
+    # === @sort_how
+    #
+    # If the following variable is set to nil then no sorting will occur.
+    # If, however had, the variable is set to :sort_based_on_time then
+    # the images that are shown will be time-sorted.
+    # ======================================================================= #
+    @sort_how = :sort_based_on_time
+  end
+
+  # ========================================================================= #
+  # === use_base64_images?
+  # ========================================================================= #
+  def use_base64_images?
+    _ = use_which_directory?
+    !_.include?(::Cyberweb.serve_directory?) # The latter will return a String such as "/home/x/".
+  end
+
+  # ========================================================================= #
+  # === obtain_all_image_files
+  # ========================================================================= #
+  def obtain_all_image_files
+    if @fetch_images_from_subdirectories_as_well
+      all_files = Dir[@use_this_directory+'**/**']
+    else
+      all_files = Dir[@use_this_directory+'**']
+    end
+    @all_image_files = all_files.select {|file|
+      is_an_image_file?(file)
+    }
+    if @sort_how
+      case @sort_how
+      # ===================================================================== #
+      # === :sort_based_on_time
+      # ===================================================================== #
+      when :sort_based_on_time
+        @all_image_files = Cyberweb.sort_based_on_time(@all_image_files)
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === set_use_this_directory
+  # ========================================================================= #
+  def set_use_this_directory(i)
+    @use_this_directory = i
+  end
+
+  # ========================================================================= #
+  # === use_this_directory?
+  # ========================================================================= #
+  def use_this_directory?
+    @use_this_directory
+  end; alias use_which_directory? use_this_directory? # === use_which_directory?
+
+  # ========================================================================= #
+  # === all_image_files?
+  # ========================================================================= #
+  def all_image_files?
+    @all_image_files
+  end; alias images? all_image_files? # === images?
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    obtain_all_image_files
+  end
+
+  # ========================================================================= #
+  # === Cyberweb::FotoGallery[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Cyberweb::FotoGallery.new(ARGV)
+end # foto_gallery

data/lib/cyberweb/generator/README.md

@@ -1,2 +1,2 @@
-In this directory code is stored that can be used to generate template files
-or .cgi files. In other words: "code that can generate code".
+In this directory code is stored that can be used to generate template
+files or .cgi files. In other words: "code that can generate code".

data/lib/cyberweb/generator/cgi.rb

@@ -17,6 +17,8 @@ module Generator
 
 class CGI < ::Cyberweb::Generator::Generator # === Cyberweb::Generator::CGI
 
+  require 'cyberweb/toplevel_methods/date_and_time.rb'
+
   begin
     require 'esystem/method'
   rescue LoadError; end
@@ -26,6 +28,11 @@ class CGI < ::Cyberweb::Generator::Generator # === Cyberweb::Generator::CGI
   # ========================================================================= #
   NAMESPACE = inspect
 
+  # ========================================================================= #
+  # === USE_THESE_CSS_CLASSES_FOR_THE_MAIN_DIV_ELEMENT
+  # ========================================================================= #
+  USE_THESE_CSS_CLASSES_FOR_THE_MAIN_DIV_ELEMENT = 'mar0px pad0px s0_6em'
+
   # ========================================================================= #
   # === Cyberweb::Generator::CGI.generate_default_skeleton_for_webpage
   #
@@ -37,23 +44,26 @@ class CGI < ::Cyberweb::Generator::Generator # === Cyberweb::Generator::CGI
     )
     return RUBY_HEADER+"
 # =========================================================================== #
-#
+# require ''
 # =========================================================================== #
 require 'cyberweb/autoinclude'
 
-english {
-# autoextend # ← This can be used to automatically do: include Cyberweb
-title '#{use_this_title}'
+english(:filename) {
+created_on '#{Cyberweb.date_today}' # #{Cyberweb.return_current_weekday}.
+autoextend # ← This can be used to automatically do: include Cyberweb
+# title '#{use_this_title}' # Or use this as the title.
 ruby_favicon
-css_style :template1
+template1
 body_css_class 'mar0px s2px padt2px VERDANAs'
 body_css_style 'background-color: #d3d2d1;'
 font_size 'def'
 
-doc('mar0px pad0px s0_5em') {
+doc('#{USE_THESE_CSS_CLASSES_FOR_THE_MAIN_DIV_ELEMENT}') {
   h1 dot(106, 'marr8px')+
-     '#{use_this_title.capitalize}',
+     title?,
      'mart1px marb0_5em'
+  p_default {
+  }
 }}"
   end
 
@@ -107,11 +117,13 @@ doc('mar0px pad0px s0_5em') {
     end
     if commandline?
       case _ # case tag
+      # ===================================================================== #
       # === generate
+      # ===================================================================== #
       when 'generate'
         generate_cgi_file(commandline?[1])
       else
-        if _.end_with? '.cgi'
+        if _.end_with?('.cgi','.rb')
           generate_cgi_file(_)
         end
       end
@@ -159,7 +171,8 @@ doc('mar0px pad0px s0_5em') {
     # ======================================================================= #
     # We have to re-determine the title of a page.
     # ======================================================================= #
-    @title_of_page = File.basename(i).tr('_',' ').
+    @title_of_page = File.basename(i).
+                     tr('_',' ').
                      gsub(/#{File.extname(i)}/,'')
     update_default_page_content # Need to update @default_page_content.
     what = @default_page_content