html_tags 0.1.120

data/lib/html_tags/individual_tags/br.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/br.rb'
+# =========================================================================== #
+require 'html_tags/toplevel_methods/add.rb'
+require 'html_tags/closing_tag/closing_tag.rb'
+
+module HtmlTags
+
+  # ========================================================================= #
+  # === HtmlTags.br
+  # ========================================================================= #
+  def self.br
+    return HtmlTags.add(
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === br
+  # ========================================================================= #
+  def br
+    self.br
+  end
+
+end

data/lib/html_tags/individual_tags/button.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags 
+
+  # ========================================================================= #
+  # === button
+  #
+  # This tag should yield something like:
+  #
+  #   <button type="button">Click Me!</button> 
+  #
+  # { { :value => i } }
+  # ========================================================================= #
+  def button(
+        i          = '',
+        css_class  = '',
+        the_id     = '',
+        css_style  = '',
+        javascript = ''
+      )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, javascript)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/canvas.rb

@@ -0,0 +1,19 @@
+module HtmlTags
+ 
+  # ========================================================================= #
+  # === canvas                                                   (canvas tag)
+  # ========================================================================= #
+  def canvas(
+      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/details.rb

@@ -0,0 +1,69 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/details.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.details
+  # ========================================================================= #
+  def self.details(
+      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
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      content+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === details
+  # ========================================================================= #
+  def details(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.details(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/div.rb

@@ -0,0 +1,51 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === div
+  #
+  # This method will make a html <div> tag.
+  #
+  # Invocation example:
+  #
+  #   HtmlTags.div(i = '', css_class = '', the_id = '', css_style = '')
+  # 
+  # ========================================================================= #
+  def div(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    if i.is_a? Hash
+      # ===================================================================== #
+      # Next support elements such as:
+      #   div(css_class: 'default') {
+      # ===================================================================== #
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      if i.has_key? :id
+        the_id = i.delete(:id)
+      end
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+      end
+      i = '' # For now, we remove this.
+    end
+    result = opening_tag(__method__, css_class, the_id, css_style)
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    result << yield.to_s if block_given?
+    result << i # Add the content here.
+    result << close(__method__)
+    result << "\n"
+    HtmlTags.add(result)
+  end
+
+end

data/lib/html_tags/individual_tags/figure.rb

@@ -0,0 +1,39 @@
+#!/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,26 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === footer
+  #
+  # This is for the <footer> tag, HTML5.
+  # ========================================================================= #
+  def 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+
+      close(__method__)
+    )
+  end
+
+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,36 @@
+#!/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,42 @@
+#!/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,73 @@
+#!/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, javascript_code, &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

data/lib/html_tags/individual_tags/head.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.head
+  # ========================================================================= #
+  def self.head(
+      i = ''
+    )
+    if block_given?
+      return HtmlTags.add(
+        opening_tag(__method__)+i+yield+close(__method__)
+      )
+    else # Simplified variant.
+      return HtmlTags.add(
+        opening_tag(__method__)
+      )
+    end
+  end
+
+  # ========================================================================= #
+  # === head
+  #
+  # This will create an opening tag.
+  # ========================================================================= #
+  def head(i = '')
+    HtmlTags.head(i)
+  end
+
+end