html_tags 0.1.183

data/lib/html_tags/individual_tags/span.rb

@@ -0,0 +1,95 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/span.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.span
+  #
+  # This method will generate HTML <span> tags.
+  #
+  # It will first invoke the method called opening_tag(), then add
+  # the content that was given to it (the first parameter), and then
+  # close the whole tag via the close() method.
+  #
+  # Do note that you can eliminate newlines by invoking the method
+  # in something like this, via :strip:
+  #
+  #   HtmlTags.span('Hello world!','s1') { :strip }
+  #   HtmlTags.span(i, css_class: 'bord1px', css_style: 'margin-left: 1em')
+  #
+  # ========================================================================= #
+  def self.span(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    i = i.to_s
+    start_the_method = opening_tag(
+                         __method__,
+                         css_class,
+                         the_id,
+                         css_style,
+                         javascript
+                       )
+    close_the_method = close(__method__)
+    if block_given?
+      yielded = yield
+      case yielded
+      when :strip
+        # Unfreeze, if frozen:
+        i = i.dup if i.frozen?
+        close_the_method = close_the_method.dup if close_the_method.frozen?
+        start_the_method = start_the_method.dup if start_the_method.frozen?
+        i.strip!
+        close_the_method.strip!
+        start_the_method.strip!
+      end
+    end
+    return HtmlTags.add(
+      start_the_method+
+      i+
+      close_the_method
+    )
+  end; self.instance_eval { alias s2 span } # === HtmlTags.s2
+
+  # ========================================================================= #
+  # === span
+  # ========================================================================= #
+  def span(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      javascript = '',
+      &block
+    )
+    ::HtmlTags.span(i, css_class, the_id, css_style, javascript, &block)
+  end; alias s2 span # === s2
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.span('Hey there', 'mars2em')
+  # We also have to test the variant without any CSS class attached.
+  e HtmlTags.span('Hey there')
+  e
+  e 'The next variant uses more arguments:'
+  e
+  e HtmlTags.span(
+    'Heya',
+    'mars3em',
+    'some_id_here',
+    'color: green;'
+  )
+end

data/lib/html_tags/individual_tags/strong.rb

@@ -0,0 +1,17 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === strong
+  #
+  # For most purposes, this can be treated as the old (pre-html5) bold
+  # html tag. 
+  # ========================================================================= #
+  def strong(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/style.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === style
+  #
+  # We first call the opening_tag() method, then add the content,
+  # and then close the whole thing again via close().
+  #
+  # This is essentially a way to add CSS style to a HTML-page.
+  # ========================================================================= #
+  def style(
+      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/summary.rb

@@ -0,0 +1,77 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/summary.rb'
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.summary
+  #
+  # The <summary> tag defines a visible heading for the <details>
+  # element. The heading can be clicked to view/hide the details.
+  # ========================================================================= #
+  def self.summary(
+      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
+
+  # ========================================================================= #
+  # === summary
+  # ========================================================================= #
+  def summary(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      optional_javascript = '',
+      &block
+    )
+    return HtmlTags.summary(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      javascript_code,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.summary('Hey there')
+end

data/lib/html_tags/individual_tags/sup.rb

@@ -0,0 +1,57 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# See:
+#
+#   https://www.w3schools.com/tags/tag_sup.asp
+#
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.sup
+  # ========================================================================= #
+  def self.sup(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    start = opening_tag(__method__, css_class, the_id, css_style).dup
+    return HtmlTags.add(
+      start+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === sup
+  # ========================================================================= #
+  def sup(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      &block
+    )
+    return HtmlTags.sup(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.sup('superscript')
+end

data/lib/html_tags/individual_tags/table.rb

@@ -0,0 +1,90 @@
+#!/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'
+  require 'html_tags/individual_tags/td.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.table
+  #
+  # This should be combined with tr-tags and td-tags.
+  # ========================================================================= #
+  def self.table(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    # ======================================================================= #
+    # === Handle blocks first
+    # ======================================================================= #
+    if block_given?
+      if i.is_a?(String) and i.frozen?
+        i = i.dup
+      elsif i.nil?
+        i = ''.dup
+      end
+      yielded = yield
+      yielded = yielded.to_a.flatten if yielded.is_a? Hash # Convert a Hash into Array in this case.
+      # ===================================================================== #
+      # Arrays will be appended via proper <tr> and <td> usage.
+      # ===================================================================== #
+      if yielded.is_a? Array
+        yielded.each_with_index { |entry, index|
+          if (index % 2) == 0
+            i << '<tr>'
+            i << HtmlTags.td(entry)
+          else
+            i << HtmlTags.td(entry)
+            i << '</tr>'
+          end
+        }
+      else
+        i << yielded
+      end
+    end
+    start_tag = opening_tag(__method__, css_class, the_id, css_style)
+    return HtmlTags.add(
+      start_tag+
+      "#{i}\n"+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === table
+  # ========================================================================= #
+  def table(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      &block
+    )
+    return HtmlTags.table(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  include HtmlTags
+  e '------------------'
+  e table('foobar.mp4')
+  e '------------------'
+  e HtmlTags.table(nil,'mars1em','test_table','border:1px solid rand') {
+    %w( abc def ghi jkl )
+  }
+  e '------------------'
+end

data/lib/html_tags/individual_tags/tbody.rb

@@ -0,0 +1,19 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === HtmlTags.tbody
+  # ========================================================================= #
+  def self.tbody(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
+
+  # ========================================================================= #
+  # === tbody
+  # ========================================================================= #
+  def tbody(i = '', css_class = '', the_id = '', css_style = '')
+    HtmlTags.tbody(i, css_class, the_id, css_style)
+  end
+
+end

data/lib/html_tags/individual_tags/td.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/individual_tags/td.rb'
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === td
+  # ========================================================================= #
+  def td(
+      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/textarea.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  require 'html_tags/toplevel_methods/add.rb'
+  require 'html_tags/opening_tag/opening_tag.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.textarea
+  #
+  # Do note that the <textarea> tag also has an entry called spellcheck.
+  #
+  # Example:
+  #
+  #   <textarea spellcheck="true"></textarea>
+  #
+  # This appears to be true by default on palemoon, firefox and chrome,
+  # but I am not sure that it is too terribly useful, so as far as the
+  # HtmlTags project is concerned, it will be set to false by default.
+  #
+  # Invocation example:
+  #
+  #   HtmlTags.textarea('Hello world!') # => <textarea spellcheck="true">Hello world!</textarea>
+  #
+  # ========================================================================= #
+  def self.textarea(
+      i          = '', # This is the actual content.
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      spellcheck = false,
+      *args
+    )
+    start = opening_tag(__method__, css_class, the_id, css_style)
+
+    index = start.index('<textarea')+
+            '<textarea'.size
+    if spellcheck
+      start[index,0] = ' spellcheck="true"'
+    else
+      start[index,0] = ' spellcheck="false"'
+    end
+    return HtmlTags.add(
+      start+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === textarea
+  # ========================================================================= #
+  def textarea(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      spellcheck = false,
+      *args
+    )
+    HtmlTags.textarea(i, css_class, the_id, css_style, spellcheck, args)
+  end 
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.textarea('OK THERE')
+  e HtmlTags.textarea('','pad10px','main_textarea')
+end

data/lib/html_tags/individual_tags/th.rb

@@ -0,0 +1,50 @@
+#!/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.th
+  # ========================================================================= #
+  def self.th(
+      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
+
+  # ========================================================================= #
+  # === th
+  # ========================================================================= #
+  def th(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      &block
+    )
+    return HtmlTags.th(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.th('Month')
+end

data/lib/html_tags/individual_tags/thead.rb

@@ -0,0 +1,53 @@
+#!/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.thead
+  # ========================================================================= #
+  def self.thead(
+      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
+
+  # ========================================================================= #
+  # === thead
+  # ========================================================================= #
+  def thead(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      &block
+    )
+    return HtmlTags.thead(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.thead(' <tr>
+      <th>Month</th>
+      <th>Savings</th>
+    </tr>')
+end

data/lib/html_tags/individual_tags/time.rb

@@ -0,0 +1,50 @@
+#!/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.time
+  # ========================================================================= #
+  def self.time(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    return HtmlTags.add(
+      opening_tag(__method__, css_class, the_id, css_style) { :no_newline }+ # Looks better without newline, in my opinion.
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+  # ========================================================================= #
+  # === time
+  # ========================================================================= #
+  def time(
+      i                   = '',
+      css_class           = '',
+      the_id              = '',
+      css_style           = '',
+      &block
+    )
+    return HtmlTags.time(
+      i,
+      css_class,
+      the_id,
+      css_style,
+      &block
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e HtmlTags.time('10:00')
+end