cyberweb 0.4.174

data/lib/cyberweb/toplevel_methods/input.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will contain input-related code, aka user-input related code.
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/input.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === input_with_datalist
+  #
+  # This method creates an <input> tag, together with datalist.
+  #
+  # This is used only in RBT.cgi so far (2014).
+  # ========================================================================= #
+  def input_with_datalist(array)
+    ee '<input list="browsers" name="browser" />
+        <datalist id="browsers">'
+    array.each {|option|
+      ee '<option value="'+option.to_s+'">'
+    }
+    ee '</datalist>'
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.input_field
+  #
+  # An alias to the method called input().
+  # ========================================================================= #
+  def self.input_field(
+      a = '', b = '', c = '', d = '', e = '', f = '', g = {}
+    )
+    input(:field, a, b, c, d, e, f, g)
+  end
+
+  # ========================================================================= #
+  # === input_field
+  # ========================================================================= #
+  def input_field(
+      a = '', b = '', c = '', d = '', e = '', f = '', g = {}
+    )
+    ::Cyberweb.input_field(a, b, c, d, e, f, g)
+  end
+
+  # ========================================================================= #
+  # === start_checkbox
+  # ========================================================================= #
+  def start_checkbox
+    '<input type="checkbox">'
+  end
+
+end

data/lib/cyberweb/toplevel_methods/jquery.rb

@@ -0,0 +1,82 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/jquery.rb'
+# Cyberweb.return_jquery_string
+# =========================================================================== #
+module Cyberweb
+
+  require 'cyberweb/configuration/load_the_configuration_file.rb'
+
+  require 'cyberweb/toplevel_methods/html_comment.rb'
+
+  # ========================================================================= #
+  # === Cyberweb.path_to_jquery_dir?
+  # ========================================================================= #
+  def self.path_to_jquery_dir?
+    "#{project_base_dir?}javascript_code/jquery/"
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.return_jquery_string
+  #
+  # This method will ultimately read in jquery-related code and then
+  # present that dump to the browser.
+  # ========================================================================= #
+  def self.return_jquery_string(
+      jquery_ui_version = Cyberweb.jquery_ui_version?
+    )
+    _ = ''.dup
+    # ======================================================================= #
+    # === Add support for jquery first:
+    # ======================================================================= #
+    _ << return_html_comment('Adding support for jquery next:')
+    _ << "\n<script>\n"
+    if File.exist?(path_to_jquery_dir?+'jquery-'+this_jquery_version+'.js')
+      _ << File.read(path_to_jquery_dir?+'jquery-'+this_jquery_version+'.js')
+      _ << "\n"
+    end
+    _ << "</script>\n"
+    _ << "\n<script>\n"
+    # ======================================================================= #
+    # Add jquery-ui support next:
+    # ======================================================================= #
+    _ << return_html_comment('Adding support for jquery-ui next:')
+    if File.exist?(path_to_jquery_dir?+'jquery-ui-'+jquery_ui_version+'.js')
+      _ << File.read(path_to_jquery_dir?+'jquery-ui-'+jquery_ui_version+'.js')
+      _ << "\n"
+    end
+    _ << "</script>\n"
+    return _
+  end; self.instance_eval { alias build_jquery_string return_jquery_string } # === build_jquery_string
+
+  # ========================================================================= #
+  # === JQUERY_VERSION
+  # ========================================================================= #
+  JQUERY_VERSION = config?['jquery_version'].to_s
+
+  # ========================================================================= #
+  # === Cyberweb.jquery_version?
+  #
+  # This method will return the jquery version in use.
+  # ========================================================================= #
+  def self.jquery_version?
+    JQUERY_VERSION
+  end; self.instance_eval { alias this_jquery_version jquery_version? } # === Cyberweb.this_jquery_version 
+
+  # ========================================================================= #
+  # === Cyberweb.jquery_ui_version?
+  #
+  # This method will return a String, such as "1.12.1", which will
+  # indicate the current jquery-ui version in use.
+  # ========================================================================= #
+  def self.jquery_ui_version?
+    config?['jquery_ui_version'].to_s
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts Cyberweb.jquery_version?
+end

data/lib/cyberweb/toplevel_methods/last_modified.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/last_modified.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === Cyberweb.last_modified?
+  #
+  # This method will show when the document was last modified.
+  # ========================================================================= #
+  def self.last_modified?
+    div('pad4px','last_modified'){
+      if block_given?
+        yielded = yield
+        case yielded
+        # =================================================================== #
+        # === :display_on_the_same_line
+        # =================================================================== #
+        when :display_on_the_same_line
+          e 'Last modified this document here at: '+
+             string_s2(
+               return_doc_write('document.lastModified'),'marl1em'
+             )
+        else # else is the default choice.
+          e 'Last modified this document here at:'
+          br
+          s2(
+            return_doc_write('document.lastModified'),'marl1em'
+          )    
+        end
+      end
+    }
+  end; self.instance_eval { alias last_update? last_modified? } # === last_update?
+       self.instance_eval { alias last_update  last_modified? } # === last_update
+
+end

data/lib/cyberweb/toplevel_methods/links.rb

@@ -0,0 +1,426 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/toplevel_methods/links.rb'
+# =========================================================================== #
+module Cyberweb
+
+  # ========================================================================= #
+  # === simple_link
+  #
+  # A simplified wrapper around link().
+  #
+  # This is simpler since we only have to provide one URL; and optionally
+  # a second argument denoting the css-class in use.
+  #
+  # Usage example:
+  #
+  #   simple_link 'https://gamefaqs.gamespot.com/pc/565051-alone-in-the-dark-3/faqs/8459','mars2em'
+  #
+  # ========================================================================= #
+  def simple_link(
+      link_hyperref,
+      optional_css_class = '',
+      make_newline       = 1
+    )
+    link(
+      link_hyperref,
+      desc: link_hyperref,
+      css_class: optional_css_class
+    )
+    case make_newline
+    when 1, true
+      br
+    end
+  end; alias si_link     simple_link # === si_link
+       alias remote_link simple_link # === remote_link
+       alias hyperlink   simple_link # === hyperlink
+
+  # ========================================================================= #
+  # === parse_html_link
+  # ========================================================================= #
+  def parse_html_link(
+      i                  = 'https://www.youtube.com/watch?v=WPvGqX-TXP0 Java Programming, 03.05.2014',
+      optional_css_class = 'marl2em'
+    )
+    [i].flatten.compact.each {|this_link|
+      if this_link.include? ' '
+        index = i.index(' ')
+        first = this_link[0 .. index]
+        last  = this_link[index+1 .. -1].dup
+        last << ':' unless last.end_with? ':'
+        e string_span(last,'bold')
+        simple_link(first, optional_css_class)
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === Cyberweb.string_link
+  #
+  # As the method link(), but only returns a string rather than output it.
+  #
+  # Mind the arguments, though!
+  #
+  # The arguments are:
+  #
+  #   `link_hyperref`, `link_description`,
+  #   `default_linebreak`, `css_class`,
+  #   `the_id`, `css_style`,
+  #   `javascript`, `target`
+  #   `title`
+  #
+  # Usage Examples:
+  #
+  #   Cyberweb.string_link('Some Site','www.xyllomer.de','s1em','','id','aaaa',1)
+  #   Cyberweb.string_link('http://netzikon.net/anleitungen/sodimm-einbau/so-dimm.html', content: 'RAM Aufrüsten', css_class: 'slateblue BO')
+  #
+  # ========================================================================= #
+  def self.string_link(
+      link_hyperref     = 'www.xyllomer.de', 
+      link_description  = 'Some Desc',
+      default_linebreak = 0,
+      css_class         = '',
+      the_id            = '',
+      css_style         = '', 
+      javascript        = 0,
+      target            = '',
+      title             = ''
+    )
+    # ======================================================================= #
+    # Next, pass the hyperref through sanitize_url.
+    #
+    # This is EXPERIMENTAL as of 16.03.2008 but it seems to work quite
+    # fine so far. As of April 2014 we only do this for symbols.
+    # ======================================================================= #
+
+    if link_hyperref.is_a? Symbol
+      link_hyperref = sanitize_url(link_hyperref)
+    end
+
+    link_hyperref = link_hyperref.to_s
+
+    case link_hyperref
+    when 'SELF?pdf' # Enable pdf-generation support here.
+      link_hyperref.gsub!(/SELF/, ::Cyberweb.name_of_served_page?)
+    end
+
+    link_description = link_hyperref if link_description == :n # sanitize :n
+    # ======================================================================= #
+    # === Handle the case when we pass in a Hash as the second argument
+    #
+    # The second argument is for link_description.
+    # ======================================================================= #
+    if link_description.is_a? Hash
+      # ===================================================================== #
+      # === :css_class
+      # ===================================================================== #
+      if link_description.has_key? :css_class
+        css_class = link_description.delete(:css_class)
+      end
+      # ===================================================================== #
+      # === :id
+      # ===================================================================== #
+      if link_description.has_key?    :id
+        link_description = link_description.delete :id
+      # ===================================================================== #
+      # === :desc
+      # ===================================================================== #
+      elsif link_description.has_key? :desc
+        link_description = link_description.delete :desc
+      # ===================================================================== #
+      # === :href
+      # ===================================================================== #
+      elsif link_description.has_key? :href
+        link_description = link_description.delete :href
+      # ===================================================================== #
+      # === :url
+      # ===================================================================== #
+      elsif link_description.has_key? :url
+        url = link_description.delete :url
+        link_description = link_hyperref.to_s.dup
+        link_hyperref = url
+      end
+      # ===================================================================== #
+      # === :content
+      #
+      # Note that this entry point also clears any other settings, so it
+      # must come last.
+      # ===================================================================== #
+      if link_description.respond_to?(:has_key?) and
+         link_description.has_key? :content
+        link_description = link_description[:content]
+      end
+    end
+
+    # ======================================================================= #
+    # If link_description ends with "def".
+    # ======================================================================= # 
+    if link_description.is_a?(String) and (link_description =~ /def$/)
+      link_description = link_description.dup if link_description.frozen?
+      link_description.gsub!(/def$/, link_hyperref.dup)
+    end
+
+    # ======================================================================= #
+    # Next convert it into a String.
+    # ======================================================================= #
+    link_description = link_description.to_s
+
+    # ======================================================================= #
+    # === Act on link_description
+    #
+    # Next, act if SELF is present in a link.
+    # ======================================================================= #
+    case link_description.downcase
+    when /self/,/name/,/^def$/,/last/
+      case link_description
+      when 'SELF_SHORT','SELF_ONLY_NAME'
+        link_description = link_description.to_s.gsub(/#{link_description}/,
+          File.basename(link_hyperref.dup)
+        )
+      when /^SELF_NAME$/,/SELF_BASENAME/,'SELF_NO_EXT',
+           'SELF_BASE', 'SELF NO EXT' # We use /SELF_BASENAME/ so that we can eliminate it.
+        regex = link_description
+        regex = Regexp.new(regex) if regex.is_a? String
+        link_description = link_description.to_s.gsub(
+          regex, File.basename(link_hyperref.dup)
+        )
+        if link_description.include? '.' # get the first one if we include a .
+          link_description = link_description.split('.').first.capitalize
+        end
+      when 'StdLink' # since 16.04.2008
+        link_description = File.basename(link_hyperref.dup)
+      when 'self?','self','SELF?','SELF','DEF','DEF?',
+           'COPY','def'
+        link_description = link_hyperref.dup
+      when 'LAST_NAME','LAST','NAME_ONLY' # last name
+        link_description = link_hyperref.split('/').last
+      when /^NAME$/
+        link_description = link_description.to_s.gsub(/NAME/, File.basename(link_hyperref.dup))
+        if link_description.include? '.' # get the first one if we include a .
+          link_description = link_description.split('.').first
+        end
+      when /^SELF$/,/SELF$/,/DEF$/
+        link_description = link_description.to_s.gsub(/#{link_description}/, link_hyperref.dup)
+      end
+    end
+
+    # ======================================================================= #
+    # The user may input a '*' as part of the argument.
+    # In this case we will try to find a match.
+    # ======================================================================= #
+    if link_hyperref.include? '*'
+      _ = Dir[link_hyperref]
+      link_hyperref = _.first unless _.empty?
+      link_description = link_hyperref.dup
+    end
+
+    # ======================================================================= #
+    # Next, handle the linebreak argument.
+    # ======================================================================= #
+    case default_linebreak
+    when :newline
+      default_linebreak = '1'
+    end
+    default_linebreak = default_linebreak.to_s
+    # ======================================================================= #
+    # We cant really do the following because then intra-links wont work.
+    #   link_hyperref[/^/] = 'http://' unless link_hyperref[0, 'http://'.size] == 'http://'
+    # ======================================================================= #
+    _ = '<a'.dup
+    _ << ' href="'+link_hyperref.to_s+'"'
+    _ << ::Cyberweb.return_css_class(css_class)
+    _ << ::Cyberweb.return_the_id(the_id)
+    _ << ::Cyberweb.return_css_style(css_style)
+    _ << ' '+javascript unless javascript.to_i == 0
+    _ << ' target="'+target+'"' unless target.empty?
+    _ << ' title="'+title+'"' if ! title.empty?
+    # _ << ' name="'+link_name+'"'    unless link_name.empty?
+    _ << '>'
+    _ << NL
+    unless link_description.empty?
+      _ << link_description
+    end
+    _ << '</a>'
+    _ << NL
+    _ << string_br unless default_linebreak.to_s == '0' # if 0, dont add newline
+    _ << NL
+    return _
+    # Next follows some test-code:
+    # HtmlTags.a('google.com','Go to Google')
+  end; self.instance_eval { alias string_a string_link } # === Cyberweb.string_a
+       self.instance_eval { alias slink    string_link } # === Cyberweb.slink    (slink tag)
+
+  # ========================================================================= #
+  # === string_link
+  # ========================================================================= #
+  def string_link(
+      a = 'www.xyllomer.de', 
+      b = 'Some Desc',
+      c = 0,
+      d = '',
+      e = '',
+      f = '', 
+      g = 0,
+      h = '',
+      i = ''
+    )
+    ::Cyberweb.string_link(a,b,c,d,e,f,g,h,i)
+  end
+
+  # ========================================================================= #
+  # === blink
+  #
+  # Very similar to alink(). However, it makes use of a ': ' as separator
+  # instead.
+  #
+  # Arguments to blink:
+  #
+  #   blink('Homepage: https://github.com/wycats/thor',default_linebreak,
+  #          css_class = '', the_id = '', css_style = '', use_js = 0,
+  #          target = '', title = '')
+  #
+  # ========================================================================= #
+  def blink(
+      url       = 'Homepage: https://github.com/wycats/thor', 
+      default_linebreak = 0,
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      use_js    = 0,
+      target    = '',
+      title     = ''
+    )
+
+    splitted         = url.split(': ')
+    link_hyperref    = splitted[-1]
+    link_description = splitted[0..-2].join(' ').gsub(/:/,'')
+
+    link(link_hyperref, link_description,
+      default_linebreak, css_class, the_id, css_style, use_js, target, title
+    )
+  end
+
+  # ========================================================================= #
+  # === link_list
+  #
+  # Dumps a list of links.
+  # ========================================================================= #
+  def link_list(*these_links)
+    these_links.each { |my_link|
+      print string_link(
+         no_http(my_link), my_link, 'slateblue','padding:1px', 1
+      )
+    }
+  end
+
+  # ========================================================================= #
+  # === links
+  #
+  # This makes a collection of links.
+  # The input to this method should be an Array.
+  #
+  # Since Jun 2012 we will check if a link includes ': ', and if
+  # yes then we won't use link(), we will use slink() instead.
+  # ========================================================================= #
+  def links(*these_links)
+    these_links.each {|the_link|
+      if the_link.include? ': '
+        blink(the_link, the_link, 1,'BO marl1em')
+      else
+        a(the_link, the_link, 1, 'BO marl1em')
+      end
+    }
+  end; alias link_collection links # === link_collection
+
+  # ========================================================================= #
+  # === alink
+  #
+  # The method alink() is a method for creating specialized links.
+  #
+  # You provide just one string to it, the main input (first argument)
+  # and it then calls the link() method, by splitting the input
+  # argument at ' '.
+  #
+  # It then assumes that the first part is the link_description and
+  # that the second part is the URL to it.
+  #
+  # Specific Usage example to illustrate this point:
+  #
+  #   alink 'Homepage: https://github.com/wycats/thor'
+  #
+  # ========================================================================= #
+  def alink(
+      i         = 'Homepage: https://github.com/wycats/thor', 
+      default_linebreak = 0,
+      css_class = '',
+      the_id    = '',
+      css_style = '',
+      use_js    = 0,
+      target    = '',
+      title     = ''
+    )
+
+    i = remove_newlines(i) # Added Mar 2012.
+
+    splitted         = i.split(' ')
+    link_hyperref    = splitted[-1]
+    link_description = splitted[0..-2].join(' ')
+
+    link(
+      link_hyperref, link_description+' '+link_hyperref, 
+      default_linebreak, css_class, the_id, css_style,
+      use_js, target, title
+    )
+  end; alias complex_link alink # === complex_link()
+
+  # ========================================================================= #
+  # === link_in_page
+  #
+  # Use this method to describe an in-page link, ie a link towards
+  # 'HARDWARE.cgi#foobar' (an "intralink").
+  #
+  # Usage examples:
+  #
+  #   link_in_page(:where_to, 'internal_pointer', 'Zu meinem Netgar WLAN Stick')
+  #   link_in_page(:where_to, 'internal_pointer', 'Zu meinem Netgar WLAN Stick',0,'css_class')
+  #   link_in_page(:hware,    'USB_Netgear_108_WG111T', 'Zu meinem Netgar WLAN Stick')
+  #
+  # ========================================================================= #
+  def link_in_page(
+      link_hyperref     = '',
+      pointer           = '', 
+      link_description  = '',
+      default_linebreak = '',
+      css_class         = '',
+      the_id            = '',
+      css_style         = '',
+      use_js            = ''
+    )
+    link_hyperref = 'SELF' if link_hyperref.to_s.empty? # safeguard
+    if link_description.to_s.empty? and !pointer.to_s.empty?
+      link_description = pointer.dup
+    end
+    # ======================================================================= #
+    # === Pass through BeautifulUrl next but not or /Users link
+    # ======================================================================= #
+    if link_hyperref.is_a?(String) and !link_hyperref.include?('SELF')
+      unless link_hyperref.start_with? '/home'
+        _ = sanitize_url(link_hyperref, true)
+        link_hyperref = _
+      end
+    end
+    this_target = "#{link_hyperref}#{pointer}" 
+    link(
+      this_target,
+      link_description,
+      default_linebreak,
+      css_class,
+      the_id,
+      css_style,
+      use_js
+    )
+  end; alias intralink link_in_page # === intralink()
+
+end