cyberweb 0.4.174

data/lib/cyberweb/objectified_html_tags/a.rb

@@ -0,0 +1,129 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::ObjectifiedHtmlTags::A
+# =========================================================================== #
+# require 'cyberweb/objectified_html_tags/a.rb'
+# =========================================================================== #
+require 'cyberweb/objectified_html_tags/base.rb'
+
+module Cyberweb
+
+module ObjectifiedHtmlTags
+
+class A < Base # === Cyberweb::ObjectifiedHtmlTags::A
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # Usage example:
+  #
+  #   Cyberweb::ObjectifiedHtmlTags::A.new(i)
+  #
+  # ========================================================================= #
+  def initialize(
+      use_this_text = ''
+    )
+    reset
+    set_content(use_this_text)
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @result
+    # ======================================================================= #
+    @result = ''.dup
+    # ======================================================================= #
+    # === @options
+    # ======================================================================= #
+    @options = {}
+  end
+
+  # ========================================================================= #
+  # === id=
+  #
+  # Usage example:
+  #
+  #   a.id = 'ask_a_question'
+  #
+  # ========================================================================= #
+  def id=(i)
+    @options[:id] = i
+  end
+
+  # ========================================================================= #
+  # === name=
+  #
+  # Usage example:
+  #
+  #   a.name = 'ask_a_question'
+  #
+  # ========================================================================= #
+  def name=(i)
+    @options[:name] = i
+  end
+
+  # ========================================================================= #
+  # === rebuild_the_result
+  # ========================================================================= #
+  def rebuild_the_result
+    @result = '<a'.dup
+    # ========================================================================= #
+    # === :class
+    #
+    # This adds the CSS class at hand.
+    # ========================================================================= #
+    if @css_class and !@css_class.empty?
+      @result << " #{return_css_class}"
+    end
+    # ========================================================================= #
+    # === :id
+    # ========================================================================= #
+    if @options.has_key? :id
+      @result << ' id="'+@options[:id].to_s+'"'
+    end
+    # ========================================================================= #
+    # === @css_style
+    # ========================================================================= #
+    unless @css_style.empty?
+      @result << " #{return_css_style(@css_style)}"
+    end
+    @result << ' href="'+@content.to_s+'">'
+    @result << "\n"
+    @result << @content.to_s
+    @result << "\n"
+    @result << '</a>'+"\n"  
+  end
+
+  # ========================================================================= #
+  # === to_str
+  # ========================================================================= #
+  def to_str
+    rebuild_the_result
+    @result
+  end; alias to_s to_str # === to_s
+
+end; end
+
+# =========================================================================== #
+# === html_a
+# =========================================================================== #
+def html_a(i = ARGV)
+  return Cyberweb::ObjectifiedHtmlTags::A.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  a = Cyberweb::ObjectifiedHtmlTags::A.new('derstandard.at')
+  a.id = 'hover_transition'
+  a.css_class = 'rounded_border_8px wid100 bblack2'
+  a.css_style = 'font-size: 3em'
+  e a
+end

data/lib/cyberweb/objectified_html_tags/abbr.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::ObjectifiedHtmlTags::Abbr
+# =========================================================================== #
+# require 'cyberweb/objectified_html_tags/abbr.rb'
+# =========================================================================== #
+require 'cyberweb/objectified_html_tags/base.rb'
+
+module Cyberweb
+
+module ObjectifiedHtmlTags
+
+class Abbr < Base # === Cyberweb::ObjectifiedHtmlTags::Abbr
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # Usage example:
+  #
+  #   Cyberweb::ObjectifiedHtmlTags::Abbr.new(i)
+  #
+  # ========================================================================= #
+  def initialize(
+      use_this_text         = '',
+      use_this_as_the_title = ''
+    )
+    reset
+    set_content(use_this_text)
+    set_title(use_this_as_the_title)
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @result
+    # ======================================================================= #
+    @result = ''.dup
+  end
+
+  # ========================================================================= #
+  # === align_to_the_left
+  # ========================================================================= # 
+  def align_to_the_left
+    @options[:alignment] = :left
+    to_str
+  end
+
+  # ========================================================================= #
+  # === rebuild_the_result
+  # ========================================================================= #
+  def rebuild_the_result
+    @result = '<abbr'.dup
+    unless @css_style.empty?
+      @result << " #{return_css_style(@css_style)}"
+    end
+    if title?
+      @result << ' title="'+title?+'"'
+    end
+    @result << '>'
+    @result << content?
+    @result << '</abbr>'
+  end
+
+  # ========================================================================= #
+  # === to_str
+  # ========================================================================= #
+  def to_str
+    rebuild_the_result
+    @result
+  end; alias to_s to_str # === to_s
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e 'The '+
+    Cyberweb::ObjectifiedHtmlTags::Abbr.new('WHO','World Health Organization')+
+    ' was founded in 1948.'
+end

data/lib/cyberweb/objectified_html_tags/base.rb

@@ -0,0 +1,376 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Cyberweb::ObjectifiedHtmlTags::Base
+# =========================================================================== #
+# require 'cyberweb/objectified_html_tags/base.rb'
+# < Cyberweb::ObjectifiedHtmlTags::Base
+# =========================================================================== #
+module Cyberweb
+
+module ObjectifiedHtmlTags
+
+class Base # === Cyberweb::ObjectifiedHtmlTags::Base
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @result
+    #
+    # This is the String that will be output / stored.
+    # ======================================================================= #
+    @result = ''.dup
+    # ======================================================================= #
+    # === @content
+    # ======================================================================= #
+    @content = ''.dup
+    # ======================================================================= #
+    # === @css_style
+    # ======================================================================= #
+    @css_style = ''.dup
+    # ======================================================================= #
+    # === @css_class
+    # ======================================================================= #
+    @css_class = ''.dup
+    # ======================================================================= #
+    # === @internal_hash
+    # ======================================================================= #
+    @internal_hash = {}
+    # ======================================================================= #
+    # === :is_draggable
+    # ======================================================================= #
+    @internal_hash[:is_draggable] = false
+    # ======================================================================= #
+    # === :id
+    # ======================================================================= #
+    @internal_hash[:id] = nil
+    # ======================================================================= #
+    # === :title
+    #
+    # Must be nil initially.
+    # ======================================================================= #
+    @internal_hash[:title] = nil
+  end
+
+  # ========================================================================= #
+  # === id
+  # ========================================================================= #
+  def id(i)
+    @internal_hash[:id] = i
+  end
+
+  # ========================================================================= #
+  # === id?
+  # ========================================================================= #
+  def id?
+    @internal_hash[:id]
+  end
+
+  # ========================================================================= #
+  # === is_draggable
+  # ========================================================================= #
+  def is_draggable
+    @internal_hash[:is_draggable] = true
+  end
+
+  # ========================================================================= #
+  # === is_draggable?
+  # ========================================================================= #
+  def is_draggable?
+    @internal_hash[:is_draggable]
+  end
+
+  # ========================================================================= #
+  # === bblack1
+  # ========================================================================= #
+  def bblack1
+    @css_class << ' bblack1' unless @css_class.include? 'bblack1'
+  end
+
+  # ========================================================================= #
+  # === bblack2
+  # ========================================================================= #
+  def bblack2
+    @css_class << ' bblack2' unless @css_class.include? 'bblack2'
+  end
+
+  # ========================================================================= #
+  # === bblack3
+  # ========================================================================= #
+  def bblack3
+    @css_class << ' bblack3' unless @css_class.include? 'bblack3'
+  end
+
+  # ========================================================================= #
+  # === bblack4
+  # ========================================================================= #
+  def bblack4
+    @css_class << ' bblack4' unless @css_class.include? 'bblack4'
+  end
+
+  # ========================================================================= #
+  # === bblack5
+  # ========================================================================= #
+  def bblack5
+    @css_class << ' bblack5' unless @css_class.include? 'bblack5'
+  end
+
+  # ========================================================================= #
+  # === bblack6
+  # ========================================================================= #
+  def bblack6
+    @css_class << ' bblack6' unless @css_class.include? 'bblack6'
+  end
+
+  # ========================================================================= #
+  # === set_css_class
+  #
+  # Usage example:
+  #
+  #   textarea.class = 'rounded_border_6px bblack1 FS2em pad8px'
+  #
+  # ========================================================================= #
+  def set_css_class(i)
+    @css_class = i
+  end; alias class=     set_css_class # === class=
+       alias css_class= set_css_class # === css_class=
+       alias css_class  set_css_class # === css_class
+
+  # ========================================================================= #
+  # === attach
+  #
+  # This method will simply append to @content.
+  # ========================================================================= #
+  def attach(i)
+    if i.is_a? Symbol
+      # ===================================================================== #
+      # Symbols are treated as method calls.
+      # ===================================================================== #
+      i = send(i)
+    end
+    i = i.to_s
+    @content = @content.dup if @content.frozen?
+    @content << i
+  end; alias add attach # === attach
+
+  # ========================================================================= #
+  # === pad
+  # ========================================================================= #
+  def pad
+    @css_style.rstrip!
+    @css_style << ' pad0_5em'
+  end
+
+  # ========================================================================= #
+  # === return_css_style
+  # ========================================================================= #
+  def return_css_style(
+      i = @css_style
+    )
+    'style="'+i.to_s.strip+'"'
+  end
+
+  # ========================================================================= #
+  # === return_css_class
+  # ========================================================================= #
+  def return_css_class(
+      i = @css_class
+    )
+    'class="'+i.to_s.strip+'"'
+  end
+
+  # ========================================================================= #
+  # === pad1px
+  # ========================================================================= #
+  def pad1px
+    @css_class.rstrip!
+    @css_class << ' pad1px'
+  end
+
+  # ========================================================================= #
+  # === pad2px
+  # ========================================================================= #
+  def pad2px
+    @css_class.rstrip!
+    @css_class << ' pad2px'
+  end
+
+  # ========================================================================= #
+  # === pad3px
+  # ========================================================================= #
+  def pad3px
+    @css_class.rstrip!
+    @css_class << ' pad3px'
+  end
+
+  # ========================================================================= #
+  # === pad4px
+  # ========================================================================= #
+  def pad4px
+    @css_class.rstrip!
+    @css_class << ' pad4px'
+  end
+
+  # ========================================================================= #
+  # === pad5px
+  # ========================================================================= #
+  def pad5px
+    @css_class.rstrip!
+    @css_class << ' pad5px'
+  end
+
+  # ========================================================================= #
+  # === pad6px
+  # ========================================================================= #
+  def pad6px
+    @css_class.rstrip!
+    @css_class << ' pad6px'
+  end
+
+  # ========================================================================= #
+  # === pad7px
+  # ========================================================================= #
+  def pad7px
+    @css_class.rstrip!
+    @css_class << ' pad7px'
+  end
+
+  # ========================================================================= #
+  # === pad8px
+  # ========================================================================= #
+  def pad8px
+    @css_class.rstrip!
+    @css_class << ' pad8px'
+  end
+
+  # ========================================================================= #
+  # === pad9px
+  # ========================================================================= #
+  def pad9px
+    @css_class.rstrip!
+    @css_class << ' pad9px'
+  end
+
+  # ========================================================================= #
+  # === pad10px
+  # ========================================================================= #
+  def pad10px
+    @css_class.rstrip!
+    @css_class << ' pad10px'
+  end
+
+  # ========================================================================= #
+  # === set_css_style
+  # ========================================================================= #
+  def set_css_style(i)
+    @css_style = i
+  end; alias style=     set_css_style # === style=
+       alias css_style= set_css_style # === css_style=
+       alias style      set_css_style # === style
+
+  # ========================================================================= #
+  # === set_content
+  #
+  # Store the content of the HTML tag at hand via the following method.
+  #
+  # Note that Arrays will NOT become Strings. The reason why that is the
+  # case is that some HTML elements, such as the html-dropbox, need an
+  # Array as input, not a String.
+  #
+  # This method currently has two aliases, but it is not certain whether
+  # these will be retained (comment here made in October 2021) - the
+  # future will show.
+  # ========================================================================= #
+  def set_content(i)
+    i = i.to_s.dup unless i.is_a? Array
+    @content = i
+  end; alias inject set_content # === inject
+       alias <<     set_content # === <<
+       alias value= set_content # === value?
+
+  # ========================================================================= #
+  # === set_title
+  # ========================================================================= #
+  def set_title(i)
+    @internal_hash[:title] = i
+  end
+
+  # ========================================================================= #
+  # === title?
+  #
+  # This method must be guaranteed to return a String. Keep in mind
+  # that the title may be empty, though, so it is best to check in
+  # the downstream code base whether a title-tag was set or not.
+  # ========================================================================= #
+  def title?
+    @internal_hash[:title].to_s
+  end
+
+  # ========================================================================= #
+  # === content?
+  # ========================================================================= #
+  def content?
+    if @content.is_a? Array # Arrays are allowed - everything else will be a String.
+      @content
+    else
+      @content.to_s # Ensure the result to be a String here.
+    end
+  end
+
+  # ========================================================================= #
+  # === report                                                   (report tag)
+  # ========================================================================= #
+  def report
+    _ = to_str
+    if _.is_a? Array
+      _ = _.join(' ').strip
+    end
+    print _
+  end; alias display report # === display
+
+  # ========================================================================= #
+  # === to_str
+  # ========================================================================= #
+  def to_str
+    rebuild_the_result
+    @result
+  end; alias to_s to_str # === to_s
+
+  # ========================================================================= #
+  # === append_onto_the_css_class
+  # ========================================================================= #
+  def append_onto_the_css_class(i)
+    @css_class << " #{i}"
+    @css_class.strip!
+  end; alias acss                append_onto_the_css_class # === acss
+       alias append_to_css_class append_onto_the_css_class # === append_to_css_class
+
+  # ========================================================================= #
+  # === Cyberweb::ObjectifiedHtmlTags::Base.report
+  #
+  # This method can be used to quickly display the content of the OOP
+  # HTML tag at hand.
+  #
+  # Usage example:
+  #
+  #   Cyberweb::ObjectifiedHtmlTags::Title.report('This is a HTML website.')
+  #   Cyberweb::ObjectifiedHtmlTags::Abbr.report('tRNA','transfer RNA')
+  #
+  # ========================================================================= #
+  def self.report(i, optional_arguments = nil)
+    use_this_class = Cyberweb::ObjectifiedHtmlTags.const_get(inspect)
+    n_arguments = use_this_class.instance_method(:initialize).parameters.size
+    case n_arguments
+    when 1
+      print use_this_class.new(i).to_str
+    when 2
+      print use_this_class.new(i, optional_arguments).to_str
+    else
+      raise  StandardError.new('Unhandled number of parameters.')
+    end
+  end
+
+end; end; end