cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/base/misc.rb

@@ -8,6 +8,58 @@ module Cyberweb
 
 class Base # === Cyberweb::Base
 
+  # ========================================================================= #
+  # === read_file_via_utf8_encoding
+  # ========================================================================= #
+  def read_file_via_utf8_encoding(i)
+    return File.open(i, 'r:UTF-8', &:read)
+  end
+
+  # ========================================================================= #
+  # === is_an_image_file?
+  # ========================================================================= #
+  def is_an_image_file?(i)
+    ::Cyberweb.is_an_image_file?(i)
+  end; alias is_an_image? is_an_image_file? # === is_an_image?
+
+  # ========================================================================= #
+  # === remove_comments_from_this_string
+  #
+  # This method will remove all leading "#" comments from the given
+  # String, up to each end of the given line.
+  # ========================================================================= #
+  def remove_comments_from_this_string(i)
+    return i.gsub(/^\s*#.+$/,'')
+  end
+
+  # ========================================================================= #
+  # === remove_comments_from_this_string_but_preserve_CSS_rules
+  #
+  # This method is similar to remove_comments_from_this_string() but it
+  # will specifically retain "{}" such as in "#smoke_1 {".
+  # ========================================================================= #
+  def remove_comments_from_this_string_but_preserve_CSS_rules(i)
+    use_this_regex = /^\s*#.+[^{]$/ # See: https://rubular.com/r/bz3BDrVynbtTwH
+    return i.gsub(use_this_regex,'')
+  end
+
+  # ========================================================================= #
+  # === be_verbose
+  # ========================================================================= #
+  def be_verbose
+    @be_verbose = true
+  end # Whether we will be verbose or not.
+
+  # ========================================================================= #
+  # === is_image?
+  #
+  # This method will return true if the input is an image, otherwise it
+  # will yield false.
+  # ========================================================================= # 
+  def is_image?(this_file)
+    ::Cyberweb.is_image?(this_file)
+  end; alias is_an_image? is_image? # === is_an_image?
+
   # ========================================================================= #
   # === html_image
   #
@@ -18,42 +70,28 @@ class Base # === Cyberweb::Base
       i = ::Cyberweb::WebImages.map_symbol_to_image_location(i).dup
       i.prepend(full_path_to_image_directory?)
     end
-    return Cyberweb::ObjectifiedHtmlTags::Img.new(i)
+    return Cyberweb::Objectified::HtmlTags::Img.new(i)
   end; alias html_img html_image # === html_img
 
-  # ========================================================================= #
-  # === full_path_to_image_directory?
-  #
-  # Convenience method towards the images.
-  # ========================================================================= #
-  def full_path_to_image_directory?
-    ::Cyberweb.path_to_images?
-  end; alias path_to_the_main_image_directory? full_path_to_image_directory? # === path_to_the_main_image_directory?
-       alias path_to_the_image_directory?      full_path_to_image_directory? # === path_to_the_image_directory?
-
   require 'cyberweb/toplevel_methods/name_of_img_dir.rb'
   # ========================================================================= #
   # === name_of_img_dir?
   #
-  # This method will return a string such as "DATA/images/".
+  # This method will return a string such as "data/images/".
   # ========================================================================= #
   def name_of_img_dir?
     "#{::Cyberweb.name_of_img_dir?}/".squeeze '/'
   end
 
   # ========================================================================= #
-  # === remove_comments_from_this_string
-  # ========================================================================= #
-  def remove_comments_from_this_string(i)
-    i.gsub(/^\s*#.+$/,'')
-  end
-
-  # ========================================================================= #
-  # === return_date
+  # === full_path_to_image_directory?
+  #
+  # Convenience method towards the images.
   # ========================================================================= #
-  def return_date
-    Time.now.strftime '%d.%m.%Y'
-  end
+  def full_path_to_image_directory?
+    ::Cyberweb.path_to_images?
+  end; alias path_to_the_main_image_directory? full_path_to_image_directory? # === path_to_the_main_image_directory?
+       alias path_to_the_image_directory?      full_path_to_image_directory? # === path_to_the_image_directory?
 
   require 'cyberweb/toplevel_methods/filename.rb'
   # ========================================================================= #
@@ -63,14 +101,6 @@ class Base # === Cyberweb::Base
     ::Cyberweb.filename?.to_s
   end
 
-  require 'cyberweb/toplevel_methods/return_pwd.rb'
-  # ========================================================================= #
-  # === return_pwd
-  # ========================================================================= #
-  def return_pwd
-    ::Cyberweb.return_pwd
-  end
-
   # ========================================================================= #
   # === remove_file
   # ========================================================================= #
@@ -96,18 +126,6 @@ class Base # === Cyberweb::Base
     return ::Cyberweb.css_comment(i)
   end
 
-  # ========================================================================= #
-  # === opnn
-  # ========================================================================= #
-  def opnn(
-      namespace = NAMESPACE
-    )
-    if namespace.is_a? String # Convert String object into Hash object here.
-      namespace = { namespace: namespace }
-    end
-    Opn.opn(namespace)
-  end
-
   # ========================================================================= #
   # === delete_directory
   #
@@ -166,16 +184,6 @@ class Base # === Cyberweb::Base
     COPYRIGHT_SYMBOL
   end; alias copyright copyright? # === copyright
 
-  # ========================================================================= #
-  # === is_image?
-  #
-  # This method will return true if the input is an image, otherwise it
-  # will yield false.
-  # ========================================================================= # 
-  def is_image?(this_file)
-    ::Cyberweb.is_image?(this_file)
-  end; alias is_an_image? is_image? # === is_an_image?
-
   # ========================================================================= #
   # === e                                                             (e tag)
   #
@@ -198,6 +206,14 @@ class Base # === Cyberweb::Base
     end
   end
 
+  # ========================================================================= #
+  # === echo_raw
+  # ========================================================================= #
+  def echo_raw(i = '')
+    puts i
+  end; alias er echo_raw # === er
+       alias re echo_raw # === re
+
   # ========================================================================= #
   # === ee                                                        (print tag)
   #
@@ -236,4 +252,75 @@ class Base # === Cyberweb::Base
     @mode = :commandline
   end; alias use_commandline_mode set_commandline_mode # === use_commandline_mode
 
+  # ========================================================================= #
+  # === cd
+  # ========================================================================= #
+  def cd(i)
+    Dir.chdir(i) if File.directory?(i)
+  end
+
+  # ========================================================================= #
+  # === esystem
+  # ========================================================================= #
+  def esystem(i)
+    puts i
+    system(i)
+  end
+
+  require 'cyberweb/toplevel_methods/return_pwd.rb'
+  # ========================================================================= #
+  # === return_pwd
+  # ========================================================================= #
+  def return_pwd
+    ::Cyberweb.return_pwd
+  end
+
+  # ========================================================================= #
+  # === is_a_video_file?
+  # ========================================================================= #
+  def is_a_video_file?(i)
+    require 'cyberweb/toplevel_methods/misc.rb'
+    ::Cyberweb.is_a_video_file?(i)
+  end
+
+  # ========================================================================= #
+  # === ruby_header?
+  # ========================================================================= #
+  def ruby_header?
+    RUBY_HEADER
+  end
+
+  # ========================================================================= #
+  # === return_date
+  #
+  # This method will return a String such as "20.04.2022".
+  # ========================================================================= #
+  def return_date
+    ::Time.now.strftime '%d.%m.%Y'
+  end; alias dd_mm_yyyy return_date # === dd_mm_yyyy
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn(
+      namespace = NAMESPACE
+    )
+    if namespace.is_a? String # Convert String object into Hash object here.
+      namespace = { namespace: namespace }
+    end
+    Opn.opn(namespace)
+  end
+
+  # ========================================================================= #
+  # === cpr
+  #
+  # This method copies files recursively.
+  # ========================================================================= #
+  def cpr(
+      from, to = return_pwd
+    )
+    require 'fileutils'
+    FileUtils.cp_r(from, to)
+  end
+
 end; end

data/lib/cyberweb/base/save_file.rb

@@ -14,6 +14,9 @@ class Base
   # === write_what_into
   #
   # This is simply a wrapper over the toplevel method with the same name.
+  #
+  # For the source code have a look at the .rb file that is required above
+  # this method body.
   # ========================================================================= #
   def write_what_into(what, into)
     ::Cyberweb.write_what_into(what, into)

data/lib/cyberweb/base_module/base_module.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This is the BaseModule for functionality that many different classes in
+# the Cyberweb project can re-use. Furthermore, this can also be used by
+# other, external projects that may wish to use the same functionality.
+# =========================================================================== #
+# require 'cyberweb/base_module/base_module.rb'
+# include Cyberweb::BaseModule
+# =========================================================================== #
+module Cyberweb
+
+module BaseModule
+
+  require 'cyberweb/toplevel_methods/return_strict_doctype.rb'
+
+  # ========================================================================= #
+  # === doctype?
+  #
+  # This method will return the following String:
+  #
+  #   "<!DOCTYPE html>"
+  #
+  # ========================================================================= #
+  def doctype?
+    return "#{Cyberweb.return_strict_doctype}\n"
+  end
+
+  # ========================================================================= #
+  # === require_the_html_templates
+  # ========================================================================= #
+  def require_the_html_templates
+    require 'cyberweb/requires/require_the_html_template.rb'
+  end
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i = '')
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === append_to_the_commandline_arguments
+  # ========================================================================= #
+  def append_to_the_commandline_arguments(i)
+    @commandline_arguments << i # Simply append, without ANY checking.
+  end
+
+  # ========================================================================= #
+  # === first_argument?
+  # ========================================================================= #
+  def first_argument?
+    @commandline_arguments.first
+  end; alias first? first_argument? # === first?
+
+  # ========================================================================= #
+  # === string_remote_image
+  # ========================================================================= #
+  def string_remote_image(
+      i = :a_fat_cat
+    )
+    if i.is_a? Symbol
+      require 'beautiful_url'
+      i = BeautifulUrl.this_remote_URL(i)
+    end
+    ::HtmlTags.img(i)
+  end
+
+end; end

data/lib/cyberweb/cascading_style_sheets/border.css

@@ -4,40 +4,16 @@
  * border-radius property.
  */
 
-/*
- * border-spacing property comes next.
- */
-
-.bspace1  { border-spacing:  1pt }
-.bspace2  { border-spacing:  2pt }
-.bspace3  { border-spacing:  3pt }
-.bspace4  { border-spacing:  4pt }
-.bspace5  { border-spacing:  5pt }
-.bspace6  { border-spacing:  6pt }
-.bspace7  { border-spacing:  7pt }
-.bspace8  { border-spacing:  8pt }
-.bspace9  { border-spacing:  9pt }
-.bspace10 { border-spacing: 10pt }
-.bspace11 { border-spacing: 11pt }
-.bspace12 { border-spacing: 12pt }
-.bspace13 { border-spacing: 13pt }
-.bspace14 { border-spacing: 14pt }
-.bspace15 { border-spacing: 15pt }
-.bspace16 { border-spacing: 16pt }
-.bspace17 { border-spacing: 17pt }
-.bspace18 { border-spacing: 18pt }
-.bspace19 { border-spacing: 19pt }
-.bspace20 { border-spacing: 20pt }
-.bspace25 { border-spacing: 25pt }
-.bspace30 { border-spacing: 30pt }
-
  /*
   *
   *  border Tags, bor tags,  bord tags, bor color tags. border solid is std,
-  *  border style, bord style 
+  *  border style, bord style
+  * 
   *  { border-style: solid dotted } would mean horizontal border is solid, 
-  *  vertical is dotted 
-  *  The borders styles are:
+  *  vertical is dotted
+  * 
+  *  The available borders styles are:
+  *
   *    none,hidden,dotted,dashed,solid,double,groove,ridge,inset,outset, 
   */
 .b0               { border:0px solid black }
@@ -95,6 +71,8 @@
 .borddviol2px     { border:2px solid #51455F}
 .borddviol3px     { border:3px solid #51455F}
 .bordgold1px      { border:1px solid gold}
+.bordgold2px      { border:2px solid gold}
+.bordgold3px      { border:3px solid gold}
 .bordgreen1px     { border:1px solid green}
 .bordgreen2px     { border:2px solid green}
 .bordgreen3px     { border:3px solid green}
@@ -134,7 +112,6 @@
 .bordcred         { border-color:red}
 .bordcgreen       { border-color:green}
 .bordcgr          { border-color:green}
-.dotted_border    { border: 1px dotted black; }
 
 /* === border styles tagscolor tags, border-style tags
  * 
@@ -142,18 +119,22 @@
  *      border-color: yellow; 
  *      border-style: inset; 
  *      border-width: medium; 
+ *
+ * These have several shortcuts, such as "bo" for "bord"
+ * meaning border-style none.
  */
-.bord         { border-style:none}
-.borddot      { border-style:dotted}
-.borddas      { border-style:dashed}
-.bordsol      { border-style:solid}
-.borddou      { border-style:double}
-.bordgro      { border-style:groove}
-.bordrid      { border-style:ridge}
-.bordins      { border-style:inset}
-.bordout      { border-style:outset}
+.bord,
+.bo           { border-style: none}
+.borddot      { border-style: dotted}
+.borddas      { border-style: dashed}
+.bordsol      { border-style: solid}
+.borddou      { border-style: double}
+.bordgro      { border-style: groove}
+.bordrid      { border-style: ridge}
+.bordins      { border-style: inset}
+.bordout      { border-style: outset}
+
   /* shortcutted as above */
-.bo           { border-style:none}
 .bodot        { border-style:dotted}
 .bodas        { border-style:dashed}
 .bosol        { border-style:solid}
@@ -200,3 +181,88 @@
 .border_steelblue_3px {
   border: 3px solid steelblue;
 }
+
+/* Round Border, inspired from:
+
+     https://www.w3schools.com/howto/tryit.asp?filename=tryhow_css_round_buttons
+
+ */
+.round_border1,
+.round_border2,
+.round_border3,
+.round_border4 {
+  font-size: 1px;
+  overflow:  hidden;
+  display:   block;
+}
+
+.round_border1 {height:1px; background:#888; margin:0 5px;}
+.round_border2 {height:1px; background:#ddd; border-right:2px solid #888; border-left:2px solid #888; margin:0 3px;}
+.round_border3 {height:1px; background:#ddd; border-right:1px solid #888; border-left:1px solid #888; margin:0 2px;}
+.round_border4 {height:2px; background:#ddd; border-right:1px solid #888; border-left:1px solid #888; margin:0 1px;}
+.round_border_content  {background: #ddd; border-right:1px solid #888; border-left:1px solid #888;}
+.round_border_content2 {background: #8E6F90; border-right:2px solid #888; border-left:2px solid #888;}
+.round_border_content3 {background: #AE9CF4; border-right:2px solid #888; border-left:2px solid #888;}
+.round_border_content,
+.round_border_content2,
+.round_border_content3 div { margin-left: 5px; }
+
+.rounded_border_1px  { border-radius:  1px; }
+.rounded_border_2px  { border-radius:  2px; }
+.rounded_border_3px  { border-radius:  3px; }
+.rounded_border_4px  { border-radius:  4px; }
+.rounded_border_5px  { border-radius:  5px; }
+.rounded_border_6px  { border-radius:  6px; }
+.rounded_border_7px  { border-radius:  7px; }
+.rounded_border_8px  { border-radius:  8px; }
+.rounded_border_9px  { border-radius:  9px; }
+.rounded_border_10px { border-radius: 10px; }
+.rounded_border_11px { border-radius: 11px; }
+.rounded_border_12px { border-radius: 12px; }
+
+.bblack1_dotted,
+.dotted_border       { border: 1px dotted black }
+
+.border_1px_dotted_orange {
+  border-width: 1px;
+  border-style: dotted;
+  border-color: orange;
+}
+
+.border_1px_dotted_tomato {
+  border-width: 1px;
+  border-style: dotted;
+  border-color: tomato;
+}
+
+/*
+ * border-spacing property comes next.
+ */
+.bspace1  { border-spacing:  1pt; }
+.bspace2  { border-spacing:  2pt; }
+.bspace3  { border-spacing:  3pt; }
+.bspace4  { border-spacing:  4pt; }
+.bspace5  { border-spacing:  5pt; }
+.bspace6  { border-spacing:  6pt; }
+.bspace7  { border-spacing:  7pt; }
+.bspace8  { border-spacing:  8pt; }
+.bspace9  { border-spacing:  9pt; }
+.bspace10 { border-spacing: 10pt; }
+.bspace11 { border-spacing: 11pt; }
+.bspace12 { border-spacing: 12pt; }
+.bspace13 { border-spacing: 13pt; }
+.bspace14 { border-spacing: 14pt; }
+.bspace15 { border-spacing: 15pt; }
+.bspace16 { border-spacing: 16pt; }
+.bspace17 { border-spacing: 17pt; }
+.bspace18,
+.fancy_table_spacing,
+.fancy_table,
+.solid_table_spacing,
+.pretty_spacer {
+  border-spacing: 18pt;
+}
+.bspace19 { border-spacing: 19pt; }
+.bspace20 { border-spacing: 20pt; }
+.bspace25 { border-spacing: 25pt; }
+.bspace30 { border-spacing: 30pt; }

data/lib/cyberweb/cascading_style_sheets/colours.css

@@ -64,6 +64,7 @@
 .lightgreen_lighter{ color: #B3F2B3; }
 .linen             { color: #FAF0E6; }
 .lemonchiffon      { color: #FFFACD; }
+.lightbrown        { color: #d2691e; } /* This is actually chocolate. */
 .moccasin          { color: #FFE4B5; }
 .magenta           { color: #FF00FF; }
 .mediumblue        { color: #0000CD; }
@@ -352,38 +353,18 @@
 .go                { color: #FFD700}
 .Honey             { color: #967A0E}
 
-/* WHITEY-WHITE TAG */  
-/* ****  WHITE TAG *** ***********/
-.whi               { color: white; }
-.Whi               { color: white; }
-.white             { color: white; }
-.White             { color: white; }
-.Whitesmoke        { color: #F5F5F5}
-
   /* Combined attributes colors */
 .gold_on_black     { color: gold; background-color: black;}
 
-.BG_DGrey1         { background-color: #121212}
-.BG_DGrey2         { background-color: #191919}
-.BG_DGrey3         { background-color: #303030}
-.BG_Gray           { background-color: #cdc5c4}
-.BG_GraySTD        { background-color: #cdc5c4}
-.BG_GRAY_STD       { background-color: #cdc5c4}
-.BG_STD_GRAY       { background-color: #cdc5c4}
-.BG_STDGRAY        { background-color: #cdc5c4}
-.BG_GRAYSTD        { background-color: #cdc5c4}
-.BG_GRAYSTD2       { background-color: #c3b0ae}
-.BG_Gray1          { background-color: #cdc5c4}
-.BG_Grey1          { background-color: #cdc5c4}
-.BG_Gray2          { background-color: #a0a0a0}
-
   /* bg tag for colors */
+.BG_lightgrey      { background-color: lightgrey;}
 .BG_Beige          { background-color: beige;}
 .BG_Trans          { background-color: transparent;}
 .BG_BLACK          { background-color: #000000; }
 .BG_Bla            { background-color: #000000; }
 .BGBlack           { background-color: black;   }
 .bg_black          { background-color: #000000; }
+.BG_wheat          { background-color: wheat;   }
 .BG_Black          { background-color: #000000; }
 .BG_Black1         { background-color: #000000; }
 .BG_Black2         { background-color: #101010; }
@@ -473,4 +454,46 @@
 /* Some special background colours come next. */
 .light_black_background {
   background-color: #0e0d0f;
-}
+}
+
+.BG_very_light_yellowish,
+.BG_Yellow {
+  background-color: rgb(248, 247, 224);
+}
+
+/*
+ * Grey backgrounds.
+ */
+.BG_Grey           { background-color: lightgrey}
+.BG_DGrey1         { background-color: #121212}
+.BG_DGrey2         { background-color: #191919}
+.BG_DGrey3         { background-color: #303030}
+.BG_Gray           { background-color: #cdc5c4}
+.BG_GraySTD        { background-color: #cdc5c4}
+.BG_GRAY_STD       { background-color: #cdc5c4}
+.BG_STD_GRAY       { background-color: #cdc5c4}
+.BG_STDGRAY        { background-color: #cdc5c4}
+.BG_GRAYSTD        { background-color: #cdc5c4}
+.BG_GRAYSTD2       { background-color: #c3b0ae}
+.BG_Gray1          { background-color: #cdc5c4}
+.BG_Grey1          { background-color: #cdc5c4}
+.BG_Gray2          { background-color: #a0a0a0}
+
+/*
+ * Next specify some on-mouse-hover colours.
+ */
+.on_hover_colour_steelblue:hover {
+  background-color: steelblue;
+}
+
+.on_hover_colour_lightblue:hover {
+  background-color: lightblue;
+}
+
+/* WHITEY-WHITE TAG */  
+/* ****  WHITE TAG *** ***********/
+.whi               { color: white;   }
+.Whi               { color: white;   }
+.white             { color: white;   }
+.White             { color: white;   }
+.Whitesmoke        { color: #F5F5F5; }

data/lib/cyberweb/cascading_style_sheets/css_reset.css

@@ -0,0 +1,59 @@
+/*
+  1. Use a more-intuitive box-sizing model.
+*/
+*, *::before, *::after {
+  box-sizing: border-box;
+}
+
+/*
+  2. Remove default margin
+*/
+* {
+  margin: 0;
+}
+
+/*
+  3. Allow percentage-based heights in the application
+*/
+html, body {
+  height: 100%;
+}
+
+/*
+  Typographic tweaks!
+  4. Add accessible line-height
+  5. Improve text rendering
+*/
+body {
+  line-height: 1.5;
+  -webkit-font-smoothing: antialiased;
+}
+
+/*
+  6. Improve media defaults
+*/
+img, picture, video, canvas, svg {
+  display: block;
+  max-width: 100%;
+}
+
+/*
+  7. Remove built-in form typography styles
+*/
+input, button, textarea, select {
+  font: inherit;
+}
+
+/*
+  8. Avoid text overflows
+*/
+p, h1, h2, h3, h4, h5, h6 {
+  overflow-wrap: break-word;
+}
+
+/*
+  9. Create a root stacking context
+*/
+#root, #__next {
+  isolation: isolate;
+}