html_tags 0.1.183

data/lib/html_tags/individual_tags/mark.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/mark.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.mark
+  # ========================================================================= #
+  def self.mark(
+      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
+
+  # ========================================================================= #
+  # === mark
+  # ========================================================================= #
+  def mark(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.mark(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.mark('The Scream')
+end

data/lib/html_tags/individual_tags/menu.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# See:
+#
+#   https://www.w3schools.com/tags/tag_menu.asp
+#
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.menu                                              (menu tag)
+  #
+  # The <menu> tag defines an unordered list of content.
+  # ========================================================================= #
+  def self.menu(
+      i                   = '', # <- This is the content.
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    if i.is_a? Hash
+      # === :css_class
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      i = ''
+    end
+    i = i.to_s.dup # And avoid frozen-errors.
+    # ======================================================================= #
+    # Blocks will be assumed to be used for the first argument, `i`.
+    # ======================================================================= #
+    if block_given?
+      i << yield.to_s
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      "\n"+
+      i+
+      "\n\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === menu
+  # ========================================================================= #
+  def menu(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.menu(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      optional_javascript,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.menu('<li>Coffee</li>
+<li>Tea</li>
+<li>Milk</li>')
+end

data/lib/html_tags/individual_tags/nav.rb

@@ -0,0 +1,64 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# See also:
+#
+#   https://www.tutorialrepublic.com/html-reference/html5-nav-tag.php
+#
+# =========================================================================== #
+# require 'html_tags/individual_tags/nav.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.nav
+  # ========================================================================= #
+  def self.nav(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style)+
+      "#{i}\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === nav
+  # ========================================================================= #
+  def nav(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    return HtmlTags.nav(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.nav(
+    '    <ul>
+        <li><a href="#">Home</a></li>
+        <li><a href="#">About</a></li>
+        <li><a href="#">Contact</a></li>
+    </ul>'
+  )
+end

data/lib/html_tags/individual_tags/object.rb

@@ -0,0 +1,76 @@
+#!/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.object
+  # ========================================================================= #
+  def self.object(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    start = opening_tag(__method__, css_class, the_id, css_style).dup
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # === Handle Hashes next
+      # ===================================================================== #
+      if yielded.is_a? Hash
+        if yielded.has_key? :data
+          start[-2,0] = ' data="'+yielded.delete(:data)+'"'
+        end
+        if yielded.has_key? :width
+          start[-2,0] = ' width="'+yielded.delete(:width).to_s+'"'
+        end
+        if yielded.has_key? :height
+          start[-2,0] = ' height="'+yielded.delete(:height).to_s+'"'
+        end
+      end
+    end
+    return HtmlTags.add(
+      start+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === object
+  # ========================================================================= #
+  def object(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      &block
+    )
+    return HtmlTags.object(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.object('') {{
+    data:   'foobar.png',
+    width:  300,
+    height: 100
+  }}
+end

data/lib/html_tags/individual_tags/ol.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === ol                                                           (ol tag)
+  #
+  # This is essentially a HTML representation for the <ol> tag.
+  #
+  # The <ol> tag defines an ordered list. An ordered list can be
+  # either numerical or it can be alphabetical.
+  #
+  # The <li> tag can be used to define list items.
+  #
+  # Documentation for the <ol> tag can be seen here:
+  #
+  #   https://www.w3schools.com/tags/tag_ol.asp
+  #
+  # ========================================================================= #
+  def ol(
+      i                   = '', # <- This is the content.
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    if i.is_a? Hash
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      i = ''
+    end
+    i = i.to_s.dup # And avoid frozen-errors.
+    # ======================================================================= #
+    # Blocks will be assumed to be used for the first argument, `i`.
+    # ======================================================================= #
+    if block_given?
+      i << yield.to_s
+    end
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style, optional_javascript)+
+      i+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/p.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/p.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/toplevel_methods/add.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.p
+  #
+  # This method can be used to create the html <p> tag.
+  #
+  # A String will be returned by this method.
+  # ========================================================================= #
+  def self.p(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    use_a_trailing_newline = false
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === Handle entries such as p(css_style: 'padding:2em')
+      # ===================================================================== #
+      if i.has_key? :css_style
+        css_style = i.delete(:css_style)
+        i = '' if i.empty?
+      end
+      if i.is_a?(Hash) and i.has_key?(:css_class)
+        css_class = i.delete(:css_class)
+        i = '' if i.empty?
+      end
+    end
+    result = opening_tag(__method__, css_class, the_id, css_style).dup
+    # ======================================================================= #
+    # === Handle blocks given to this method next.
+    #
+    # Symbols will be treated differently.
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Symbol
+        case yielded
+        # =================================================================== #
+        # === :newline
+        # =================================================================== #
+        when :newline
+          use_a_trailing_newline = true
+        end
+      else
+        result << yielded.to_s
+      end
+    end
+    result << i.to_s+close(__method__).to_s
+    if use_a_trailing_newline
+      result << "\n"
+    end
+    return HtmlTags.add(result)
+  end
+
+  # ========================================================================= #
+  # === p
+  # ========================================================================= #
+  def p(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    HtmlTags.p(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.p('This is a test.','mars3em')
+  e HtmlTags.p(css_class: 'mars3em').text('This is a test.')
+end

data/lib/html_tags/individual_tags/pre.rb

@@ -0,0 +1,16 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === pre
+  # ========================================================================= #
+  def pre(
+      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/progress.rb

@@ -0,0 +1,114 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# See:
+#
+#   https://www.w3schools.com/tags/tag_progress.asp
+#
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.progress
+  # ========================================================================= #
+  def self.progress(
+      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:
+      #   progress(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
+    unless content.end_with?('%')
+      if content =~ /\d+/
+        content << '%'
+      end
+    end
+    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
+
+  # ========================================================================= #
+  # === progress
+  #
+  # This method will make a html <progress> tag.
+  #
+  # Invocation example:
+  #
+  #   HtmlTags.progress(i = '', css_class = '', the_id = '', css_style = '')
+  # 
+  # ========================================================================= #
+  def progress(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = nil
+    )
+    return HtmlTags.progress(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.progress(32)
+end

data/lib/html_tags/individual_tags/script.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === script
+  #
+  # This method will generate a <script></script> tag, for JavaScrtip.
+  # ========================================================================= #
+  def script(
+      i = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__)+
+      i.to_s+
+      close(__method__)
+    )
+  end; alias javascript script # === HtmlTags.javascript
+
+end

data/lib/html_tags/individual_tags/source.rb

@@ -0,0 +1,42 @@
+#!/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'
+
+  # ========================================================================= #
+  # === source
+  #
+  # This method should yield a tag such as:
+  #
+  #   <source src="horse.ogg" type="audio/ogg">
+  #
+  # ========================================================================= #
+  def source(
+      input_file = '',
+      type       = nil,
+      css_class  = '',
+      the_id     = '',
+      css_style  = ''
+    )
+    opening_tag = opening_tag(__method__, css_class, the_id, css_style).dup
+    if input_file and !input_file.empty?
+      opening_tag[-2,0] = ' src="'+input_file+'"'
+    end
+    if type and !type.empty?
+      opening_tag[-2,0] = ' type="'+type.to_s+'"'
+    end
+    return HtmlTags.add(opening_tag)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  include HtmlTags
+  e source('foobar.mp4')
+  e source('foobar.mp4','audio/ogg')
+end