cyberweb 0.12.35 → 0.13.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1c53fd000f39b26a7d41d88ee96f5334966bd3c459e9d3d7a56bdca7aa6b7d9
-  data.tar.gz: 7e2bdd540cddec8df14a6e757085d57161a72c4c4ae2a632630924da754ecdfd
+  metadata.gz: 3b6dd07d01ef265aaf6670ff5ee915e37d8d907b88c1b626cd5b9c42d56518cf
+  data.tar.gz: 1c55ff143677e816df7239936ef804f467c86cc4f5fb07d79170275e24cec709
 SHA512:
-  metadata.gz: b930dff63b5b8ac9b1bab12a1bbaf8af205d0b736fd511a1bda8a96c89f8739b437bfe754fa191c6724743979051acf3cecdba4a7318d587a8420091f20e9021
-  data.tar.gz: '0332896062b5769f59d769429795b72ee6b6913f15adea2a395d86e7ba2a7822f15518cfc4a8e5f14d08d0900ab098bd2ffdd42a6c0dd286daf79767baa8e8f6'
+  metadata.gz: 4878604ad9243fd1c75cd65b75bdd02e0873d1de2d73e8ceeb7c5363d8b9fe124cb88e7915c5fc3a1e303ff6977d511e9aaf50550f326b8d4bfcd35460e78987
+  data.tar.gz: d4fd10cddf1c13fc27591bef08a4b9d502117110a81eb136b5bdc7ba6345a1b38872eb08a45894defb9568f8bdfd87f875ed90e01e4e8da5bf70c6acb993d780

data/README.md

@@ -2,11 +2,11 @@
 [![forthebadge](https://forthebadge.com/images/badges/made-with-ruby.svg)](https://www.ruby-lang.org/en/)
 [![Gem Version](https://badge.fury.io/rb/cyberweb.svg)](https://badge.fury.io/rb/cyberweb)
 
-This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">07.01.2024</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">04:30:42</span> o'clock.
+This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">28.02.2024</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">08:49:34</span> o'clock.
 
-<img src="https://i.imgur.com/HY5BcVj.png" style="margin-left: 1.2em">
+<img src="https://i.imgur.com/r7tRkFl.png" style="margin-left: 1.2em">
 
-## Introducing the Cyberweb project
+## Introduction to the Cyberweb project
 
 The <b>cyberweb project</b> allows the user to make use of ruby to tap
 into web-related functionality in general.
@@ -2603,100 +2603,6 @@ If you want to use comments in a CSS file, use something like this:
 
     /* This is a CSS comment. */
 
-## JavaScript comments
-
-The simplest way to use comments in JavaScript, in my opinion, is
-via:
-
-    /* This is a comment */
-
-## JavaScript loops
-
-To do a loop in "modern" JavaScript, try:
-
-    for (let i = 0; i < 5; ++i) {
-      /* do stuff here */
-    }
-
-The index variable <b>i</b> will remain completely local to the
-block, and not appear outside of it.
-
-Note that JavaScript also allows you to use a .forEach loop instead,
-which no longer requires of you to use an index-counter.
-
-There are a few variations possible for the .forEach() loop.
-
-A somewhat verbose variant is the following one:
-
-    array.forEach(
-      function(entry) {
-        document.write(
-          "<img style=\"margin: 2px; margin-bottom: 5px\" src=\""+entry.replace(/^(\/home\/x\/data\/images\/fotos\/)/,"")+
-          "\"><br>\n"
-        )
-        document.write('<br>')
-      }
-    );
-
-Here we can easily use multiple lines.
-
-A shorter variant exists via the => arrow.
-
-Example for this:
- 
-    array.forEach(entry => console.log(entry));
-
-So this is basically like <b>pp</b> in ruby.
-
-## Checking for specific keys pressed, via JavaScript
-
-You can obtain an event, and then call the method .code on it, such as via:
-
-    if (e.code === 'ArrowLeft') { # For the left-arrow key.
-    }
-    if (e.code === 'ArrowRight') { # For the right-arrow key.
-    }
-
-## Symbols in JavaScript
-
-To define a symbol in JavaScript, use Symbol() such as in:
-
-    let symbol1 = Symbol("mysymbol1")
-
-## String concatenation in JavaScript
-
-The simplest way to concatenate two Strings in JavaScript
-is by using the <b>+</b> operator.
-
-Example for this:
-
-    foobar = "foo" + "bar"
-
-You can append to an existing String via the <b>+=</b> operator.
-
-Example for this:
-
-    foobar  = "foo"
-    foobar += "bar"
-
-You can also use the method .concat(), such as in:
-
-    foo    = "foo"
-    foobar = foo.concat("bar")
-
-## Obtaining user input in JavaScript
-
-The following code example shows how to obtain user input via JavScript:
-
-    var x, y;
-    x = prompt("Gib mal eine Zahl ein","")
-    y = prompt("Gib mir noch eine Zahl","")
-    alert(Number(x)+Number(y)
-
-So the primary way to obtain user through JavaScript goes via
-<b>window.prompt</b>. The second argument to that method 
-specifies the default value of the input-field.
-
 ## CSS font-face property (in CSS3)
 
 Via the <b>@font-face</b> property it is possible to make use of
@@ -4269,6 +4175,168 @@ also use onclick="call_function_here()", but one advantage of using
 event listeners is that we can be more flexible, and even remove
 events again.
 
+### JavaScript comments
+
+The simplest way to use comments in JavaScript, in my opinion, is
+via:
+
+    /* This is a comment */
+
+### JavaScript loops
+
+To do a loop in "modern" JavaScript, try:
+
+    for (let i = 0; i < 5; ++i) {
+      /* do stuff here */
+    }
+
+The index variable <b>i</b> will remain completely local to the
+block, and not appear outside of it.
+
+Note that JavaScript also allows you to use a .forEach loop instead,
+which no longer requires of you to use an index-counter.
+
+There are a few variations possible for the .forEach() loop.
+
+A somewhat verbose variant is the following one:
+
+    array.forEach(
+      function(entry) {
+        document.write(
+          "<img style=\"margin: 2px; margin-bottom: 5px\" src=\""+entry.replace(/^(\/home\/x\/data\/images\/fotos\/)/,"")+
+          "\"><br>\n"
+        )
+        document.write('<br>')
+      }
+    );
+
+Here we can easily use multiple lines.
+
+A shorter variant exists via the => arrow.
+
+Example for this:
+ 
+    array.forEach(entry => console.log(entry));
+
+So this is basically like <b>pp</b> in ruby.
+
+### Checking for specific keys pressed, via JavaScript
+
+You can obtain an event, and then call the method .code on it, such as via:
+
+    if (e.code === 'ArrowLeft') { # For the left-arrow key.
+    }
+    if (e.code === 'ArrowRight') { # For the right-arrow key.
+    }
+
+### Converting Strings to Numbers in JavaScript
+
+To convert a String such as "5" to the Integer 5, use:
+
+    x = "5"
+    parseInt(x)
+
+To convert a String such as "5.15" to the Float 5.15, use:
+
+    x = "5.15"
+    parseFloat(x)
+
+Numbers can be converted to a String via the method
+<b>toString()</b>.
+
+You can then also use the comparison operator, aka <b>===</b>:
+
+    a = parseInt("3");
+    b = parseInt("5");
+    a === b
+
+### Setting a default value to a variable in JavaScript
+
+    let foobar = object.method1 || 'Default Value here'
+
+### Using the switch statement in JavaScript
+
+Usage example:
+
+    switch(expression){
+    case x:
+      /* code to run when expression === x */
+      break;
+    case y:
+      /* code to run when expression === y */
+      break;
+    default:
+      /* code to run if nothing else matches expression */
+    }
+
+### Symbols in JavaScript
+
+To define a symbol in JavaScript, use Symbol() such as in:
+
+    let symbol1 = Symbol("mysymbol1")
+
+### String concatenation in JavaScript
+
+The simplest way to concatenate two Strings in JavaScript
+is by using the <b>+</b> operator.
+
+Example for this:
+
+    foobar = "foo" + "bar"
+
+You can append to an existing String via the <b>+=</b> operator.
+
+Example for this:
+
+    foobar  = "foo"
+    foobar += "bar"
+
+You can also use the method .concat(), such as in:
+
+    foo    = "foo"
+    foobar = foo.concat("bar")
+
+### Obtaining user input in JavaScript
+
+The following code example shows how to obtain user input via JavScript:
+
+    var x, y;
+    x = prompt("Gib mal eine Zahl ein","")
+    y = prompt("Gib mir noch eine Zahl","")
+    alert(Number(x)+Number(y)
+
+So the primary way to obtain user through JavaScript goes via
+<b>window.prompt</b>. The second argument to that method 
+specifies the default value of the input-field.
+
+### Creating an Array in JavaScript
+
+The easiest way is the following:
+
+    const array = ['red','green','blue'] # This is also called the Array literal notation.
+
+Note that at the least two additional ways exist in JavaScript
+to create an Array.
+
+You can use:
+
+The Array() constructor, aka:
+
+    new Array();
+
+and
+
+<b>Functions</b> that <b>return arrays</b>, such as <b>split()</b>.
+
+Note that you can, of course, also pass in elements into the
+Array when you create it via <b>new</b>. The following example
+shows this:
+
+    const array = new Array('January','February','March')
+
+Personally I prefer the [] variant, as Ruby also uses it
+and I have become so used to it.
+
 ### Appending and Prepending onto a JavaScript Array
 
 The method .push() can be used to add content, via an append-operation, onto an array.
@@ -4280,6 +4348,16 @@ If you wish to add elements onto the beginning of an Array, use
 
     new_array.unshift("foobar"); /* Adds "foobar" to the beginning of the Array */
 
+## Splitting a String into an Array, in JavaScript
+
+You can use the .split() method on a String, to split it up into an
+Array.
+
+Example for this:
+
+    let x = 'Foo, Bar, Bla'
+    const splitted = x.split(',')
+
 ### Simplified for-loop in JavaScript
 
 You can iterate over an Array in JavaScript via:
@@ -6198,7 +6276,8 @@ optionally also all subdirectories). This was added in November
 
 ## Automatic clipboard button
 
-class Cyberweb::HtmlTemplate has a method called .return_copy_to_clipboard_button().
+<b>class Cyberweb::HtmlTemplate</b> has a method called
+<b>.return_copy_to_clipboard_button()</b>.
 
 This method can be used to insert a button into a webpage. When the user
 clicks that button a certain text will be inserted into the clipboard,
@@ -6245,6 +6324,34 @@ a local .html file).
 Unfortunately I broke it in November 2023. Will have to fix it,
 and probably rewrite it, anyway.
 
+## module WebBase
+
+module WebBase was created before the project html_tags was started,
+and before objectified-html-tags were added. So in some ways this
+was a legacy-module.
+
+In January 2024, the old code from <b>module WebBase</b> was integrated
+into the objectified HTML tags component. Then the old WebBase namespace
+was removed.
+
+Note that as part of the rewrite, each individual class that is
+part of the module Cyberweb::Objectified::HtmlTags, will
+contain a toplevel instance variable called @css_class. This
+derived from the old code in WebBase, where we could specify
+a default CSS class to be used - which is now defined under
+@css_class. This can be accessed by the toplevel method
+.css_class?. (Should you discover a class that does not have
+this, consider it a bug; it will be added once reported.)
+
+The old functionality in module WebBase, in where we could set
+a default CSS class, has been retained API-wise. Example for
+how to use this:
+
+    Cyberweb::Span.set_css_class 'padl5em green'
+
+Keep in mind that internally this will delegate towards the
+<b>Objectified namespace</b>.
+
 ## Useful quotes when designing websites and web-apps
 
 The following subsection collects a few <b>interesting statements</b> - kind
@@ -6312,7 +6419,11 @@ the current location that the user has or uses on that website</i>.“
 „<i>Ideally a website should convey the big picture, and make it clear what the
 site is about</i>.“
 
-„<i>The web as a dynamic computing environment</i>.“
+„<i>The web can be considered a dynamic computing environment</i>.“
+
+„<i>Good design is easier to change than bad design</i>.“
+
+„<i>Build documentation in - don't bolt it on</i>.“
 
 „<i>If possible consider to use visual identifiers on the whole web-application at
 hand, to give visitors the right idea about this being a cohesive and integrated
@@ -6401,29 +6512,14 @@ gem owner eventually:
 see
 https://blog.rubygems.org/2022/06/13/making-packages-more-secure.html
 
-Mandatory 2FA will eventually be extended to all rubygems.org developers and
-maintainers. As I can not use 2FA, for reasons I will skip explaining here,
-this means that my projects will eventually be removed, as I no longer
-have any control over my projects hosted on rubygems.org (because I
-can not use 2FA).
-
-At that point, I no longer have any control what is done to my projects
-since whoever is controlling the gems ecosystem took away our control
-here. I am not sure at which point ruby became corporate-controlled -
-that was not the case several years ago, so something has
-changed.
-
-Ruby also only allows 2FA users to participate on the issue tracker these
-days:
-
-  https://bugs.ruby-lang.org/issues/18800
-
-But this has been reverted some months ago, so it is no longer applicable.
-Suffice to say that I do not think that we should only be allowed to
-interact on the world wide web when some 'authority' authenticated us,
-such as via mandatory 2FA, so I hope this won't come back again.
-
-Fighting spam is a noble goal, but when it also means you lock out
-real human people then this is definitely NOT a good situation
-to be had.
+However had, that has been reverted again, so I decided to shorten
+this paragraph. Mandatory 2FA may exclude users who do not have a 
+smartphone device or other means to 'identify'. I do not feel it is
+a fair assumption by others to be made that non-identified people may
+not contribute code, which is why I reject it. Mandatory 2FA would mean
+an end to all my projects on rubygems.org, so let's hope it will never
+happen. (Keep in mind that I refer to mandatory 2FA; I have no qualms
+for people who use 2FA on their own, but this carrot-and-stick strategy
+by those who control the rubygems infrastructure is a very bad one to
+pursue.
 

data/bin/cyberweb_sanitize

@@ -2,7 +2,7 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-require 'cyberweb/toplevel_methods/misc.rb'
+require 'cyberweb/toplevel_methods/toplevel_methods.rb'
 require 'save_file'
 
 what = Cyberweb.sanitizer(ARGV)

data/bin/images_from_this_webpage

@@ -4,7 +4,7 @@
 # =========================================================================== #
 # images_from_this_webpage
 # =========================================================================== #
-require 'cyberweb/toplevel_methods/misc.rb'
+require 'cyberweb/toplevel_methods/toplevel_methods.rb'
 
 Cyberweb.return_all_images_from_this_webpage(ARGV, true).each {|this_remote_image|
   puts this_remote_image