cyberweb 0.4.174

data/lib/cyberweb/toplevel_methods/date.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/date.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.date_today
+  #
+  # Simply return today's date in a form like "24.08.2014".
+  # ========================================================================= #
+  def self.date_today
+    Time.now.strftime('%d.%m.%Y')
+  end; self.instance_eval { alias return_date date_today } # === Cyberweb.return_date
+
+  # ========================================================================= #
+  # === date_today
+  #
+  # Simply return today's date in a form like "24.08.2014".
+  # ========================================================================= #
+  def date_today
+    ::Cyberweb.date_today
+  end; alias return_date date_today # === return_date
+
+  # ========================================================================= #
+  # === Cyberweb.now?
+  #
+  # Simply return the current time "right now".
+  # ========================================================================= #
+  def self.now?
+    Time.now.to_s
+  end
+
+  # ========================================================================= #
+  # === now?
+  #
+  # Simply return the current time "right now".
+  # ========================================================================= #
+  def now?
+    ::Cyberweb.now?
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.datum
+  #
+  # Display datum. The argument `welches_datum` will be empty by default
+  # and will in this case call the method date_today().
+  #
+  # Usage examples:
+  #
+  #   datum '06.08.2008','BG_Black yel wid20 pad4px', id: 'datum'
+  #
+  # ========================================================================= #
+  def self.datum(
+      welches_datum = '',
+      css_class     = 'martb4px s2px yel',
+      optional_id   = nil
+    )
+    if optional_id.is_a? Hash
+      optional_id = optional_id.delete(:id)
+    end
+    optional_id = optional_id.to_s
+    welches_datum = date_today if welches_datum.empty? # Ask the method above.
+    p(css_class,optional_id) {
+      e "<ud>Datum</ud>: #{welches_datum}"
+    }
+  end; self.instance_eval { alias show_datum datum } # === Cyberweb.show_datum
+
+end

data/lib/cyberweb/toplevel_methods/dictionary.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/dictionary.rb
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.show_dictionary_chemnitz
+  #
+  # To jump to its input, use accesskey q. Alt+q
+  # ========================================================================= #
+  def self.show_dictionary_chemnitz
+    form 'https://dict.tu-chemnitz.de/dings.cgi',
+         :def,
+         '',
+         'formular',
+         '',
+         'ISO-8859-1',
+         'application/x-www-form-urlencoded'
+      bold 'Suchwort:'
+      input :text, '','','query','','q'
+      input :submit, 'suchen','','','','l'
+    cform
+  end
+
+  # ========================================================================= #
+  # === show_dictionary
+  # ========================================================================= #
+  def show_dictionary(
+      which_one = :tu_chemnitz
+    )
+    case which_one
+    when :tu_chemnitz,
+         :default
+      show_dictionary_chemnitz
+    end
+  end
+
+  # ========================================================================= #
+  # === show_dictionary_chemnitz
+  # ========================================================================= #
+  def show_dictionary_chemnitz
+    ::Cyberweb.show_dictionary_chemnitz
+  end
+
+end

data/lib/cyberweb/toplevel_methods/disable.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/disable.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/javascript/javascript.rb'
+
+  # ========================================================================= #
+  # === Cyberweb.disable_right_click
+  #
+  # This is jquery code, which can be used to disable the right-mouse button
+  # click. Personally I dislike it very much, but because other people may
+  # wish to use it, I have decided to include it as part of the cyberweb
+  # framework.
+  #
+  # Note that for this method to work, you must have jquery enabled prior
+  # to calling it, through something such as a use_jquery() directive
+  # or use :jquery or a similar call. Or simply set the project configuration
+  # setting there.
+  # ========================================================================= #
+  def self.disable_right_click(
+      what_to_do_with_it = :output_it
+    )
+    result = return_javascript('
+$(document).ready(function(){
+  $(document).bind("contextmenu", function(e){
+    return false;
+  });
+});'+N)
+    case what_to_do_with_it
+    when :return,
+         :return_it
+      return result
+    else
+      ee result
+    end
+  end
+
+  # ========================================================================= #
+  # === disable_right_click
+  # ========================================================================= #
+  def disable_right_click
+    ::Cyberweb.disable_right_click
+  end; alias no_right_click disable_right_click # === no_right_click
+
+end

data/lib/cyberweb/toplevel_methods/document.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This here is div {} combined with hfin.
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.document                                           (doc tag)
+  #
+  # This method will combine a call to div {}, and then afterwards a
+  # call to hfin.
+  #
+  # Usage example:
+  #
+  #   document {
+  #   }
+  #
+  # ========================================================================= #
+  def self.document(
+      optional_css_class = '',
+      optional_id        = '',
+      optional_css_style = '',
+      &block
+    )
+    div(
+      optional_css_class,
+      optional_id,
+      optional_css_style
+    )
+    if block
+      block.call
+      cdiv
+    end
+    hfin
+  end; self.instance_eval { alias doc document } # === Cyberweb.document
+
+  # ========================================================================= #
+  # === document
+  # ========================================================================= #
+  def document(
+      optional_css_class = '',
+      optional_id        = '',
+      optional_css_style = '',
+      &block
+    )
+    ::Cyberweb.document(
+      optional_css_class,
+      optional_id,
+      optional_css_style,
+      &block
+    )
+  end; alias doc document # === doc
+
+end

data/lib/cyberweb/toplevel_methods/dot.rb

@@ -0,0 +1,182 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/dot.rb'
+# Cyberweb.dot(102)
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.dot                         (dot tag DOT TAG dottag. dotag.)
+  #
+  # This method will display a "dot" on the webpage.
+  #
+  # The allowed range given to the first argument, called `input`,
+  # is currently set from 1-12 and 101-112.
+  #
+  # The difference between e. g. 4 and 104 is that 104 will return a 
+  # string_img, whereas the other one will instantly return img.
+  #
+  # Invocation example:
+  #
+  #   dot 2
+  #
+  # ========================================================================= #
+  def self.dot(
+      input              = 1,
+      optional_css       = 'mars3px',
+      optional_the_id    = '',
+      optional_css_style = ''
+    )
+    if optional_css.is_a? Hash
+      # ======================================================================= #
+      # === :css_class
+      # ======================================================================= #
+      optional_css = optional_css[:css_class] if optional_css.has_key? :css_class
+    end
+    case input.to_i
+    when   1 then img :dot1,  optional_css, optional_the_id, optional_css_style
+    when   2 then img :dot2,  optional_css, optional_the_id, optional_css_style
+    when   3 then img :dot3,  optional_css, optional_the_id, optional_css_style
+    when   4 then img :dot4,  optional_css, optional_the_id, optional_css_style
+    when   5 then img :dot5,  optional_css, optional_the_id, optional_css_style
+    when   6 then img :dot6,  optional_css, optional_the_id, optional_css_style
+    when   7 then img :dot7,  optional_css, optional_the_id, optional_css_style
+    when   8 then img :dot8,  optional_css, optional_the_id, optional_css_style
+    when   9 then img :dot9,  optional_css, optional_the_id, optional_css_style
+    when  10 then img :dot10, optional_css, optional_the_id, optional_css_style
+    when  11 then img :dot11, optional_css, optional_the_id, optional_css_style
+    when  12 then img :dot12, optional_css, optional_the_id, optional_css_style
+    # ======================================================================= #
+    # Next come the string_img variants, which are as the ones above,
+    # but with an added value of +100:
+    # string_img in this context, abbreviated via sg, that this will
+    # simply return a String, which you can use to e. g. embed into
+    # a .html page or use otherwise.
+    # ======================================================================= #
+    when 101 then sg :dot1,  optional_css, optional_the_id, optional_css_style
+    when 102 then sg :dot2,  optional_css, optional_the_id, optional_css_style
+    when 103 then sg :dot3,  optional_css, optional_the_id, optional_css_style
+    when 104 then sg :dot4,  optional_css, optional_the_id, optional_css_style
+    when 105 then sg :dot5,  optional_css, optional_the_id, optional_css_style
+    when 106 then sg :dot6,  optional_css, optional_the_id, optional_css_style
+    when 107 then sg :dot7,  optional_css, optional_the_id, optional_css_style
+    when 108 then sg :dot8,  optional_css, optional_the_id, optional_css_style
+    when 109 then sg :dot9,  optional_css, optional_the_id, optional_css_style
+    when 110 then sg :dot10, optional_css, optional_the_id, optional_css_style
+    when 111 then sg :dot11, optional_css, optional_the_id, optional_css_style
+    when 112 then sg :dot12, optional_css, optional_the_id, optional_css_style
+    else
+      ewarn 'Error, `'+input.to_s+'` not found in dot() method.'
+      exit
+    end
+  end; self.instance_eval { alias d dot } # === Cyberweb.d
+
+  # ========================================================================= #
+  # === dot
+  # ========================================================================= #
+  def dot(
+      input              = 1,
+      optional_css       = 'mars3px',
+      optional_the_id    = '',
+      optional_css_style = ''
+    )
+    ::Cyberweb.dot(
+      input,
+      optional_css,
+      optional_the_id,
+      optional_css_style
+    )
+  end
+
+  # ========================================================================= #
+  # Next, we will define the short-cut methods. Rather than just dot(2),
+  # we will allow methods such as dot102.
+  # ========================================================================= #
+
+  # ========================================================================= #
+  # === dot101
+  # ========================================================================= #
+  def dot101(optional_css_class = '')
+    dot(101, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot102
+  # ========================================================================= #
+  def dot102(optional_css_class = '')
+    dot(102, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot103
+  # ========================================================================= #
+  def dot103(optional_css_class = '')
+    dot(103, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot104
+  # ========================================================================= #
+  def dot104(optional_css_class = '')
+    dot(104, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot105
+  # ========================================================================= #
+  def dot105(optional_css_class = '')
+    dot(105, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot106
+  # ========================================================================= #
+  def dot106(optional_css_class = '')
+    dot(106, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot107
+  # ========================================================================= #
+  def dot107(optional_css_class = '')
+    dot(107, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot108
+  # ========================================================================= #
+  def dot108(optional_css_class = '')
+    dot(108, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot109
+  # ========================================================================= #
+  def dot109(optional_css_class = '')
+    dot(109, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot110
+  # ========================================================================= #
+  def dot110(optional_css_class = '')
+    dot(110, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot111
+  # ========================================================================= #
+  def dot111(optional_css_class = '')
+    dot(111, optional_css_class)
+  end
+
+  # ========================================================================= #
+  # === dot112
+  # ========================================================================= #
+  def dot112(optional_css_class = '')
+    dot(112, optional_css_class)
+  end
+
+end

data/lib/cyberweb/toplevel_methods/download_webpage.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/download_webpage.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.download_webpage
+  # ========================================================================= #
+  def self.download_webpage(remote_url)
+    what = open(remote_url).read
+    into = File.basename(remote_url)
+    write_what_into(what, into)
+  end
+
+end

data/lib/cyberweb/toplevel_methods/edit_configuration_file.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/edit_configuration_file.rb'
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/constants/configuration_file.rb'
+
+  # ========================================================================= #
+  # === Cyberweb.edit_configuration_file
+  #
+  # This method allows you to edit configuration files.
+  # ========================================================================= #
+  def self.edit_configuration_file(
+      use_this_editor = 'vim'
+    )
+    _ = configuration_file?
+    puts 'Next using vim to edit'; puts
+    puts "  #{_}"
+    puts
+    system "#{use_this_editor} #{_}"
+  end
+
+end

data/lib/cyberweb/toplevel_methods/ee.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/ee.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.e
+  #
+  # Not needed as ebr is an alias to e already. The old code is still
+  # shown below, though.
+  # ========================================================================= #
+  #   def self.e(i = '')
+  #     ee "#{i}<br>"
+  #   end
+  # ========================================================================= #
+
+  # ========================================================================= #
+  # === Cyberweb.ee
+  #
+  # The method Cyberweb.ee() is essentially just a wrapper over print(),
+  # with a slight pipe token.
+  # ========================================================================= #
+  def self.ee(i = '')
+    begin
+      print i
+    rescue Errno::EPIPE
+      print '(from the file cyberweb/toplevel_methods/ee.rb): '\
+            'The pipe is broken at line 31.'
+    end
+  end
+
+  # ========================================================================= #
+  # === ee
+  #
+  # This method just taps into Cyberweb.ee().
+  # ========================================================================= #
+  def ee(i = '')
+    ::Cyberweb.ee(i)
+  end
+
+end

data/lib/cyberweb/toplevel_methods/env.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/env.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === @env
+  # ========================================================================= #
+  @env = ENV
+
+  # ========================================================================= #
+  # === Cyberweb.env?
+  # ========================================================================= #
+  def self.env?
+    @env
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.add_this_environment
+  #
+  # This method can be used to add to the default ENV variable (via the
+  # @env variable that is).
+  #
+  # The input to this method should be a Hash.
+  # ========================================================================= #
+  def self.add_this_environment(hash)
+    if hash.is_a? Hash
+      hash.each_pair {|key, value|
+        @env[key.to_s] = value.to_s
+      }
+    end
+  end; self.instance_eval { alias add_this_environment_variable add_this_environment } # === Cyberweb.add_this_environment_variable
+
+  # ========================================================================= #
+  # === Cyberweb.return_env_as_string
+  # ========================================================================= #
+  def self.return_env_as_string
+    env?.map {|key, value| "#{key}=#{value}" }.join("\n")
+  end
+
+end

data/lib/cyberweb/toplevel_methods/escape_html.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/escape_html.rb'
+# Cyberweb.escape_html
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.escape_html
+  #
+  # This is essentially the same as htmlentities(). It will remove
+  # all HTML entities from the given input string at hand.
+  #
+  # Usage example:
+  #
+  #   x = '<p>this is (&nbsp;) a test</p><div> Ok -&amp; outcome will be </div>'; y = Cyberweb.html_entities(x)
+  #
+  # ========================================================================= #
+  def self.escape_html(i)
+    modification = i.to_s
+    begin
+      modification = modification.
+                     gsub(/&/,  '&amp;').
+                     gsub(/\"/, '&quot;').
+                     gsub(/>/,  '&gt;').
+                     gsub(/</,  '&lt;')
+    rescue; end
+    return modification # Return the changes here.
+  end; self.instance_eval { alias html_escape   escape_html } # === Cyberweb.escape_html
+       self.instance_eval { alias htmlentities  escape_html } # === Cyberweb.htmlentities
+       self.instance_eval { alias html_entities escape_html } # === Cyberweb.html_entities
+       self.instance_eval { alias hescape       escape_html } # === Cyberweb.hescape
+
+  # ========================================================================= #
+  # === escape_html
+  #
+  # Simply delegate towards the class-method here.
+  # ========================================================================= #
+  def escape_html(i)
+    ::Cyberweb.escape_html(i)
+  end; alias htmlsanitize         escape_html # === htmlsanitize
+       alias return_htmlentities  escape_html # === return_htmlentities
+       alias return_htmlsanitized escape_html # === return_htmlsanitized
+       alias html_ready           escape_html # === html_ready
+       alias html_escape          escape_html # === html_escape
+       alias htitties             escape_html # === htitties
+       alias hescape              escape_html # === hescape
+       alias htmlescape           escape_html # === htmlescape
+       alias htmltitties          escape_html # === htmltitties
+       alias htmlentities         escape_html # === htmlentities (This one could be odd. Perhaps it may conflict with something else? For some reason I commented this out in the past.)
+
+end

data/lib/cyberweb/toplevel_methods/fields.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.field_with_legend
+  #
+  # This does a field with a legend (header).
+  #
+  # It looks quite nifty on a webpage - see tests.cgi for an example.
+  #
+  # Be aware that this method opens a <fieldset> tag but does not close it.
+  # If you wish to close it on your own, then you must do so manually, like
+  # by doing one of the following in the usage examples.
+  #
+  # Usage Example:
+  #
+  #   field_with_legend 'Password'
+  #   e AUSRUFUNG+'Zum Einloggen benutzt man root/root'
+  #   cfieldset
+  #
+  # Or:
+  #
+  #   div {
+  #     mini_header 'Test'
+  #       link :cpp,'CPP',1
+  #     c :mini_header
+  #   }
+  #
+  # ========================================================================= #
+  def self.field_with_legend(
+      title_of_legend = 'example',
+      css_class       = '',
+      the_id          = '',
+      css_style       = 'width: 72%',
+      javascript      = ''
+    )
+    fieldset(css_class, the_id, css_style, javascript)
+    _ = HtmlTags.legend(HtmlTags.b(title_of_legend))
+    ee _ # Print it.
+  end; self.instance_eval { alias beautiful_legend field_with_legend } # === Cyberweb.beautiful_legend 
+       self.instance_eval { alias mini_header      field_with_legend } # === Cyberweb.mini_header
+
+end

data/lib/cyberweb/toplevel_methods/filename.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/filename.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === @filename
+  #
+  # Currently this is only used for images.
+  # ========================================================================= #
+  @filename = nil
+
+  # ========================================================================= #
+  # === Cyberweb.filename?
+  # ========================================================================= #
+  def self.filename?
+    @filename
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.register_this_filename
+  #
+  # This method is currently only invoked from img() respectively
+  # string_img(), to keep track of the filename in question.
+  # ========================================================================= #
+  def self.register_this_filename(i = '')
+    @filename = File.basename(i.to_s)
+  end
+
+end