cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/toplevel_methods/tag.rb

@@ -7,7 +7,7 @@
 module Cyberweb
 
   require 'html_tags'
-  require 'cyberweb/colours/sanitize_for_colours.rb'
+  require 'cyberweb/colours/colours.rb'
   require 'cyberweb/toplevel_methods/random.rb'
   require 'cyberweb/toplevel_methods/registered_ids.rb'
 
@@ -73,9 +73,15 @@ module Cyberweb
     end
     register_this_id(the_id)
     if the_id.is_a? Hash
+      # ===================================================================== #
+      # === :css
+      # ===================================================================== #
       if the_id.has_key? :css # We assume this means :css_style
         css_style = the_id.delete(:css)
         the_id = '' # And then delete it.
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
       elsif the_id.has_key? :id
         the_id = the_id.delete(:id)
       end
@@ -179,7 +185,7 @@ module Cyberweb
   #
   # ========================================================================= #
   def self.tag(
-      which_tag, # <- Is a mandatory entry.
+      which_tag, # ← Is a mandatory entry.
       css_class  = '',
       the_id     = '',
       css_style  = '',

data/lib/cyberweb/toplevel_methods/temp_directory.rb

@@ -13,8 +13,8 @@ module Cyberweb
   #
   # This is the temp directory.
   #
-  # It allows us to store temporary files, such as log files, or
-  # a .html output file.
+  # It allows us to store temporary files, such as log files, or a 
+  # .html output file.
   # ========================================================================= #
   @temp_directory = nil
 

data/lib/cyberweb/toplevel_methods/textile.rb

@@ -10,7 +10,7 @@ module Cyberweb
   # This uses textile markup format.
   # ========================================================================= #
   def self.textile(
-      i         = '/home/x/DATA/PC/TEXTILE/test.textile',
+      i         = '/home/x/data/PC/TEXTILE/test.textile',
       return_it = false
     )
     begin
@@ -20,7 +20,7 @@ module Cyberweb
       require 'redcloth' unless Object.const_defined?(:Redcloth)
     rescue LoadError; end
     if i.empty? or (i == :default)
-      i = '/home/x/DATA/PC/TEXTILE/test.textile'
+      i = '/home/x/data/PC/TEXTILE/test.textile'
     end
     begin # rescue, in case RedCloth was not installed.
       document = RedCloth.new(File.read(i))

data/lib/cyberweb/toplevel_methods/title.rb

@@ -11,8 +11,8 @@ module Cyberweb
   # ========================================================================= #
   # === @title
   #
-  # This ivar will store the title of a page. Initially it is set
-  # to a value of nil.
+  # This ivar will store the title of a page. Initially it is set to a 
+  # value of nil.
   #
   # You can query its current value by calling the method Cyberweb.title().
   # ========================================================================= #
@@ -27,8 +27,20 @@ module Cyberweb
   #
   #   <title>Hello World!</title>
   #
+  # Note that the method is a pure setter - it will NOT modify the
+  # input argument or sanitize it.
   # ========================================================================= #
   def self.set_title(i)
+    if i.is_a? Array
+      i = i.first
+    end
+    case i
+    # ======================================================================= #
+    # === :filename
+    # ======================================================================= #
+    when :filename
+      i = $PROGRAM_NAME
+    end
     @title = i
   end
 

data/lib/cyberweb/toplevel_methods/video.rb

@@ -9,10 +9,6 @@
 # =========================================================================== #
 module Cyberweb
 
-  begin
-    require 'multimedia_paradise/videos/youtube_embedder.rb'
-  rescue LoadError; end
-
   # ========================================================================= #
   # Constants specific to Video things go into this file as well.
   # ========================================================================= #
@@ -55,6 +51,9 @@ module Cyberweb
       width  = '640',
       height = '385'
     )
+    begin
+      require 'multimedia_paradise/videos/youtube_embedder.rb'
+    rescue LoadError; end
     _ = ''.dup
     src = src.strip if src.is_a? String # We have no use for leading and trailing ' '.
     if src.is_a? Array

data/lib/cyberweb/toplevel_methods/write_what_into.rb

@@ -18,6 +18,8 @@ module Cyberweb
         file.write(what) # Write the new file here.
       }
     rescue Errno::EACCES => error # Need to rescue permission errors.
+      puts 'When trying to use Cyberweb.write_what_into() an '\
+           'access-error occurred:'
       pp error
       pp `whoami`
       exit

data/lib/cyberweb/utility_scripts/README.md

@@ -1,4 +1,3 @@
-This directory collects classes that normally are not a necessary
-part of the Cyberweb project. For example, a class that can
-download the baloon-widget is such an example for a "utility
-script".
+This directory collects classes that normally are not a necessary part
+of the Cyberweb project. For example, a class that can download the
+baloon-widget is such an example for a "utility script".

data/lib/cyberweb/utility_scripts/autogenerate_drop_shadow_rules/autogenerate_drop_shadow_rules.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::AutogenerateDropShadowRules
+#
+# This class is only useful on my home system really. It will generate
+# all drop-shadow CSS rules that are part of the cyberweb framework.
+# =========================================================================== #
+# require 'cyberweb/utility_scripts/images_to_html/images_to_html.rb'
+# webpage = Cyberweb::AutogenerateDropShadowRules.new
+# ============================================================================ #
+require 'cyberweb/base/base.rb'
+
+module Cyberweb
+
+class AutogenerateDropShadowRules < ::Cyberweb::Base
+
+  require 'cyberweb/utility_scripts/images_to_html/misc.rb'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @n_px_to_use
+    # ======================================================================= #
+    @n_px_to_use = 4
+  end
+
+  # ========================================================================= #
+  # === save_this_string
+  # ========================================================================= #
+  def save_this_string(what)
+    into = '/home/x/programming/ruby/src/cyberweb/lib/cyberweb/cascading_style_sheets/drop_shadow.css'
+    puts 'Saving into the file `'+sfile(into)+'`.'
+    write_what_into(what, into)
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    array_available_html_colours = ::Colours.html_colours?
+    _ = ''.dup
+    array_available_html_colours.each {|this_colour|
+      _ << '.drop_shadow_'+this_colour.to_s.ljust(25)+
+           ' { filter: drop-shadow('+@n_px_to_use.to_s+'px '+@n_px_to_use.to_s+'px '+@n_px_to_use.to_s+'px '+this_colour.to_s+'); }'
+      _ << "\n"
+    }
+    save_this_string(_)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  require 'colours/colours_e_autoinclude.rb'
+  Cyberweb::AutogenerateDropShadowRules.new(ARGV)
+end # AutogenerateDropShadowRules

data/lib/cyberweb/utility_scripts/create_standalone_html_page.rb

@@ -0,0 +1,223 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::CreateStandaloneHtmlPage
+#
+# This class was created in May 2022 as I got tired of the semi-buggy code
+# that would generate a standalone .html file. Furthermore, that old code
+# would store into /tmp/, rather than the current working directory, which
+# made this all fairly inconvenient to use. Thus it seemed better to create
+# a new class, and if necessary use that class to replace the old code
+# eventually.
+#
+# Usage example:
+#
+#   Cyberweb::CreateStandaloneHtmlPage.new(ARGV)
+#
+# =========================================================================== #
+# require 'cyberweb/create_standalone_html_page.rb'
+# =========================================================================== #
+require 'cyberweb/base/base.rb'
+
+module Cyberweb
+
+class CreateStandaloneHtmlPage < Base # === Cyberweb::CreateStandaloneHtmlPage
+
+  require 'open-uri'
+
+  # ========================================================================= #
+  # === 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_open_via_the_browser
+      # ===================================================================== #
+      when :do_not_open_via_the_browser
+        do_not_open_via_the_browser
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+    # ======================================================================= #
+    # === @shall_we_try_to_open_the_autogenerated_file_after_it_has_been_created
+    #
+    # The following variable is only respected on is-roebe systems.
+    # ======================================================================= #
+    @shall_we_try_to_open_the_autogenerated_file_after_it_has_been_created = true
+    # ======================================================================= #
+    # === @shall_we_create_a_subdirectory_and_copy_the_image_files
+    #
+    # If the following variable is set to true then we will create a
+    # subdirectory and then copy all these images.
+    # ======================================================================= #
+    @shall_we_create_a_subdirectory_and_copy_the_image_files = true
+    set_store_into_this_base_directory
+  end
+
+  # ========================================================================= #
+  # === do_not_open_via_the_browser
+  # ========================================================================= #
+  def do_not_open_via_the_browser
+    @shall_we_try_to_open_the_autogenerated_file_after_it_has_been_created = false
+  end
+
+  # ========================================================================= #
+  # === set_store_into_this_base_directory
+  # ========================================================================= #
+  def set_store_into_this_base_directory(i = return_pwd)
+    i = i.dup if i.frozen?
+    unless i.end_with?('/')
+      i << '/'
+    end
+    @store_into_this_base_directory = i
+  end
+
+  # ========================================================================= #
+  # === start_dir?
+  # ========================================================================= #
+  def start_dir?
+    @start_dir
+  end
+
+  # ========================================================================= #
+  # === create_the_html_file_using_this_dataset
+  # ========================================================================= #
+  def create_the_html_file_using_this_dataset(
+      dataset,
+      into = :infer
+    )
+    case into
+    # ======================================================================= #
+    # === :infer
+    # ======================================================================= #
+    when :infer,
+         :default
+      into = @store_into_this_base_directory+
+             File.basename(@work_on_this_file).
+             delete_suffix('.cgi')+'.html'
+    end
+    what = dataset
+    e 'Saving into '+sfile(into)+' next.'
+    write_what_into(what, into)
+    if is_on_roebe? and
+      @shall_we_try_to_open_the_autogenerated_file_after_it_has_been_created
+      require 'open'
+      Open.in_browser(into)
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    begin
+      require 'image_paradise/utility_scripts/image_gallery/image_gallery.rb'
+    rescue LoadError; end
+    @start_dir = return_pwd
+    # @work_on_this_file = File.basename(first_argument?.dup)
+    @work_on_this_file = rds(
+      first_argument?.dup
+    ).dup
+    absolute_path = File.absolute_path(@work_on_this_file).
+                    gsub(
+                      Regexp.quote('/home/x/'),''
+                    )
+    use_this_url = 'http://localhost/'+absolute_path
+    puts ::Colours.rev+
+         'Working on the file '+@work_on_this_file+' next. The '+
+         'URL that will be used is: '
+    puts
+    puts ::Colours.steelblue(use_this_url)
+    puts
+    data = URI.open(use_this_url).read
+    puts 'Next the .html file will be created.'
+    use_this_as_the_filename = :infer
+    if @shall_we_create_a_subdirectory_and_copy_the_image_files
+      name_of_the_subdirectory = use_this_url # This will be like "http://localhost/data/images/fotos/responsive_image_gallery.cgi".
+      # Next we must distinguish between URLs that have a '?'
+      # and those that do not.
+      if name_of_the_subdirectory.include?('?')
+        name_of_the_subdirectory = name_of_the_subdirectory.split('?').last.to_s+'/'
+      else
+        name_of_the_subdirectory = File.basename(name_of_the_subdirectory).delete_suffix('.cgi')+'/'
+      end
+      replacement_value = ::ImageParadise::ImageGallery.modify_this_key(
+        name_of_the_subdirectory.delete('/')
+      )
+      # Add an exception for the base directory next:
+      if replacement_value == 'responsive_image_gallery'
+        replacement_value = ''
+      end
+      real_absolute_target = '/home/x/data/images/fotos/'+
+                             replacement_value
+      if replacement_value.empty?
+        name_of_the_subdirectory = 'responsive_image_gallery'
+      else
+        name_of_the_subdirectory = File.basename(replacement_value)
+      end
+      use_this_as_the_filename = name_of_the_subdirectory+'.html'
+      unless File.directory?(name_of_the_subdirectory)
+        puts 'Creating the subdirectory '+
+             ::Colours.royalblue(name_of_the_subdirectory)+' next.'
+        mkdir(name_of_the_subdirectory)
+      end
+      cd(name_of_the_subdirectory)
+      all_images = Dir[real_absolute_target+'**/**'].select {|entry|
+        is_an_image?(entry)
+      }
+      cpr(all_images, return_pwd)
+      cd(start_dir?)
+    end
+    create_the_html_file_using_this_dataset(data, use_this_as_the_filename)
+  end
+
+  # ========================================================================= #
+  # === Cyberweb::CreateStandaloneHtmlPage[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Cyberweb::CreateStandaloneHtmlPage.new(ARGV)
+end # standalonehtmlpage $FOTOS_DIRECTORY/responsive_image_gallery.cgi
+    # standalonehtmlpage $FOTOS_DIRECTORY/responsive_image_gallery.cgi?hertha
+    # standalonehtmlpage $FOTOS_DIRECTORY/responsive_image_gallery.cgi?urlaub
+    # standalonehtmlpage $FOTOS_DIRECTORY/responsive_image_gallery.cgi?marchettigasse
+    # standalonehtmlpage $FOTOS_DIRECTORY/responsive_image_gallery.cgi?cats
+    # standalonehtmlpage $FOTOS_DIRECTORY/responsive_image_gallery.cgi?mama

data/lib/cyberweb/utility_scripts/download_all_images_from_this_website.rb

@@ -0,0 +1,143 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::DownloadAllImagesFromThisWebsite
+# =========================================================================== #
+# require 'cyberweb/utility_scripts/download_images_from_this_website.rb'
+# =========================================================================== #
+require 'cyberweb/base/base.rb'
+
+module Cyberweb
+
+class DownloadAllImagesFromThisWebsite < Base # === Cyberweb::DownloadAllImagesFromThisWebsite
+
+  require 'cyberweb/toplevel_methods/download_webpage.rb'
+
+  require 'open-uri'
+
+  alias f puts
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn
+    super(NAMESPACE)
+  end
+
+  require 'cyberweb/utility_scripts/images_to_html/images_to_html.rb'
+  # ========================================================================= #
+  # === cweb
+  # ========================================================================= #
+  def cweb
+    webpage = Cyberweb::ImagesToHtml.new([], :do_not_run_yet) { :use_jquery }
+    webpage.set_store_where(
+      File.absolute_path(
+        File.basename(Dir.pwd).downcase+'.html'
+      )
+    )
+    webpage.set_images(
+      Dir['*.png']
+    )
+    puts 'Next creating the following page: '+webpage.stored_where?
+    webpage.scan_for_images_in_this_directory :return_pwd
+    webpage.save_what_to
+  end
+
+  # ========================================================================= #
+  # === tomato
+  # ========================================================================= #
+  def tomato(i); ::Colours.tomato(i); end
+
+  # ========================================================================= #
+  # === create_the_images_directory
+  # ========================================================================= #
+  def create_the_images_directory
+    mkdir 'images/' unless File.directory?('images/')
+  end
+
+  require 'uri'
+  # ========================================================================= #
+  # === work_on_these_images
+  # ========================================================================= # 
+  def work_on_these_images(these_images)
+    f 'Working on `'+::Colours.steelblue(first_argument?)+'` next.'
+    these_images.each {|this_image|
+      f 'The current image that is investigated is: '+tomato(this_image.to_s)
+      uri = URI(first_argument?)
+      # new_url = uri.scheme+'://'+uri.host+'/'+
+      #           this_image
+      # esystem 'wget '+new_url
+      f 'This image will next be downloaded into the following '\
+        'directory: `'+sdir(return_pwd)+'`.'
+      run_this_command = 'wget '.dup
+      run_this_command << uri.scheme+':'
+      run_this_command << '/' unless this_image.start_with? '/'
+      run_this_command << '/' unless this_image.start_with? '//'
+      run_this_command << this_image
+      f ::Colours.tomato(run_this_command)
+      f
+      system run_this_command
+      f
+    }
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    target = first_argument?
+    create_the_images_directory
+    # ======================================================================= #
+    # The next method will save into a file.
+    # ======================================================================= #
+    array = Cyberweb.download_webpage(target)
+
+    _ = array.first
+    regex_to_use =
+      /<img.+src="([A-Za-z0-9\/:\.-]+)/
+    # ======================================================================= #
+    # See: https://rubular.com/r/vRogtVrSuDYd8f
+    # ======================================================================= #
+    scanned = _.scan(regex_to_use).map {|first_match, second_match|
+      first_match
+    }
+    flattened = scanned.flatten
+    cd 'images' # Enter our target directory.
+    work_on_these_images(flattened)
+    cweb
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Cyberweb::DownloadAllImagesFromThisWebsite.new
+end # dimages https://en.wikipedia.org/wiki/Main_Page
+    # dimages https://tenor.com/search/sexy-girl-gifs
+    # dimages https://unsplash.com/images/feelings/funny

data/lib/cyberweb/utility_scripts/download_balloon_css.rb

@@ -133,7 +133,7 @@ class DownloadBalloonCss < Base # === Cyberweb::DownloadBalloonCss
       opnn; e "The data has been stored in the file `#{sfile(store_here)}`."
     end
     open(store_here, 'wb') { |file|
-      file << open(use_this_url).read
+      file << URI.open(use_this_url).read
     }
   end