html-template 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d7ee8a92f5791e4ac9a898027d3815cb0f4c3619
+  data.tar.gz: f20c60078147da549da1495b13abb55f7aef81f8
+SHA512:
+  metadata.gz: 49601653c67d7e9eb88813fe399e6aa738a8bb232d4048b98aaaa918335e9d22261d24f084243d545c5f6f9ae4849809ac49a30d3b210396e1ca138a47ec8455
+  data.tar.gz: cdbc81e61aabbac50bfd499d3ffa9efa3417d3652fe2610a32c66b39d597a17bc604431b78f1684031a055527f3618de78770e7f0394b84e5f3669972bb73bed

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+
+### 0.0.1 / 2020-02-09
+
+* Everything is new. First release

data/Manifest.txt

@@ -0,0 +1,19 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+lib/html/template.rb
+lib/html/template/version.rb
+test/helper.rb
+test/templates/opml.xml
+test/templates/opml.xml.erb
+test/templates/opml.xml.tmpl
+test/templates/planet/README.md
+test/templates/planet/atom.xml.tmpl
+test/templates/planet/basic/index.html.tmpl
+test/templates/planet/fancy/index.html.tmpl
+test/templates/planet/foafroll.xml.tmpl
+test/templates/planet/opml.xml.tmpl
+test/templates/planet/rss10.xml.tmpl
+test/templates/planet/rss20.xml.tmpl
+test/test_merge.rb

data/README.md

@@ -0,0 +1,26 @@
+# html-template - old-style classic HTML template language / engine like it's 1999 (incl. back-to-the-future ERB converter)
+
+
+* home  :: [github.com/feedreader/pluto](https://github.com/feedreader/pluto)
+* bugs  :: [github.com/feedreader/pluto/issues](https://github.com/feedreader/pluto/issues)
+* gem   :: [rubygems.org/gems/html-template](https://rubygems.org/gems/html-template)
+* rdoc  :: [rubydoc.info/gems/html-template](http://rubydoc.info/gems/html-template)
+* forum :: [groups.google.com/group/wwwmake](http://groups.google.com/group/wwwmake)
+
+
+
+## Usage
+
+To be done
+
+## License
+
+![](https://publicdomainworks.github.io/buttons/zero88x31.png)
+
+The `html-template` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+
+## Questions? Comments?
+
+Send them along to the [wwwmake Forum/Mailing List](http://groups.google.com/group/wwwmake).
+Thanks!

data/Rakefile

@@ -0,0 +1,28 @@
+require 'hoe'
+require './lib/html/template/version.rb'
+
+Hoe.spec 'html-template' do
+
+  self.version = HtmlTemplate::VERSION
+
+  self.summary = "html-template - old-style classic HTML template language / engine like it's 1999 (incl. back-to-the-future ERB converter)"
+  self.description = summary
+
+  self.urls    = ['https://github.com/feedreader/pluto']
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = []
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.2.2'
+  }
+
+end

data/lib/html/template.rb

@@ -0,0 +1,160 @@
+require 'pp'
+require 'date'
+require 'time'
+require 'erb'
+require 'cgi'
+require 'ostruct'
+require 'fileutils'
+
+
+# our own code
+require 'html/template/version'    # note: let version always get first
+
+
+
+class HtmlTemplate
+
+  attr_reader :text   ## returns converted template text (with "breaking" comments!!!)
+
+  def initialize( text )
+    @text     = convert( text )    ## note: keep a copy of the converted template text
+    @template = ERB.new( strip_comments( @text ) )
+  end
+
+
+  VAR_RE = %r{<TMPL_(?<tag>VAR)
+                 \s
+                 (?<ident>[a-zA-Z_0-9]+)
+               >}x
+
+  IF_OPEN_RE = %r{(?<open><)TMPL_(?<tag>IF)
+                  \s
+                  (?<ident>[a-zA-Z_0-9]+)
+                >}x
+
+  IF_CLOSE_RE = %r{(?<close></)TMPL_(?<tag>IF)
+                  >}x
+
+  LOOP_OPEN_RE = %r{(?<open><)TMPL_(?<tag>LOOP)
+                      \s
+                      (?<ident>[a-zA-Z_0-9]+)
+                    >}x
+
+  LOOP_CLOSE_RE = %r{(?<close></)TMPL_(?<tag>LOOP)
+                      >}x
+
+  CATCH_OPEN_RE = %r{(?<open><)TMPL_(?<unknown>[^>]+?)
+                      >}x
+
+
+  ALL_RE = Regexp.union( VAR_RE,
+                         IF_OPEN_RE,
+                         IF_CLOSE_RE,
+                         LOOP_OPEN_RE,
+                         LOOP_CLOSE_RE,
+                         CATCH_OPEN_RE )
+
+
+  def strip_comments( text )
+     ## strip/remove comments lines starting with #
+     buf = String.new('') ## note: '' required for getting source encoding AND not ASCII-8BIT!!!
+     text.each_line do |line|
+        next if line.lstrip.start_with?( '#' )
+        buf << line
+     end
+     buf
+  end
+
+  def convert( text )
+    stack = []
+
+    ## note: convert line-by-line
+    ##   allows comments and line no reporting etc.
+    buf = String.new('')  ## note: '' required for getting source encoding AND not ASCII-8BIT!!!
+    lineno = 0
+    text.each_line do |line|
+      lineno += 1
+
+      if line.lstrip.start_with?( '#' )    ## or make it tripple ### - why? why not?
+         buf << line    ## pass along as is for now!!
+      elsif line.strip.empty?
+         buf << line
+      else
+         buf << line.gsub( ALL_RE ) do |_|
+                  m = $~    ## (global) last match object
+
+                  tag         = m[:tag]
+                  tag_open    = m[:open]
+                  tag_close   = m[:close]
+
+                  ident       = m[:ident]
+                  unknown     = m[:unknown]  # catch all for unknown / unmatched tags
+
+                  ## todo/fix: rename ctx to scope or __ - why? why not?
+                  ## note: peek; get top stack item
+                  ##   if top level (stack empty)  => nothing
+                  ##       otherwise               => channel. or item. etc. (with trailing dot included!)
+                  ctx = stack.empty? ? '' : "#{stack[-1]}."
+
+                  code = if tag == 'VAR'
+                           "<%= #{ctx}#{ident} %>"
+                         elsif tag == 'LOOP' && tag_open
+                           ## assume plural ident e.g. channels
+                           ##  cut-off last char, that is, the plural s channels => channel
+                           ##  note:  ALWAYS downcase (auto-generated) loop iterator/pass name
+                           it = ident[0..-2].downcase
+                           stack.push( it )
+                           "<% #{ctx}#{ident}.each do |#{it}| %>"
+                         elsif tag == 'LOOP' && tag_close
+                           stack.pop
+                           "<% end %>"
+                         elsif tag == 'IF' && tag_open
+                           "<% if #{ctx}#{ident} %>"
+                         elsif tag == 'IF' && tag_close
+                           "<% end %>"
+                         elsif unknown && tag_open
+                          puts "!! ERROR"
+                           "<%# !!error - unknown open tag: #{unknown} %>"
+                         else
+                           raise ArgumentError  ## unknown tag #{tag}
+                         end
+
+                  puts " line #{lineno} - match #{m[0]} replacing with: #{code}"
+                  code
+
+                end
+        end
+      end # each_line
+    buf
+  end # method convert
+
+
+  class Context < OpenStruct
+    ## use a different name - why? why not?
+    ##  e.g. to_h, to_hash, vars, locals, assigns, etc.
+    def get_binding() binding; end
+
+    ## add builtin helpers / shortcuts
+    def h( text ) CGI.escapeHTML( text ); end
+  end # class Template::Context
+
+  def render( **kwargs )
+    ## todo: use locals / assigns or something instead of **kwargs - why? why not?
+    ##        allow/support (extra) locals / assigns - why? why not?
+      ## note: Ruby >= 2.5 has ERB#result_with_hash - use later - why? why not?
+    @template.result( Context.new( **kwargs ).get_binding )
+  end
+end
+
+
+#####################
+## add convenience aliases - why? why not?
+HTMLTemplate = HtmlTemplate
+module HTML
+  Template = HtmlTemplate
+end
+
+
+# say hello
+puts HtmlTemplate.banner   if $DEBUG || (defined?($RUBYLIBS_DEBUG) && $RUBYLIBS_DEBUG)
+

data/lib/html/template/version.rb

@@ -0,0 +1,24 @@
+# note: HtmlTemplate is a class (NOT a module) for now - change - why? why not?
+
+
+class HtmlTemplate
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 1
+    VERSION = [MAJOR,MINOR,PATCH].join('.')
+  
+    def self.version
+      VERSION
+    end
+  
+    def self.banner
+      ### todo: add RUBY_PATCHLEVEL or RUBY_PATCH_LEVEL  e.g. -p124
+      "html-template/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+    end
+  
+    def self.root
+      File.expand_path( File.dirname(File.dirname(File.dirname(File.dirname(__FILE__)))) )
+    end
+  
+  end # class HtmlTemplate
+  

data/test/helper.rb

@@ -0,0 +1,21 @@
+## minitest setup
+require 'minitest/autorun'
+
+## our own code
+require 'html/template'
+
+
+
+########
+## add some "global" helpers
+require 'rexml/document'
+
+def prettify_xml( xml )
+    d = REXML::Document.new( xml )
+
+    formatter = REXML::Formatters::Pretty.new( 2 )  # indent=2
+    formatter.compact = true # This is the magic line that does what you need!
+    pretty_xml = formatter.write( d.root, "" )  # todo/checl: what's 2nd arg used for ??
+    pretty_xml
+end
+

data/test/templates/opml.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0"?>
+<opml version="1.1">
+  <head>
+    <title>OpenStreetMap Blogs</title>
+    <dateModified>Fri, 7 Feb 2020 00:00:00 +0000</dateModified>
+    <ownerName>OpenStreetMap</ownerName>
+  </head>
+
+  <body>
+
+    <outline type="rss"
+             text="Shaun McDonald"
+             xmlUrl="http://blog.shaunmcdonald.me.uk/feed/"
+             htmlUrl="http://blog.shaunmcdonald.me.uk/" />
+
+    <outline type="rss"
+             text="Mapbox"
+             xmlUrl="https://blog.mapbox.com/feed/tagged/openstreetmap/"
+             htmlUrl="https://blog.mapbox.com/" />
+
+    <outline type="rss"
+             text="Mapillary"
+             xmlUrl="https://blog.mapillary.com/rss.xml"
+             htmlUrl="https://blog.mapillary.com" />
+
+    <outline type="rss"
+             text="Richard Fairhurst"
+             xmlUrl="http://blog.systemed.net/rss"
+             htmlUrl="http://blog.systemed.net/" />
+
+  </body>
+</opml>

data/test/templates/opml.xml.erb

@@ -0,0 +1,17 @@
+<?xml version="1.0"?>
+<opml version="1.1">
+  <head>
+    <title><%= name %></title>
+    <dateModified><%= date_822 %></dateModified>
+    <ownerName><%= owner_name %></ownerName>
+  </head>
+
+  <body>
+    <% channels.each do |channel| %>
+    <outline type="rss"
+             text="<%= channel.name %>"
+             xmlUrl="<%= channel.url %>"
+             <% if channel.channel_link %> htmlUrl="<%= channel.channel_link %>"<% end %> />
+    <% end %>
+  </body>
+</opml>

data/test/templates/opml.xml.tmpl

@@ -0,0 +1,17 @@
+<?xml version="1.0"?>
+<opml version="1.1">
+  <head>
+    <title><TMPL_VAR name></title>
+    <dateModified><TMPL_VAR date_822></dateModified>
+    <ownerName><TMPL_VAR owner_name></ownerName>
+  </head>
+
+  <body>
+    <TMPL_LOOP channels>
+    <outline type="rss"
+             text="<TMPL_VAR name>"
+             xmlUrl="<TMPL_VAR url>"
+             <TMPL_IF channel_link> htmlUrl="<TMPL_VAR channel_link>"</TMPL_IF> />
+    </TMPL_LOOP>
+  </body>
+</opml>

data/test/templates/planet/README.md

@@ -0,0 +1,7 @@
+# Notes on (Original) Planet HTML Templates
+
+see <https://people.gnome.org/~jdub/bzr/planet/devel/trunk/examples/>
+
+
+
+

data/test/templates/planet/atom.xml.tmpl

@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+
+	<title><TMPL_VAR name></title>
+	<link rel="self" href="<TMPL_VAR feed ESCAPE="HTML">"/>
+	<link href="<TMPL_VAR link ESCAPE="HTML">"/>
+	<id><TMPL_VAR feed ESCAPE="HTML"></id>
+	<updated><TMPL_VAR date_iso></updated>
+	<generator uri="http://www.planetplanet.org/"><TMPL_VAR generator ESCAPE="HTML"></generator>
+
+<TMPL_LOOP Items>
+	<entry<TMPL_IF channel_language> xml:lang="<TMPL_VAR channel_language>"</TMPL_IF>>
+		<title type="html"<TMPL_IF title_language> xml:lang="<TMPL_VAR title_language>"</TMPL_IF>><TMPL_VAR title ESCAPE="HTML"></title>
+		<link href="<TMPL_VAR link ESCAPE="HTML">"/>
+		<id><TMPL_VAR id ESCAPE="HTML"></id>
+		<updated><TMPL_VAR date_iso></updated>
+		<content type="html"<TMPL_IF content_language> xml:lang="<TMPL_VAR content_language>"</TMPL_IF>><TMPL_VAR content ESCAPE="HTML"></content>
+		<author>
+<TMPL_IF author_name>
+			<name><TMPL_VAR author_name ESCAPE="HTML"></name>
+<TMPL_IF author_email>
+			<email><TMPL_VAR author_email ESCAPE="HTML"></email>
+</TMPL_IF author_email>
+<TMPL_ELSE>
+<TMPL_IF channel_author_name>
+			<name><TMPL_VAR channel_author_name ESCAPE="HTML"></name>
+<TMPL_IF channel_author_email>
+			<email><TMPL_VAR channel_author_email ESCAPE="HTML"></email>
+</TMPL_IF channel_author_email>
+<TMPL_ELSE>
+			<name><TMPL_VAR channel_name ESCAPE="HTML"></name>
+</TMPL_IF>
+</TMPL_IF>
+			<uri><TMPL_VAR channel_link ESCAPE="HTML"></uri>
+		</author>
+		<source>
+<TMPL_IF channel_title>
+			<title type="html"><TMPL_VAR channel_title ESCAPE="HTML"></title>
+<TMPL_ELSE>
+			<title type="html"><TMPL_VAR channel_name ESCAPE="HTML"></title>
+</TMPL_IF>
+<TMPL_IF channel_subtitle>
+			<subtitle type="html"><TMPL_VAR channel_subtitle ESCAPE="HTML"></subtitle>
+</TMPL_IF>
+			<link rel="self" href="<TMPL_VAR channel_url ESCAPE="HTML">"/>
+<TMPL_IF channel_id>
+			<id><TMPL_VAR channel_id ESCAPE="HTML"></id>
+<TMPL_ELSE>
+			<id><TMPL_VAR channel_url ESCAPE="HTML"></id>
+</TMPL_IF>
+<TMPL_IF channel_updated_iso>
+			<updated><TMPL_VAR channel_updated_iso></updated>
+</TMPL_IF>
+<TMPL_IF channel_rights>
+			<rights type="html"><TMPL_VAR channel_rights ESCAPE="HTML"></rights>
+</TMPL_IF>
+		</source>
+	</entry>
+
+</TMPL_LOOP>
+</feed>

data/test/templates/planet/basic/index.html.tmpl

@@ -0,0 +1,88 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+
+### Planet HTML template.
+###
+### This is intended to demonstrate and document Planet's templating
+### facilities, and at the same time provide a good base for you to
+### modify into your own design.
+###
+### The output's a bit boring though, if you're after less documentation
+### and more instant gratification, there's an example with a much
+### prettier output in the fancy-examples/ directory of the Planet source.
+
+### Lines like this are comments, and are automatically removed by the
+### templating engine before processing.
+
+
+### Planet makes a large number of variables available for your templates.
+### See INSTALL for the complete list.  The raw value can be placed in your
+### output file using <TMPL_VAR varname>.  We'll put the name of our
+### Planet in the page title and again in an h1.
+
+<head>
+<title><TMPL_VAR name></title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="generator" content="<TMPL_VAR generator ESCAPE="HTML">">
+</head>
+
+<body>
+<h1><TMPL_VAR name></h1>
+
+### One of the two loops available is the Channels loop.  This allows you
+### to easily create a list of subscriptions, which is exactly what we'll do
+### here.
+
+### Note that we can also expand variables inside HTML tags, but we need
+### to be cautious and HTML-escape any illegal characters using the form
+### <TMPL_VAR varname ESCAPE="HTML">
+
+<div style="float: right">
+<h2>Subscriptions</h2>
+<ul>
+<TMPL_LOOP Channels>
+<li><a href="<TMPL_VAR link ESCAPE="HTML">" title="<TMPL_VAR title ESCAPE="HTML">"><TMPL_VAR name></a> <a href="<TMPL_VAR url ESCAPE="HTML">">(feed)</a></li>
+</TMPL_LOOP>
+</ul>
+</div>
+
+### The other loop is the Items loop, which will get iterated for each
+### news item.
+
+<TMPL_LOOP Items>
+
+### Visually distinguish articles from different days by checking for
+### the new_date flag.  This demonstrates the <TMPL_IF varname> ... </TMPL_IF>
+### check.
+
+<TMPL_IF new_date>
+<h2><TMPL_VAR new_date></h2>
+</TMPL_IF>
+
+### Group consecutive articles by the same author together by checking
+### for the new_channel flag.
+
+<TMPL_IF new_channel>
+<h3><a href="<TMPL_VAR channel_link ESCAPE="HTML">" title="<TMPL_VAR channel_title ESCAPE="HTML">"><TMPL_VAR channel_name></a></h3>
+</TMPL_IF>
+
+
+<TMPL_IF title>
+<h4><a href="<TMPL_VAR link ESCAPE="HTML">"><TMPL_VAR title></a></h4>
+</TMPL_IF>
+<p>
+<TMPL_VAR content>
+</p>
+<p>
+<em><a href="<TMPL_VAR link ESCAPE="HTML">"><TMPL_IF author>by <TMPL_VAR author> at </TMPL_IF><TMPL_VAR date></a></em>
+</p>
+</TMPL_LOOP>
+
+<hr>
+<p>
+<a href="http://www.planetplanet.org/">Powered by Planet!</a><br>
+<em>Last updated: <TMPL_VAR date></em>
+</p>
+</body>
+
+</html>

data/test/templates/planet/fancy/index.html.tmpl

@@ -0,0 +1,125 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+
+### Fancy Planet HTML template.
+### 
+### When combined with the stylesheet and images in the output/ directory
+### of the Planet source, this gives you a much prettier result than the
+### default examples template and demonstrates how to use the config file
+### to support things like faces
+### 
+### For documentation on the more boring template elements, see
+### examples/config.ini and examples/index.html.tmpl in the Planet source.
+
+<head>
+<title><TMPL_VAR name></title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="generator" content="<TMPL_VAR generator ESCAPE="HTML">">
+<link rel="stylesheet" href="planet.css" type="text/css">
+<TMPL_IF feedtype>
+<link rel="alternate" href="<TMPL_VAR feed ESCAPE="HTML">" title="<TMPL_VAR channel_title_plain ESCAPE="HTML">" type="application/<TMPL_VAR feedtype>+xml">
+</TMPL_IF>
+</head>
+
+<body>
+<h1><TMPL_VAR name></h1>
+
+<TMPL_LOOP Items>
+<TMPL_IF new_date>
+<TMPL_UNLESS __FIRST__>
+### End <div class="channelgroup">
+</div>
+### End <div class="daygroup">
+</div>
+</TMPL_UNLESS>
+<div class="daygroup">
+<h2><TMPL_VAR new_date></h2>
+</TMPL_IF>
+
+<TMPL_IF new_channel>
+<TMPL_UNLESS new_date>
+### End <div class="channelgroup">
+</div>
+</TMPL_UNLESS>
+<div class="channelgroup">
+
+### Planet provides template variables for *all* configuration options for
+### the channel (and defaults), even if it doesn't know about them.  We
+### exploit this here to add hackergotchi faces to our channels.  Planet
+### doesn't know about the "face", "facewidth" and "faceheight" configuration
+### variables, but makes them available to us anyway.
+
+<h3><a href="<TMPL_VAR channel_link ESCAPE="HTML">" title="<TMPL_VAR channel_title_plain ESCAPE="HTML">"><TMPL_VAR channel_name></a></h3>
+<TMPL_IF channel_face>
+<img class="face" src="images/<TMPL_VAR channel_face ESCAPE="HTML">" width="<TMPL_VAR channel_facewidth ESCAPE="HTML">" height="<TMPL_VAR channel_faceheight ESCAPE="HTML">" alt="">
+</TMPL_IF>
+</TMPL_IF>
+
+
+<div class="entrygroup" id="<TMPL_VAR id>"<TMPL_IF channel_language> lang="<TMPL_VAR channel_language>"</TMPL_IF>>
+<TMPL_IF title>
+<h4<TMPL_IF title_language> lang="<TMPL_VAR title_language>"</TMPL_IF>><a href="<TMPL_VAR link ESCAPE="HTML">"><TMPL_VAR title></a></h4>
+</TMPL_IF>
+<div class="entry">
+<div class="content"<TMPL_IF content_language> lang="<TMPL_VAR content_language>"</TMPL_IF>>
+<TMPL_VAR content>
+</div>
+
+### Planet also makes available all of the information from the feed
+### that it can.  Use the 'planet-cache' tool on the cache file for
+### a particular feed to find out what additional keys it supports.
+### Comment extra fields are 'author' and 'category' which we
+### demonstrate below.
+
+<p class="date">
+<a href="<TMPL_VAR link ESCAPE="HTML">"><TMPL_IF author>by <TMPL_VAR author> at </TMPL_IF><TMPL_VAR date><TMPL_IF category> under <TMPL_VAR category></TMPL_IF></a>
+</p>
+</div>
+</div>
+
+<TMPL_IF __LAST__>
+### End <div class="channelgroup">
+</div>
+### End <div class="daygroup">
+</div>
+</TMPL_IF>
+</TMPL_LOOP>
+
+
+<div class="sidebar">
+<img src="images/logo.png" width="136" height="136" alt="">
+
+<h2>Subscriptions</h2>
+<ul>
+<TMPL_LOOP Channels>
+<li>
+<a href="<TMPL_VAR url ESCAPE="HTML">" title="subscribe"><img src="images/feed-icon-10x10.png" alt="(feed)"></a> <a <TMPL_IF link>href="<TMPL_VAR link ESCAPE="HTML">" </TMPL_IF><TMPL_IF message>class="message" title="<TMPL_VAR message ESCAPE="HTML">"</TMPL_IF><TMPL_UNLESS message>title="<TMPL_VAR title_plain ESCAPE="HTML">"</TMPL_UNLESS>><TMPL_VAR name></a>
+</li>
+</TMPL_LOOP>
+</ul>
+
+<p>
+<strong>Last updated:</strong><br>
+<TMPL_VAR date><br>
+<em>All times are UTC.</em><br>
+<br>
+Powered by:<br>
+<a href="http://www.planetplanet.org/"><img src="images/planet.png" width="80" height="15" alt="Planet" border="0"></a>
+</p>
+
+<p>
+<h2>Planetarium:</h2>
+<ul>
+<li><a href="http://www.planetapache.org/">Planet Apache</a></li>
+<li><a href="http://planet.debian.net/">Planet Debian</a></li>
+<li><a href="http://planet.freedesktop.org/">Planet freedesktop.org</a></li>
+<li><a href="http://planet.gnome.org/">Planet GNOME</a></li>
+<li><a href="http://planetsun.org/">Planet Sun</a></li>
+<li><a href="http://fedora.linux.duke.edu/fedorapeople/">Fedora People</a></li>
+<li><a href="http://www.planetplanet.org/">more...</a></li>
+</ul>
+</p>
+</div>
+</body>
+
+</html>

data/test/templates/planet/foafroll.xml.tmpl

@@ -0,0 +1,31 @@
+<?xml version="1.0"?>
+<rdf:RDF
+	xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+	xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
+	xmlns:foaf="http://xmlns.com/foaf/0.1/"
+	xmlns:rss="http://purl.org/rss/1.0/"
+	xmlns:dc="http://purl.org/dc/elements/1.1/"
+>
+<foaf:Group>
+	<foaf:name><TMPL_VAR name ESCAPE="HTML"></foaf:name>
+	<foaf:homepage><TMPL_VAR link ESCAPE="HTML"></foaf:homepage>
+	<rdfs:seeAlso rdf:resource="<TMPL_VAR url ESCAPE="HTML">" />
+
+<TMPL_LOOP Channels>
+	<foaf:member>
+		<foaf:Agent>
+			<foaf:name><TMPL_VAR name ESCAPE="HTML"></foaf:name>
+			<foaf:weblog>
+				<foaf:Document rdf:about="<TMPL_VAR link ESCAPE="HTML">">
+					<dc:title><TMPL_VAR title_plain ESCAPE="HTML"></dc:title>
+					<rdfs:seeAlso>
+						<rss:channel rdf:about="<TMPL_VAR url ESCAPE="HTML">" />
+					</rdfs:seeAlso>
+				</foaf:Document>
+			</foaf:weblog>
+		</foaf:Agent>
+	</foaf:member>
+</TMPL_LOOP>
+
+</foaf:Group>
+</rdf:RDF>

data/test/templates/planet/opml.xml.tmpl

@@ -0,0 +1,15 @@
+<?xml version="1.0"?>
+<opml version="1.1">
+	<head>
+		<title><TMPL_VAR name ESCAPE="HTML"></title>
+		<dateModified><TMPL_VAR date_822></dateModified>
+		<ownerName><TMPL_VAR owner_name></ownerName>
+		<ownerEmail><TMPL_VAR owner_email></ownerEmail>
+	</head>
+	
+	<body>
+		<TMPL_LOOP Channels>
+		<outline type="rss" text="<TMPL_VAR name ESCAPE="HTML">" xmlUrl="<TMPL_VAR url ESCAPE="HTML">" title="<TMPL_IF title><TMPL_VAR title ESCAPE="HTML"></TMPL_IF><TMPL_UNLESS title><TMPL_VAR name ESCAPE="HTML"></TMPL_UNLESS>"<TMPL_IF channel_link> htmlUrl="<TMPL_VAR channel_link ESCAPE="HTML">"</TMPL_IF> />
+		</TMPL_LOOP>
+	</body>
+</opml>

data/test/templates/planet/rss10.xml.tmpl

@@ -0,0 +1,37 @@
+<?xml version="1.0"?>
+<rdf:RDF
+	xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+	xmlns:dc="http://purl.org/dc/elements/1.1/"
+	xmlns:foaf="http://xmlns.com/foaf/0.1/"
+	xmlns:content="http://purl.org/rss/1.0/modules/content/"
+	xmlns="http://purl.org/rss/1.0/"
+>
+<channel rdf:about="<TMPL_VAR link ESCAPE="HTML">">
+	<title><TMPL_VAR name ESCAPE="HTML"></title>
+	<link><TMPL_VAR link ESCAPE="HTML"></link>
+	<description><TMPL_VAR name ESCAPE="HTML"> - <TMPL_VAR link ESCAPE="HTML"></description>
+
+	<items>
+		<rdf:Seq>
+<TMPL_LOOP Items>
+			<rdf:li rdf:resource="<TMPL_VAR id ESCAPE="HTML">" />
+</TMPL_LOOP>
+		</rdf:Seq>
+	</items>
+</channel>
+
+<TMPL_LOOP Items>
+<item rdf:about="<TMPL_VAR id ESCAPE="HTML">">
+	<title><TMPL_VAR channel_name ESCAPE="HTML"><TMPL_IF title>: <TMPL_VAR title_plain ESCAPE="HTML"></TMPL_IF></title>
+	<link><TMPL_VAR link ESCAPE="HTML"></link>
+	<TMPL_IF content>
+	<content:encoded><TMPL_VAR content ESCAPE="HTML"></content:encoded>
+	</TMPL_IF>
+	<dc:date><TMPL_VAR date_iso></dc:date>
+	<TMPL_IF author_name>
+	<dc:creator><TMPL_VAR author_name></dc:creator>
+	</TMPL_IF>
+</item>
+</TMPL_LOOP>
+
+</rdf:RDF>

data/test/templates/planet/rss20.xml.tmpl

@@ -0,0 +1,30 @@
+<?xml version="1.0"?>
+<rss version="2.0">
+
+<channel>
+	<title><TMPL_VAR name></title>
+	<link><TMPL_VAR link ESCAPE="HTML"></link>
+	<language>en</language>
+	<description><TMPL_VAR name ESCAPE="HTML"> - <TMPL_VAR link ESCAPE="HTML"></description>
+
+<TMPL_LOOP Items>
+<item>
+	<title><TMPL_VAR channel_name ESCAPE="HTML"><TMPL_IF title>: <TMPL_VAR title_plain ESCAPE="HTML"></TMPL_IF></title>
+	<guid><TMPL_VAR id ESCAPE="HTML"></guid>
+	<link><TMPL_VAR link ESCAPE="HTML"></link>
+	<TMPL_IF content>
+	<description><TMPL_VAR content ESCAPE="HTML"></description>
+	</TMPL_IF>
+	<pubDate><TMPL_VAR date_822></pubDate>
+	<TMPL_IF author_email>
+	<TMPL_IF author_name>
+	<author><TMPL_VAR author_email> (<TMPL_VAR author_name>)</author>
+	<TMPL_ELSE>
+	<author><TMPL_VAR author_email></author>
+	</TMPL_IF>
+	</TMPL_IF>
+</item>
+</TMPL_LOOP>
+
+</channel>
+</rss>

data/test/test_merge.rb

@@ -0,0 +1,103 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_merge.rb
+
+require 'helper'
+
+
+
+class TestMerge < MiniTest::Test
+
+  Site     = Struct.new( :name, :owner_name, :date_822, :channels )
+  Channel  = Struct.new( :name, :url, :channel_link )
+
+  def sample1
+       Site.new( 'OpenStreetMap Blogs',
+                 'OpenStreetMap',
+                  Date.new( 2020, 2, 7 ).rfc2822,
+                 [Channel.new( 'Shaun McDonald',
+                               'http://blog.shaunmcdonald.me.uk/feed/',
+                               'http://blog.shaunmcdonald.me.uk/' ),
+                  Channel.new( 'Mapbox',
+                               'https://blog.mapbox.com/feed/tagged/openstreetmap/',
+                               'https://blog.mapbox.com/' ),
+                  Channel.new( 'Mapillary',
+                               'https://blog.mapillary.com/rss.xml',
+                               'https://blog.mapillary.com' ),
+                  Channel.new( 'Richard Fairhurst',
+                               'http://blog.systemed.net/rss',
+                               'http://blog.systemed.net/' )]
+                )
+  end
+
+  def test_merge
+     site = sample1
+     pp site
+
+     xml      = File.open( "#{HtmlTemplate.root}/test/templates/opml.xml",      "r:utf-8" ).read
+     template = File.open( "#{HtmlTemplate.root}/test/templates/opml.xml.tmpl", "r:utf-8" ).read
+
+     t = HtmlTemplate.new( template )
+
+     assert_equal prettify_xml( xml ),
+                  prettify_xml( t.render( name:       site.name,
+                                          owner_name: site.owner_name,
+                                          date_822:   site.date_822,
+                                          channels:   site.channels ))
+  end
+
+
+  def test_convert
+    text     = File.open( "#{HtmlTemplate.root}/test/templates/opml.xml.erb", "r:utf-8" ).read
+    template = File.open( "#{HtmlTemplate.root}/test/templates/opml.xml.tmpl", "r:utf-8" ).read
+
+    t = HtmlTemplate.new( template )
+
+    assert_equal text, t.text
+  end
+
+=begin
+<!-- students.tmpl -->
+<TMPL_LOOP NAME=STUDENT>
+   <p>
+   Name: <TMPL_VAR NAME=NAME><br/>
+   GPA: <TMPL_VAR NAME=GPA>
+   </p>
+</TMPL_LOOP>
+
+# students.pl
+my $template = HTML::Template->new(filename => 'students.tmpl');
+
+$template->param(
+   STUDENT => [
+      { NAME => 'Bluto Blutarsky', GPA => '0.0' },
+      { NAME => 'Tracey Flick'   , GPA => '4.0' },
+   ]
+);
+print $template->output;
+=end
+
+  Student = Struct.new( :name, :gpa )
+
+  def test_students_example
+
+    tmpl =<<TXT
+    <TMPL_LOOP students>
+       <p>
+       Name: <TMPL_VAR name><br/>
+       GPA: <TMPL_VAR gpa>
+       </p>
+    </TMPL_LOOP>
+TXT
+
+    t = HtmlTemplate.new( tmpl )
+    puts t.text
+    puts "---"
+    puts t.render( students: [ Student.new( 'Bluto Blutarsky', 0.0 ),
+                               Student.new( 'Tracey Flick',    4.0 ) ])
+
+
+    assert true   # assume it's alright if we get here
+  end
+end
+

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: html-template
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-02-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+description: html-template - old-style classic HTML template language / engine like
+  it's 1999 (incl. back-to-the-future ERB converter)
+email: wwwmake@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/html/template.rb
+- lib/html/template/version.rb
+- test/helper.rb
+- test/templates/opml.xml
+- test/templates/opml.xml.erb
+- test/templates/opml.xml.tmpl
+- test/templates/planet/README.md
+- test/templates/planet/atom.xml.tmpl
+- test/templates/planet/basic/index.html.tmpl
+- test/templates/planet/fancy/index.html.tmpl
+- test/templates/planet/foafroll.xml.tmpl
+- test/templates/planet/opml.xml.tmpl
+- test/templates/planet/rss10.xml.tmpl
+- test/templates/planet/rss20.xml.tmpl
+- test/test_merge.rb
+homepage: https://github.com/feedreader/pluto
+licenses:
+- Public Domain
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: html-template - old-style classic HTML template language / engine like it's
+  1999 (incl. back-to-the-future ERB converter)
+test_files: []