html_tags 0.1.183

data/lib/html_tags/individual_tags/address.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/address.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/closing_tag/closing_tag.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.address
+  # ========================================================================= #
+  def self.address(
+      i = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__)+
+      "#{i}\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === address
+  # ========================================================================= #
+  def address(
+      i = '',
+      &block
+    )
+    HtmlTags.address(
+      i,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  puts HtmlTags.address(
+    'Written by <a href="mailto:webmaster@example.com">Jon Doe</a>.<br>
+Visit us at:<br>
+Example.com<br>
+Box 564, Disneyland<br>
+USA'
+  )
+end

data/lib/html_tags/individual_tags/area.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/area.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/closing_tag/closing_tag.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.area
+  #
+  # This should create a String such as:
+  #
+  #   <area shape="rect" coords="34,44,270,350" alt="Computer" href="computer.htm">
+  #
+  # Invocation example:
+  #
+  #   HtmlTags.area('rect','20,40,50,80','foobar.html')
+  #
+  # ========================================================================= #
+  def self.area(
+      shape  = 'rect',
+      coords = '34,44,270,350',
+      href   = 'foobar.html'
+    )
+    return HtmlTags.add(
+      '<area shape="'+shape.to_s+'" coords="'+coords.to_s+'" href="'+href.to_s+'">'+
+      "\n"
+    )
+  end
+
+  # ========================================================================= #
+  # === area
+  # ========================================================================= #
+  def area(
+      i = '',
+      &block
+    )
+    HtmlTags.area(
+      i,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  puts HtmlTags.area(
+    'Written by <a href="mailto:webmaster@example.com">Jon Doe</a>.<br>
+Visit us at:<br>
+Example.com<br>
+Box 564, Disneyland<br>
+USA'
+  )
+end

data/lib/html_tags/individual_tags/article.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/area.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/closing_tag/closing_tag.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.article
+  # ========================================================================= #
+  def self.article(
+      i = '',
+      &block
+    )
+    return HtmlTags.add(
+      opening_tag(__method__)+
+      "#{i}\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === article
+  # ========================================================================= #
+  def article(
+      i = '',
+      &block
+    )
+    HtmlTags.article(
+      i,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.article(
+    '<h2>Google Chrome</h2>
+<p>Google Chrome is a web browser developed by Google.</p>'
+  )
+end

data/lib/html_tags/individual_tags/aside.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/aside.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/toplevel_methods/add.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.aside
+  # ========================================================================= #
+  def self.aside(
+      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
+
+  # ========================================================================= #
+  # === aside
+  # ========================================================================= #
+  def aside(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    HtmlTags.aside(i, css_class, the_id, css_style)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.aside('This is a test.','mars3em')
+end

data/lib/html_tags/individual_tags/audio.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/audio.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/toplevel_methods/add.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.audio
+  #
+  # Use a HTML5 audio tag.
+  #
+  # See also this link:
+  #
+  #   https://www.w3schools.com/tags/att_audio_autoplay.asp
+  #
+  # ========================================================================= #
+  def self.audio(
+      url               = '',
+      optional_autoplay = false
+    )
+    case File.extname(url).delete('.')
+    when '','ogg'
+      use_this_audio_type = 'ogg'
+    when 'mp3'
+      use_this_audio_type = 'mpeg'
+    when 'wav'
+      use_this_audio_type = 'wav'
+    else
+      use_this_audio_type = nil # Else we will not play it.
+    end
+    if use_this_audio_type
+      result  = '<audio controls'.dup
+      result << ' autoplay' if optional_autoplay
+      result << ">\n"
+      result << '<source src="'+url.to_s+'" type="audio/'+use_this_audio_type.to_s+'">'+"\n"
+      result << 'Your browser does not support the audio element.'
+      result << close(__method__)
+    else
+      nil
+    end
+    return HtmlTags.add(result)
+  end
+    
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.audio('foobar.mp3',true)
+end

data/lib/html_tags/individual_tags/b.rb

@@ -0,0 +1,22 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === b
+  #
+  # This is the same as bold. Note that since HTML 5, it is recommended
+  # to use <strong> instead.
+  # ========================================================================= #
+  def b(
+      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; alias bold b
+
+end

data/lib/html_tags/individual_tags/bdo.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/area.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/closing_tag/closing_tag.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.bdo
+  # ========================================================================= #
+  def self.bdo(
+      i         = '',
+      direction = 'rtl',
+      &block
+    )
+    _ = '<bdo'.dup
+    _ << ' dir="'+direction.to_s+'">'+"\n"
+    _ << "#{i}\n"
+    _ << close(__method__)
+    return HtmlTags.add(_)
+  end
+
+  # ========================================================================= #
+  # === bdo
+  # ========================================================================= #
+  def bdo(
+      i         = '',
+      direction = 'rtl',
+      &block
+    )
+    HtmlTags.bdo(
+      i,
+      direction,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.bdo(
+    'This is a test.'
+  )
+end

data/lib/html_tags/individual_tags/blockquote.rb

@@ -0,0 +1,19 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === blockquote 
+  # ========================================================================= #
+  def blockquote(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/body.rb

@@ -0,0 +1,19 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === body
+  # ========================================================================= #
+  def body(
+      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/br.rb

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

data/lib/html_tags/individual_tags/button.rb

@@ -0,0 +1,143 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags 
+
+  require 'html_tags/closing_tag/closing_tag.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.button
+  #
+  # This tag should yield something like:
+  #
+  #   <button type="button">Click Me!</button>
+  #
+  # Usage example:
+  #
+  #   x = HtmlTags.button(text: 'Move the mouse cursor here.', css_class: 'glow_on_hover')
+  #
+  # ========================================================================= #
+  def self.button(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    the_opening_tag = nil
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      if i.is_a?(String) and i.empty?
+        i = { text: i }
+        i.update(yielded)
+      end
+    end
+    if i.is_a? Hash
+      # ===================================================================== #
+      # === :css_class
+      # ===================================================================== #
+      if i.has_key? :css_class
+        css_class = i.delete(:css_class)
+      end
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if i.has_key? :id
+        the_id = i.delete(:id)
+      # ===================================================================== #
+      # === :the_id
+      # ===================================================================== #
+      elsif i.has_key? :the_id
+        the_id = i.delete(:the_id)
+      end
+      # ===================================================================== #
+      # === :on_click
+      # ===================================================================== #
+      if i.has_key? :on_click
+        on_click_string = i.delete(:on_click)
+        case on_click_string
+        # =================================================================== #
+        # === :reload_this_page
+        #
+        # This symbol basically means that we will use javascript to
+        # allow for a "reload this page" effect upon clicking the
+        # button.
+        # =================================================================== #
+        when :reload_this_page
+          on_click_string = 'onClick="window.location.href=window.location.href"'
+        end
+        the_opening_tag = opening_tag(__method__, css_class, the_id, css_style, javascript).dup
+        the_opening_tag.sub!(/<button/, '<button '+on_click_string.to_s)
+      end
+      # ===================================================================== #
+      # === :text
+      #
+      # This should come last as it nullifies the variable i.
+      # ===================================================================== #
+      if i.has_key? :text
+        i = i.delete(:text).to_s
+      end
+    end
+    # ======================================================================= #
+    # === the_opening_tag
+    #
+    # We have to get a reference to the opening tag early on, so that we
+    # can add e. g. "onClick" to it.
+    # ======================================================================= #
+    if the_opening_tag.nil?
+      the_opening_tag = opening_tag(__method__, css_class, the_id, css_style, javascript)
+    end
+    return HtmlTags.add(
+      the_opening_tag+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === button
+  #
+  # This tag should yield something like:
+  #
+  #   <button type="button">Click Me!</button>
+  #
+  # Usage example:
+  #
+  #   x = HtmlTags.button(text: 'Move the mouse cursor here.', css_class: 'glow_on_hover')
+  #
+  # ========================================================================= #
+  def button(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    ::HtmlTags.button(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript,
+      &block
+    )
+  end
+   
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.button {{
+     text:      'Refresh this page',
+     css_class: 'bblack2 pad5px marl1em',
+     on_click:  :reload_this_page
+    }}
+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