html_tags 0.1.183

data/lib/html_tags/individual_tags/em.rb

@@ -0,0 +1,99 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/em.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.em
+  # ========================================================================= #
+  def self.em(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes first
+    # ======================================================================= #
+    if css_class.is_a? Hash
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if css_class.has_key? :css_style
+        css_style = css_class.delete(:css_style)
+        if css_class.is_a?(Hash) and css_class.empty?
+          css_class = ''
+        end
+      end
+    end
+    if i.is_a? Hash
+      # ===================================================================== #
+      # Next support elements such as:
+      #   dialog(css_class: 'default') {
+      # ===================================================================== #
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if i.has_key? :id
+        the_id = i.delete(:id)
+      end
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+      end
+      i = '' # For now, we remove this.
+    end
+    content = i.to_s.dup
+    if block_given?
+      content << yield.to_s
+    end
+    # ======================================================================= #
+    # Looks better with a newline, in my opinion:
+    # ======================================================================= #
+    content << "\n" unless content.end_with? "\n"
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      content+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === em
+  # ========================================================================= #
+  def em(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    return HtmlTags.em(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e '<p>We '+HtmlTags.em('can not')+' live like this.</p>'
+end

data/lib/html_tags/individual_tags/fieldset.rb

@@ -0,0 +1,88 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# The <fieldset> tag is used to group related elements in a form.
+#
+# The <fieldset> tag draws a box around the related elements, similar
+# to a gtk-frame in the GTK toolkit.
+# =========================================================================== #
+# require 'html_tags/individual_tags/fieldset.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.fieldset
+  # ========================================================================= #
+  def self.fieldset(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes first
+    # ======================================================================= #
+    if css_class.is_a? Hash
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if css_class.has_key? :css_style
+        css_style = css_class.delete(:css_style)
+        if css_class.is_a?(Hash) and css_class.empty?
+          css_class = ''
+        end
+      end
+    end
+    content = i.to_s.dup
+    if block_given?
+      content << yield.to_s
+    end
+    # ======================================================================= #
+    # Looks better with a newline, in my opinion:
+    # ======================================================================= #
+    content << "\n" unless content.end_with? "\n"
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      content+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === fieldset
+  # ========================================================================= #
+  def fieldset(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.fieldset(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.fieldset(
+      '  <legend>Personalia:</legend>
+  <label for="fname">First name:</label>
+  <input type="text" id="fname" name="fname"><br><br>
+  <label for="lname">Last name:</label>'
+    )
+end

data/lib/html_tags/individual_tags/figure.rb

@@ -0,0 +1,42 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# Documentation for the <figure> tag can be viewed here:
+#
+#   https://developer.mozilla.org/en-US/docs/Web/HTML/Element/figure
+#
+# The HTML <figure> Element represents self-contained content, frequently
+# with a caption (<figcaption>), and is typically referenced as a single
+# unit. While it is related to the main flow, its position is independent
+# of the main flow.
+#
+# Usually this is an image, an illustration, a diagram, a code snippet, or
+# a schema that is referenced in the main text, but that can be moved to
+# another page or to an appendix without affecting the main flow.
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === figure
+  #
+  # To test this, try:
+  #
+  #   include HtmlTags; figure '<img src="/home/x/DATA/IMG/FOTOS/CATS/03.09.2003_Babykatze.jpg" alt="An awesome picture">	
+	#   <figcaption>Aisha ist noch immer müde, und sehr, sehr satt.</figcaption>'
+	#
+  # ========================================================================= #
+  def figure(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/footer.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# See also:
+#
+#   https://www.w3schools.com/tags/tag_footer.asp
+#
+# =========================================================================== #
+# require 'html_tags/individual_tags/footer.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.footer
+  #
+  # This is for the <footer> tag, HTML5.
+  # ========================================================================= #
+  def self.footer(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    content = i.to_s
+    if block_given?
+      content = content.to_s+yield.to_s
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style)+
+      "#{content}\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === footer
+  # ========================================================================= #
+  def footer(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    ::HtmlTags.footer(i, css_class, the_id, css_style, &block)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.footer(
+    '  <p>Author: Foo Bar</p>
+  <p><a href="mailto:foo@bar.com">foo@bar.com</a></p>'
+  )
+end

data/lib/html_tags/individual_tags/form.rb

@@ -0,0 +1,93 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === form
+  #
+  # This method will generate a HTML <form> tag, ultimately. The form tag
+  # is used for user-generated content, such as during a POST action
+  # during a HTTP communication.
+  #
+  # The HTML <form> element only supports GET and POST as available actions.
+  #
+  # Do note that a <form> tag is a bit more complicated than, say,
+  # a <div> tag or a <p> tag, because we may need to attach additional
+  # information towards the <form> tag, such as "id", "name" or "action"
+  # entries.
+  #
+  # Invocation examples:
+  #
+  #   form(css_style: 'margin-left:2em; margin-top:2px'){
+  #   form(action: 'bla.cgi', name: 'some_name', css_style: 'margin-left:2em; margin-top:2px'){
+  #
+  # ========================================================================= #
+  def form(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes as input given
+    # ======================================================================= #
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :action
+      #
+      # :action is presently not implemented.
+      # ===================================================================== #
+      # if i.has_key? :action
+      # end
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+      end
+    end
+    the_opening_tag = opening_tag(
+      __method__, css_class, the_id, css_style
+    )
+    # ======================================================================= #
+    # Next, add ad-hoc support for "id", "name" and "action".
+    # ======================================================================= #
+    if i.is_a? Hash
+      if i.has_key? :id
+        the_opening_tag[the_opening_tag.index('>'),0] = ' id="'+i.delete(:id).to_s+'"'
+      end
+      if i.has_key? :action
+        the_opening_tag[the_opening_tag.index('>'),0] = ' action="'+i.delete(:action).to_s+'"'
+      end
+      if i.has_key? :name
+        the_opening_tag[the_opening_tag.index('>'),0] = ' name="'+i.delete(:name).to_s+'"'
+      end
+      if i.has_key? :method
+        the_opening_tag[the_opening_tag.index('>'),0] = ' method="'+i.delete(:method).to_s+'"'
+      end
+      # ===================================================================== #
+      # Finally, if that hash is empty, turn it into an empty String.
+      # ===================================================================== #
+      if i.is_a?(Hash) and i.empty?
+        i = ''.dup
+      end
+    end
+    # ======================================================================= #
+    # Past the next step, the variable `i` will be guaranted to be a String.
+    # ======================================================================= # 
+    i = i.to_s
+    if block_given?
+      yielded = "#{yield}"
+      i << yielded
+    end
+    return HtmlTags.add(
+      the_opening_tag+
+      i+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/h1.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/h1.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.h1
+  # ========================================================================= #
+  def self.h1(
+      i               = '',
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, javascript_code)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === h1
+  # ========================================================================= #
+  def h1(
+      i               = '',
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = ''
+    )
+    return HtmlTags.h1(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/h2.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/h2.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.h2                                                  (h2 tag)
+  #
+  # This method will ultimately generate a <h2></h2> tag.
+  # ========================================================================= #
+  def self.h2(
+      i               = '',
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, javascript_code)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === h2
+  # ========================================================================= #
+  def h2(
+      i = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      javascript_code = ''
+    )
+    return HtmlTags.h2(
+      i, css_class, the_id, css_style, javascript_code
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/h3.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/h3.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.h3
+  #
+  # To test this method, try:
+  #
+  #   HtmlTags.h3(text, css_class, the_id, css_style, javascript = ''); n
+  #
+  # Keep in mind that this method can be used like this:
+  #
+  #   h3('Hello world!', css_style: 'margin-top: 2px')
+  #
+  # ========================================================================= #
+  def self.h3(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle Hashes first
+    # ======================================================================= #
+    if css_class.is_a? Hash
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if css_class.has_key? :css_style
+        css_style = css_class.delete(:css_style)
+        if css_class.is_a?(Hash) and css_class.empty?
+          css_class = ''
+        end
+      end
+    end
+    content = i.to_s
+    if block_given?
+      content << yield.to_s
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      content+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === h3
+  # ========================================================================= #
+  def h3(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.h3(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      optional_javascript,
+      &block
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/h4.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/h4.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.h4
+  # ========================================================================= #
+  def self.h4(
+      i = '', css_class = '', the_id = '', css_style = '', javascript_code = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, javascript_code)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === h4
+  # ========================================================================= #
+  def h4(
+      i = '', css_class = '', the_id = '', css_style = '', javascript_code = ''
+    )
+    return HtmlTags.h4(
+      i, css_class, the_id, css_style, javascript_code
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/h5.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/h5.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.h5
+  # ========================================================================= #
+  def self.h5(
+      i = '', css_class = '', the_id = '', css_style = '', javascript_code = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, javascript_code)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === h5
+  # ========================================================================= #
+  def h5(
+      i = '', css_class = '', the_id = '', css_style = '', javascript_code = ''
+    )
+    return HtmlTags.h5(
+      i, css_class, the_id, css_style, javascript_code
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/h6.rb

@@ -0,0 +1,40 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/h6.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.h6
+  # ========================================================================= #
+  def self.h6(
+      i               = '',
+      css_class       = '',
+      the_id          = '',
+      css_style       = '',
+      javascript_code = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, javascript_code)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === h6
+  # ========================================================================= #
+  def h6(
+      i = '', css_class = '', the_id = '', css_style = '', javascript_code = ''
+    )
+    return HtmlTags.h6(
+      i, css_class, the_id, css_style, javascript_code
+    )
+  end
+
+end