html_tags 0.1.120

data/lib/html_tags/individual_tags/table.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === table
+  # ========================================================================= #
+  def table(
+      i         = '',
+      css_class = '',
+      the_id    = '',
+      css_style = ''
+    )
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Array
+        yielded.each {|entry|
+          i << entry
+        }
+      else
+        i << yielded
+      end
+    end
+    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/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,24 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+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,46 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module 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 textarea(
+      i          = '',
+      css_class  = '',
+      the_id     = '',
+      css_style  = '',
+      spellcheck = false
+    )
+    start = opening_tag(__method__, css_class, the_id, css_style)
+    index = start.index('textarea>')+'textarea>'.size - 1
+    if spellcheck
+      start[index,0] = ' spellcheck="true"'
+    else
+      start[index,0] = ' spellcheck="false"'
+    end
+    return HtmlTags.add(
+      start+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/th.rb

@@ -0,0 +1,14 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === th
+  # ========================================================================= #
+  def 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
+
+end

data/lib/html_tags/individual_tags/thead.rb

@@ -0,0 +1,14 @@
+module HtmlTags
+
+  # ========================================================================= #
+  # === thead
+  # ========================================================================= #
+  def 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
+
+end

data/lib/html_tags/individual_tags/title.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === HtmlTags.title
+  # ========================================================================= #
+  def self.title(i = '')
+    return HtmlTags.add(
+      opening_tag(__method__)+
+      i.to_s+
+      close(__method__)
+    )
+  end
+
+end

data/lib/html_tags/individual_tags/tr.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === tr
+  # ========================================================================= #
+  def tr(
+      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/ul.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === ul
+  # ========================================================================= #
+  def ul(
+      i = '', css_class = '', the_id = '', css_style = ''
+    )
+    _ = ''.dup
+    _ << yield if block_given?
+    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/video.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module HtmlTags
+
+  # ========================================================================= #
+  # === video                                                     (video tag)
+  #
+  # The goal of this method is to create a String such as
+  # '<video src="movie.webm"></video>'.
+  # ========================================================================= #
+  def video(
+      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
+    video_tag = opening_tag(__method__, css_class, the_id, css_style, optional_javascript).dup
+    video_tag[-2,0] = ' controls'
+    return HtmlTags.add(
+      video_tag+
+      "<source src=\"#{i}\">"+
+      close(__method__)
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  require 'html_tags/opening_tag/opening_tag.rb'
+  require 'html_tags/toplevel_methods/add.rb'
+  include HtmlTags
+  e video 'foobar.mp4'
+end

data/lib/html_tags/module.rb

@@ -0,0 +1,5 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'html_tags'

data/lib/html_tags/opening_tag/opening_tag.rb

@@ -0,0 +1,288 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/opening_tag/opening_tag.rb'
+# =========================================================================== #
+module HtmlTags
+
+  begin
+    require 'web_object/requires/require_web_images.rb'
+  rescue LoadError; end
+
+  require 'html_tags/array_registered_html_tags.rb'
+  require 'html_tags/closing_tag/closing_tag.rb'
+
+  # ========================================================================= #
+  # === HtmlTags.opening_tag                                (opening_tag tag)
+  #
+  # If we pass a block to this method, we treat it as a special hash.
+  #
+  # This can be used to make use of src.
+  #
+  # Note that arguments to this method can become quite complicated.
+  #
+  # For instance, consider this here:
+  #
+  #   e p 'Good Bye', :css_class => 'border: 1px solid red',
+  #                   :id        => 'goodbye'
+  #
+  # ========================================================================= #
+  def self.opening_tag(
+      i, # The name of the tag comes here.
+      optional_css_class  = '', # 2nd parameter
+      optional_the_id     = '', # 3rd parameter
+      optional_css_style  = '', # 4th parameter
+      optional_javascript = '', # 5th parameter
+      &block
+    )
+    append_newline = true
+    i = i.to_s.dup # Must use .dup here, to prevent cascading string-taint.
+    original_tag_name = i.to_s.dup
+    case i
+    when 's','' # Sanitize in these two cases.
+      i = 'span'
+    end
+    content = ''.dup # This here will be appended always.
+    end_string = ''.dup
+    i = i.dup if i.frozen?
+    # ======================================================================= #
+    # === optional_css_class
+    #
+    # Next we must intercept when the second argument is a Hash.
+    # ======================================================================= #
+    if optional_css_class.is_a? Hash
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if optional_css_class.has_key? :id
+        optional_the_id = optional_css_class.delete(:id)
+      end
+      # ===================================================================== #
+      # === :css_style
+      # ===================================================================== #
+      if optional_css_class.has_key? :css_style
+        optional_css_style = optional_css_class.delete(:css_style)
+      # ===================================================================== #
+      # === :style
+      # ===================================================================== #
+      elsif optional_css_class.has_key? :style
+        optional_css_style = optional_css_class.delete(:style)
+      end
+      # ===================================================================== #
+      # Intercept javascript keys. Several aliases could be used, so
+      # we have to check for them.
+      # ===================================================================== #
+      if    optional_css_class.has_key? :javascript
+        optional_javascript = optional_css_class.delete(:javascript)
+      elsif optional_css_class.has_key? :javascript_code
+        optional_javascript = optional_css_class.delete(:javascript_code)
+      elsif optional_css_class.has_key? :desc
+        content << optional_css_class.delete(:desc).to_s
+      end
+      if optional_css_class.has_key? :css_class # This here must come last.
+        optional_css_class = optional_css_class.delete(:css_class).to_s.dup
+      elsif optional_css_class.has_key? :title
+        i << ' title="'+optional_css_class.delete(:title).to_s+'"'
+        optional_css_class = ''
+      end
+      if optional_css_class.empty?
+        optional_css_class = ''
+      end if optional_css_class.is_a? Hash
+    end
+    # ======================================================================= #
+    # === optional_javascript
+    #
+    # Intercept optional_javascript if it is a Hash.
+    # ======================================================================= #
+    if optional_javascript.is_a? Hash
+      if optional_javascript.has_key? :on_click # Redirect
+        optional_javascript[:onclick] = optional_javascript.delete(:on_click)
+      end
+      if optional_javascript.has_key? :onclick
+        js_temp_string  = optional_javascript[:onclick].to_s
+        if js_temp_string.include? 'background-color'
+          optional_javascript = 'onclick="set_background_color('+
+            js_temp_string.gsub(/background-color\:/,'').delete(';')+
+            ', this)"'
+        elsif js_temp_string == 'go back in history' # Sanitize it.
+          optional_javascript = 'history.back(-1)'
+        end
+      elsif optional_javascript.has_key? :javascript_hover
+        # The following code works on:
+        #   :javascript_hover => 'color: lightblue'
+        js_temp_string  = optional_javascript[:javascript_hover].to_s
+        if js_temp_string.include? 'color'
+          optional_javascript = ' onmouseover="colourize(this, '+
+            js_temp_string.gsub(/color\:/,'').to_s.delete(' ')+')"'
+        end
+      end
+    # ======================================================================= #
+    # Next handle special String-input given to the javascript component.
+    # ======================================================================= #
+    elsif optional_javascript.is_a? String
+      if optional_javascript.include?('on_click:') # Input may be: 'on_click: show_image(:axe))'
+        if optional_javascript.frozen?
+          optional_javascript = optional_javascript.dup
+        end
+        optional_javascript.gsub!(/on_click: /, '')
+        if optional_javascript.include? 'show_image'
+          optional_javascript =~ /\((.+)\)/
+          optional_javascript = $1.to_s.dup.delete(')')
+          optional_javascript = WebObject.obtain(optional_javascript)
+          optional_javascript = 'onclick="reveal('+"'"+optional_javascript+"'"+')"'
+        end
+      end
+    end
+    # ======================================================================= #
+    # Next we require the four input-objects to be Strings.
+    # ======================================================================= #
+    optional_css_class  = optional_css_class.to_s.dup
+    optional_the_id     = optional_the_id.to_s
+    case optional_css_style
+    when :bold
+      # ===================================================================== #
+      # === Intercept key :bold next
+      #
+      # This is a special key in the sense that we will "translate" it
+      # into the corresponding CSS value. So :bold really just means
+      # to be replaced with the string 'font-weight: bold'.
+      # ===================================================================== #
+      optional_css_style = 'font-weight: bold;'
+    end
+    optional_css_style  = optional_css_style.to_s
+    optional_javascript = optional_javascript.to_s
+
+    if optional_css_style.include? "\n" # Get rid of newlines and multiple ' '.
+      optional_css_style = beautify_string(optional_css_style)
+    end
+    # ======================================================================= #
+    # === Handle blocks next
+    #
+    # Intercept blocks passed to this method. Typically blocks will,
+    # in some form, be appended to the opening-tag at hand.
+    # ======================================================================= #
+    if block_given? # If we passed a block
+      yielded = yield # Tap into the block.
+      if yielded.is_a? Hash
+        # =================================================================== #
+        # === :src
+        # =================================================================== #
+        if yielded.has_key? :src
+          i << ' src="'+yielded.delete(:src).to_s+'"'
+        end
+        # =================================================================== #
+        # === :href
+        # =================================================================== #
+        if yielded.has_key? :href
+          i << ' href="'+yielded.delete(:href).to_s+'"'
+        end
+        # =================================================================== #
+        # === :type
+        # =================================================================== #
+        if yielded.has_key? :type
+          i << ' type="'+yielded.delete(:type).to_s+'"'
+        end
+        # =================================================================== #
+        # === :value
+        #
+        # This entry point should come after :type, as I think it looks
+        # a bit prettier that way.
+        # =================================================================== #
+        if yielded.has_key? :value
+          i << ' value="'+yielded.delete(:value).to_s+'"'
+        end
+        # =================================================================== #
+        # === :link_description or :description
+        # =================================================================== #
+        if yielded.has_key?(:link_description) or
+           yielded.has_key?(:description) or
+           yielded.has_key?(:content)
+          # if content.empty? # We only append to content if is empty. Disabled this in Jun 2015.
+            if yielded.has_key?    :link_description
+              content << yielded.delete(:link_description).to_s
+            elsif yielded.has_key? :description
+              content << yielded.delete(:description).to_s
+            elsif yielded.has_key? :content
+              content << yielded.delete(:content).to_s
+            end
+          #end
+        # =================================================================== #
+        # === :desc
+        # =================================================================== #
+        elsif yielded.has_key? :desc
+          content << yielded.delete(:desc).to_s
+        end
+        # =================================================================== #
+        # === :make_newline
+        # =================================================================== #
+        if yielded.has_key? :make_newline
+          end_string << br
+        end
+      # ===================================================================== #
+      # === Handle Symbols directly past this point
+      # ===================================================================== #
+      elsif yielded.is_a? Symbol 
+        case yielded
+        when :no_newline
+          append_newline = false
+        end
+      end
+    end
+    # ======================================================================= #
+    # Next, add the class, id, style, and javascript entries to our tag.
+    # ======================================================================= #
+    i << ' class="'+optional_css_class+'"' unless optional_css_class.empty?
+    i << ' id="'+optional_the_id+'"'       unless optional_the_id.empty?
+    i << ' style="'+optional_css_style+'"' unless optional_css_style.empty?
+
+    unless optional_javascript.empty?
+      # ===================================================================== #
+      # Always prepend ' ' if it is not empty.
+      # ===================================================================== #
+      if optional_javascript.frozen?
+        optional_javascript = optional_javascript.dup
+      end
+      optional_javascript.prepend ' '
+      # ===================================================================== #
+      # Add some exceptions: currently the exceptions include
+      # "onclick" and "onmouse".
+      # ===================================================================== #
+      unless optional_javascript.strip.start_with?('onclick') or
+             optional_javascript.strip.start_with?('onmouse')
+        optional_javascript = 'javascript="'+optional_javascript+'"'
+      end
+      i << optional_javascript
+    end
+    # ======================================================================= #
+    # === Append '/' to a few tags.
+    # ======================================================================= #
+    if ARRAY_TAGS_WITHOUT_CLOSING_TAG.include? original_tag_name
+      i << '/' # Add exception for <br/> tags and some others.
+    end
+    i = "<#{i}>#{end_string}"
+    i = i.dup if i.frozen?
+    i << "\n" if append_newline
+    i << content
+    return i
+  end; self.instance_eval { alias otag opening_tag } # === HtmlTags.otag
+
+  # ========================================================================= #
+  # === opening_tag
+  # ========================================================================= #    
+  def opening_tag(
+      i,
+      optional_css_class  = '',
+      optional_the_id     = '',
+      optional_css_style  = '',
+      optional_javascript = ''
+    )
+    HtmlTags.opening_tag(i,
+      optional_css_class,
+      optional_the_id,
+      optional_css_style,
+      optional_javascript
+    ) 
+  end; alias otag opening_tag # === otag
+
+end

data/lib/html_tags/project/project_base_directory.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/project/project_base_directory.rb'
+# =========================================================================== #
+require 'yaml'
+
+module HtmlTags
+
+  # ========================================================================= #
+  # === HtmlTags::PROJECT_BASE_DIRECTORY
+  # ========================================================================= #
+  PROJECT_BASE_DIRECTORY =
+    File.absolute_path("#{__dir__}/..")+'/'
+  PROJECT_BASE_DIR = PROJECT_BASE_DIRECTORY # === PROJECT_BASE_DIR
+
+  # ========================================================================= #
+  # === PROJECT_YAML_DIR
+  # ========================================================================= #
+  PROJECT_YAML_DIR = "#{PROJECT_BASE_DIRECTORY}yaml/"
+
+end

data/lib/html_tags/requires/require_the_html_tags_project.rb

@@ -0,0 +1,9 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/requires/require_the_html_tags_project.rb'
+# =========================================================================== #
+require 'html_tags/base/base_module.rb'
+require 'html_tags/html_tags.rb'
+require 'html_tags/constants/misc.rb'

data/lib/html_tags/requires/require_the_img_tag.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'html_tags/requires/require_the_image_tag.rb'
+# =========================================================================== #
+require 'html_tags/individual_tags/img.rb'

data/lib/html_tags/shared.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# =========================================================================== #
+require 'html_tags/checks.rb'
+require 'html_tags/toplevel_methods/newline_or_empty.rb'
+
+module HtmlTags # HtmlTags::Shared
+
+module Shared # require 'html_tags/shared.rb'
+
+  N = "\n"
+
+  # ========================================================================= #
+  # === beautify_string
+  #
+  # First run .squeeze(' '), then delete newlines, to make a string more
+  # beautiful.
+  # ========================================================================= #
+  def beautify_string(i)
+    i.squeeze(' ').delete("\n")
+  end
+
+end; end