cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/web_object/{links.rb → link.rb}

@@ -2,53 +2,68 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'cyberweb/web_object/links.rb'
+# require 'cyberweb/web_object/link.rb'
 # =========================================================================== #
 require 'cyberweb/base/base.rb'
 
 module Cyberweb
 
-class WebObject < Base # === Cyberweb::WebObject
+class WebObject < ::Cyberweb::Base # === Cyberweb::WebObject
 
   # ========================================================================= #
-  # === string_link
+  # === pretty_link
+  #
+  # This method will first pass the input into BeautifulUrl,
+  # and then use the result given from BeautifulUrl as the
+  # remote URL.
+  #
+  # The key idea here is that we can build up links towards
+  # remote URLs, all handled by the BeautifulUrl namespace.
+  #
+  # One advantage of this approach is that we have to change
+  # a remote URL only once, if it ever changes, so we do not
+  # have to change all local links that may have outdated
+  # entries as such.
+  #
+  # Invocation example:
+  #
+  #   pretty_link('Jules Bordet')
+  #
   # ========================================================================= #
-  def string_link(
-      i           = '',
-      option_hash = {}
-    )
-    if i.is_a?(Symbol) and i.start_with?('local_')
-      i = BeautifulUrl.local_menu(i)
-    end
-    if i.start_with? '/home/x'
-      i = i.dup
-      i.sub!(/\/home\/x\//, relative_path?)
-    end
-    i = rds(i.to_s.dup)
-    HtmlTags.a(
-      i, option_hash
-    )
-  end; alias string_a string_link # === string_a
+  def pretty_link(i, optional_css_class = '')
+    remote_URL = beautiful_URL(i)
+    return string_a(remote_URL, content: i, css_class: optional_css_class)
+  end
 
   # ========================================================================= #
-  # === a                                                   (a tag, link tag)
+  # === 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'
   #
-  # This method essentially refers to the <a> tag.
   # ========================================================================= #
-  def a(
-      i           = '',
-      option_hash = {}
+  def simple_link(
+      link_hyperref,
+      optional_css_class = '',
+      make_newline       = 1
     )
-    if i.is_a? Symbol
-      i = ::Cyberweb.beautiful_url(i)
-    end
-    addn(
-      string_link(i, option_hash)
+    link(
+      link_hyperref,
+      desc:      link_hyperref,
+      css_class: optional_css_class
     )
-  end; alias link    a # === a
-       alias link_to a # === link_to
-       alias alink   a # === alink
-       alias slink   a # === slink
+    case make_newline
+    when 1, true
+      br
+    end
+  end; alias si_link     simple_link # === si_link
+       alias hyperlink   simple_link # === hyperlink
 
   # ========================================================================= #
   # === linkbr                                                      (abr tag)
@@ -82,7 +97,9 @@ class WebObject < Base # === Cyberweb::WebObject
       # ===================================================================== #
       # Improve on the option-hash next.
       # ===================================================================== #
-      if option_hash.has_key? :content
+      if option_hash.respond_to?(:content) and
+         option_hash.is_a?(Hash) and
+         option_hash.has_key?(:content)
         _ = option_hash[:content]
         case _
         # =================================================================== #
@@ -101,26 +118,19 @@ class WebObject < Base # === Cyberweb::WebObject
   end; alias abr linkbr # === abr
 
   # ========================================================================= #
-  # === back_to_games
-  # ========================================================================= #
-  def back_to_games(
-      optional_css_class = 'steelblue BOLD'
-    )
-    abr :local_games,
-        content: 'SELF',
-        css_class: optional_css_class
-  end; alias to_the_games back_to_games # === to_the_games
-
-  # ========================================================================= #
-  # === link_to_local_games
+  # === self_abr
+  #
+  # This method is similar to abr(), but it will automatically use
+  # content: :self as-is.
   # ========================================================================= #
-  def link_to_local_games(
-      optional_css_class = 'mars1em steelblue BOLD'
+  def self_abr(
+      remote_url,
+      optional_css_class = ''
     )
-    abr :local_games,
-        content: 'SELF',
+    abr remote_url,
+        content: :self,
         css_class: optional_css_class
-  end; alias roebe_games link_to_local_games # === roebe_games
+  end; alias abr_self self_abr # ===  abr_self
 
   # ========================================================================= #
   # === roebe_internal_link
@@ -133,7 +143,9 @@ class WebObject < Base # === Cyberweb::WebObject
   # with a :local_ prefix. This may change at a later time, but for now
   # we will keep this very strict.
   # ========================================================================= #
-  def roebe_internal_link(i, hash)
+  def roebe_internal_link(
+      i, hash
+    )
     if i.is_a? Symbol
       if i.start_with? 'local'
         i = BeautifulUrl.local_link(i)
@@ -150,33 +162,6 @@ class WebObject < Base # === Cyberweb::WebObject
     abr(i, hash)
   end; alias roebe_local_link roebe_internal_link # === roebe_local_link
 
-  # ========================================================================= #
-  # === self_abr
-  #
-  # This method is similar to abr(), but it will automatically use
-  # content: :self as-is.
-  # ========================================================================= #
-  def self_abr(
-      remote_url, optional_css_class = ''
-    )
-    abr remote_url,
-        content: :self,
-        css_class: optional_css_class
-  end; alias abr_self self_abr # ===  abr_self
-
-  # =========================================================================== #
-  # === aself
-  # =========================================================================== #
-  def aself(
-      url, optional_css_class = ''
-    )
-    a(
-      url,
-      content: :self,
-      css_class: optional_css_class
-    )
-  end
-
   # ========================================================================= #
   # === link_in_page
   #
@@ -216,13 +201,130 @@ class WebObject < Base # === Cyberweb::WebObject
     this_target = "#{link_hyperref}#{pointer}" 
     a(
       this_target,
-      content: link_description,
+      content:   link_description,
       linebreak: default_linebreak,
       css_class: css_class,
-      the_id: the_id,
+      the_id:    the_id,
       css_style: css_style,
-      use_js: use_js
+      use_js:    use_js
+    )
+  end; alias intralink link_in_page # === intralink
+
+  # ========================================================================= #
+  # === back_to_games
+  # ========================================================================= #
+  def back_to_games(
+      optional_css_class = 'steelblue BOLD'
+    )
+    abr :local_games,
+        content: :self,
+        css_class: optional_css_class
+  end; alias to_the_games back_to_games # === to_the_games
+
+  # ========================================================================= #
+  # === link_to_local_games
+  # ========================================================================= #
+  def link_to_local_games(
+      optional_css_class = 'mars1em steelblue BOLD'
+    )
+    abr :local_games,
+        content: :self,
+        css_class: optional_css_class
+  end; alias roebe_games link_to_local_games # === roebe_games
+
+  # =========================================================================== #
+  # === aself
+  # =========================================================================== #
+  def aself(
+      url,
+      optional_css_class = ''
     )
-  end; alias intralink link_in_page # === intralink()
+    a(
+      url,
+      content: :self,
+      css_class: optional_css_class
+    )
+  end; alias a_self aself # === a_self
+
+  # ========================================================================= #
+  # === add_roebe_sitemap_link
+  #
+  # This method will add a link to my (local) sitemap. This is fairly
+  # useless for other people, so don't use this method really.
+  # ========================================================================= #
+  def add_roebe_sitemap_link(
+      optional_css_class = 'mars1em steelblue BOLD'
+    )
+    use_this_as_the_content = :self
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :right_arrow
+      # ===================================================================== #
+      when :right_arrow
+        use_this_as_the_content = '→ Local Sitemap'
+      end
+    end
+    abr :local_sitemap,
+        content:   use_this_as_the_content,
+        css_class: optional_css_class
+  end; alias roebe_sitemap             add_roebe_sitemap_link # === roebe_sitemap
+       alias to_the_roebe_sitemap      add_roebe_sitemap_link # === to_the_roebe_sitemap
+       alias to_roebe_sitemap          add_roebe_sitemap_link # === to_roebe_sitemap
+       alias to_roebe                  add_roebe_sitemap_link # === to_roebe
+       alias link_to_the_local_sitemap add_roebe_sitemap_link # === link_to_the_local_sitemap
+       alias to_the_sitemap            add_roebe_sitemap_link # === to_the_sitemap
+       alias to_sitemap                add_roebe_sitemap_link # === to_sitemap
+       alias back_to_sitemap           add_roebe_sitemap_link # === back_to_sitemap
+
+  # ========================================================================= #
+  # === svg_link
+  # ========================================================================= #
+  def svg_link(i)
+    if File.exist? i
+      addnl(
+        File.read(i)
+      )
+    end
+  end
+
+  # ========================================================================= #
+  # === 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? ':'
+        s2(last,'bold')
+        a(
+          first, css_class: optional_css_class
+        )
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === parse_a
+  # ========================================================================= #
+  def parse_a(
+      i = 'FileUtils.copyDirectory(): http://commons.apache.org/proper/commons-io/apidocs/org/apache/commons/io/FileUtils.html#copyDirectory%28java.io.File,%20java.io.File%29'
+    )
+    if i.include? ':'
+      splitted    = i.split(':')
+      content     = splitted.first
+      link_target = splitted.last
+      a(
+        link_target,
+        content: content
+      )
+    end
+  end
 
 end; end