Remarkably 0.5.0 → 0.6.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2e7816c6ce5b2d78644b586785f8ac1cd4264c80ffe2effaa9dff9b3189f45c8
+  data.tar.gz: e7851ae2c5c0c1c765165a4d83b868dd61879a133353ef54f43f221e062c7292
+SHA512:
+  metadata.gz: e7ae4da12943f7b6727b8df67ad20b115a88a58cc7f6a653a1c8e4d61403d02582cc568cae584313a4e94e3cd9fca644bab8d5166d4080eee7c231f69427a90c
+  data.tar.gz: 2f3041cf4e85dd070bb70217a885b63b98c0ddd1e5cd36423942be0479f87252dfa0f3991cd79cf5fc2b95d52eb9ed6b4638e7c0524cd6f375610106c54f17c0

data/.gitignore

@@ -0,0 +1,6 @@
+pkg/*
+*.gem
+.bundle
+vendor/*
+*.swp
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in remarkably.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2007- Clive Crous
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,89 @@
+Remarkably can be used as template enginge generating HTML pages by
+ calling "pure" ruby methods, e.g.:
+ html do
+   header do
+   title "my header"
+   end
+   body do
+     h1 "big header"
+     ul do
+       (1..2).each do |n|
+         li "line #{n}"
+       end
+     end
+   end
+ end
+
+ This beautiful approach allows ruby control statements while generating
+ the desired page without the hassle other template engines have when
+ mixing HTML tags and ruby control.
+
+ A remarkably fact about Remarkably is, that is does not know anything
+ about HTML tags. It handles the generating of the desired page source by
+ using the ruby mechanism of the "method_missing" message: every(!) unkown
+ method will be recovered by generating appropriate HTML statements.
+
+ One of the consequences of approach is, that the parameters of such a "tag"
+ must follow some rules: it have to look like
+ sym(args, hash, &block)
+ that means, eventual arguments must be set before an eventual hash, which
+ sets the tag attributes, followed by an eventual block, which contains included
+ other tags.
+
+ Sounds terrible complicated, but it is not, e.g.: the ruby statement
+ a('Home', :href => "#{rs(:index)}")
+ will generate after the ruby interpolation
+ <a href="/index">Home</a>
+
+ To generate an anchor with a graphic icon like
+ <a href="/help" title="Help">
+   <img src="icons/help.png" border="0" alt="Help"/>
+ </a>
+ can be produced e.g. by
+ def gen_link(txt, href, icon)
+   a(:href => href, :title => txt) do
+     img(:src => icon, :border => 0, :alt => txt)
+   end # a
+ end # genlink
+ gen_link('Help', "#{rs(:help)}", 'icons/help.png')
+ You see, it is also possible to call methods when generating the page.
+
+ This shows another challenge: you can not generate a tag, which name
+ conflicts with a well known ruby method, e.g.:
+ p "this is some text"
+ will use the kernel method p to print the message to the console. To
+ generate a paragraph, you can use an upcase P like
+ P "this is another paragraph"
+ Dont worry, Remarkably uses .downcase when generating the code:
+ <p>this is another paragraph</p>
+ which keeps it XHTML conform.
+
+ The missing_method approach also has the consequence, that Reamrkably
+ can not check for valid HTML tags, e.g.:
+ xyz(:abc => "nonsens")
+ generates a syntatic correct, but semantic wrong output
+ <xyz abc="nonsens">
+ So check careful the page source offered from your browser.
+
+ There are at least two differences to Markaby: the "syntactic" sugar
+ for .class and .id! is not supported, e.g.:
+ div.myclass
+ must be edited to
+ div(:class => 'myclass')
+ and
+ div.myid!
+ must be edited to
+ div(:id => 'myid')
+
+ To insert some (eventual ruby interpolated) text in the page use text(), e.g.:
+ text("#{@content}")
+
+ To use Remarkably within Ramaze just set in your controller:
+ class Controller < Ramaze::Controller
+   helper :remarkably
+   engine :Remarkably
+ end # controller
+ and put your Remarkably files named *.rem into the view/ directory
+
+ To keep Ramaze happy, you should terminate your .rem files with the line:
+   remarkably_engine

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*.rb"
+end

data/examples/basic_css.rb

@@ -0,0 +1,38 @@
+require '../loadpath'
+require 'remarkably/engines/css'
+require 'remarkably/engines/css/helpers'
+
+class Page
+  include Remarkably::Common
+
+  def style
+    body do
+      background_color :white
+      color :black
+
+      div( "#header" ) do
+        ul do
+          margin 0
+          padding 8.px, 2.px, 4.px, 1.5.em
+          li do
+            padding_left 2.em
+          end
+        end
+      end
+
+      P do
+        color :black
+        font_size 12.pt
+      end
+
+      P(".special") do
+        color :blue
+      end
+
+    end
+  end
+
+end
+
+page = Page.new
+puts page.style.to_s

data/examples/basic_html.rb

@@ -0,0 +1,95 @@
+require '../loadpath'
+require 'remarkably/engines/html'
+require 'remarkably/engines/css/helpers'
+
+class Site
+  include Remarkably::Common
+
+  def index
+    page do
+      P "Hello World!"
+    end
+  end
+
+  def exit
+    page do
+      P "Goodbye cruel world"
+    end
+  end
+
+  private
+
+  def page
+    html do
+      head do
+        title "A basic Remarkably HTML example"
+        style do
+          body {
+            margin 0
+            padding 0
+            font_size 12.pt
+            background_color :white
+          }
+          div("#header") {
+            margin 0
+            padding 0
+            background_color "#ffd"
+            border_bottom 1.px, :dashed, :black
+            h1 {
+              margin 0
+              padding 0, 0, 4.px, 0
+              text_align :center
+              font_size 24.pt
+              font_weight :normal
+              a {
+                color :black
+              }
+            }
+          }
+          div("#footer") {
+            text_align :right
+            font_size 9.pt
+            margin 16.px, 0, 0, 0
+            padding 0
+            border_top 1.px, :solid, :black
+          }
+          div("#content") {
+            margin 16.px
+          }
+          a {
+            color :blue
+          }
+          a(":hover") {
+            color :red
+          }
+        end
+      end
+      body do
+        div :id => "header" do
+          h1 do
+            text "A basic "
+            a "Remarkably", :href => "http://www.darkarts.co.za/project/remarkably"
+            text " HTML example"
+          end
+        end
+        div :id => "content" do
+          yield
+        end
+        div :id => "footer" do
+          text "This was a "
+          a "Remarkably", :href => "http://www.darkarts.co.za/project/remarkably"
+          text " example."
+        end
+      end
+    end
+  end
+
+end
+
+site = Site.new
+
+puts "\n== Index Page ==\n"
+puts site.index.to_s
+
+puts "\n== Exit Page ==\n"
+puts site.exit.to_s

data/examples/basic_xml.rb

@@ -0,0 +1,51 @@
+require '../loadpath'
+require 'remarkably/engines/xml'
+
+class Products
+  include Remarkably::Common
+
+  def range
+    products do
+      (1...10).each do |product_number|
+        product :id => product_number do
+          colour %w{red green blue yellow black}[product_number%5]
+          description "This is the description for product No #{product_number}"
+        end
+      end
+    end
+  end
+
+  def range_page
+    html do
+      head do
+        title "Our product range"
+      end
+      body do
+        h1 "Our product range"
+        table do
+          tr do
+            th "Product ID"
+            th "Product Description"
+            th "Colour"
+          end
+          (1...10).each do |product_number|
+            tr do
+              td product_number
+              td "This is the description for product No #{product_number}"
+              td %w{red green blue yellow black}[product_number%5]
+            end
+          end
+        end
+      end
+    end
+  end
+
+end
+
+our_products = Products.new
+
+puts "\n== Product Range ==\n"
+puts our_products.range.to_s
+
+puts "\n== Product Range web page ==\n"
+puts our_products.range_page.to_s

data/examples/bookmarklets.rb

@@ -0,0 +1,62 @@
+require '../loadpath'
+require 'remarkably/engines/html'
+require 'remarkably/engines/html/helpers'
+
+class Site
+  include Remarkably::Common
+
+  def index
+    html do
+      head do
+        title "A Remarkably bookmarklet example"
+      end
+      body do
+        h1 "The bookmarklet"
+        P do
+          text "Simply click \""
+          java_script = %w{h1 h2 h3 h4 p a}.inject('') do |result,tag|
+            result+= <<-EOS
+
+tags = document.getElementsByTagName("#{tag}");
+for (i=0;i<tags.length;i++) {
+  header_content = tags[i].innerHTML;
+  tags[i].innerHTML =
+    '<span style="border:1px solid black;color:black;background-color:#FFA">&lt;#{tag}&gt;</span>' + header_content +
+    '<span style="border:1px solid black;color:black;background-color:#FFA">&lt;/#{tag}&gt;</span>';
+}
+
+EOS
+          end
+          bookmarklet java_script, "Show some tags"
+          text "\", or drag it and drop it on your toolbar to use it on any site."
+        end
+        h1 "Header 1"
+        lorum_ipsum
+        h2 "Header 2"
+        lorum_ipsum
+        h3 "Header 3"
+        lorum_ipsum
+        h3 "Header 3"
+        lorum_ipsum
+        h2 "Header 2"
+        lorum_ipsum
+        h3 "Header 3"
+        lorum_ipsum
+        h1 "Header 1"
+        lorum_ipsum
+        h2 "Header 2"
+      end
+    end
+  end
+
+  private
+
+  def lorum_ipsum
+    P <<-EOS
+Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vestibulum vehicula lectus vitae sapien. Nam quis lorem id velit tempor convallis. Nullam est orci, placerat a, hendrerit rutrum, dictum quis, magna. Nulla pharetra libero ac risus. Fusce in elit. Cras vel nisl nec enim tincidunt vehicula. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent sollicitudin, libero sit amet hendrerit fermentum, odio nisl mollis enim, quis faucibus nisi nisi eu erat. Vivamus eu urna at velit mattis congue. Morbi feugiat erat vel libero.
+    EOS
+  end
+
+end
+
+puts Site.new.index.to_s

data/examples/headerfooter.rb

@@ -0,0 +1,38 @@
+require '../loadpath'
+require 'remarkably/engines/html'
+
+class Page
+  include Remarkably::Common
+
+  def header
+    h1 "A Header and Footer example with Remarkably"
+    hr
+  end
+
+  def footer
+    hr
+    text "Find out more about Remarkably "
+    a "here", :href=>"http://www.darkarts.co.za"
+    text "."
+  end
+
+  def entire_page
+    html do
+      head do
+        title "Remarkably: Headers and Footers"
+      end
+      body do
+        header
+        P "This is some page content"
+        footer
+      end
+    end
+  end
+
+end
+
+page = Page.new
+
+puts "Just the header => #{page.header}"
+puts "Just the footer => #{page.footer}"
+puts "The entire page => #{page.entire_page}"

data/examples/pages.rb

@@ -0,0 +1,54 @@
+require '../loadpath'
+require 'remarkably/engines/html'
+
+class Page
+  include Remarkably::Common
+
+  def main_page
+    page do
+      P "Hello World!"
+    end
+  end
+
+  def exit_page
+    page do
+      P "Goodbye World!"
+    end
+  end
+
+  private
+
+  def menu
+    div :id=>"menu" do
+      ul do
+        li 'foo'
+        li 'bar'
+        li 'baz'
+      end
+    end
+  end
+
+  def footer
+    div "This is a footer", :id=>"footer"
+  end
+
+  def page
+    html do
+      head do
+        title "Test Page"
+      end
+      body do
+        menu
+        div :id => "content" do
+          yield
+        end
+        footer
+      end
+    end
+  end
+
+end
+
+page = Page.new
+puts "Main Page => #{page.main_page}"
+puts "Exit Page => #{page.exit_page}"

data/lib/remarkably.rb

@@ -1,18 +1,32 @@
+require 'remarkably/version'
+
 module Remarkably
 
+  module Config
+    class << self
+      attr_accessor :default_engine
+    end
+  end
+
   module Base
 
     class Engine
+
+      attr_reader :remarkably_engine
+
       def initialize *args, &block
         clear!
+        @remarkably_engine = self
         self.instance_eval( &block ) if block_given?
       end
 
       def missing_method(sym, context, *args, &block)
         @context = context
         hash = args.last.is_a?(Hash) ? args.pop : {}
-        if methods.index( sym.to_s )
-          self.send( sym, args, hash, &block )
+        responder ||= context.remarkably_engine if context.remarkably_engine.respond_to?( sym )
+        responder ||= self if self.respond_to?( sym )
+        if responder
+          responder.send( sym, args, hash, &block )
         else
           method!(sym, args, hash, &block)
         end
@@ -42,7 +56,7 @@ module Remarkably
   module Common
 
     def method_missing(sym, *args, &block)
-      @remarkably_engine ||= eval("Engines::#{Engines::constants[0]}.new")
+      @remarkably_engine ||= Config.default_engine.new
       @remarkably_engine.send( :missing_method, sym, self, *args, &block )
     end
 

data/lib/remarkably/engines/css.rb

@@ -1,14 +1,16 @@
-require "#{File::dirname(__FILE__)}/../../remarkably"
+require 'remarkably'
 
 module Remarkably
   module Engines
     class CSS < Base::Engine
       def method! sym, args, hash, &block
         sym = sym.to_s.downcase
+        sym = "##{sym}".chop if sym[-1].chr == '!'
+        sym = ".#{sym}".chop if sym[-1].chr == '?'
 
         if block_given?
           current_prefix = @css_prefix
-          @css_prefix = (@css_prefix+" #{sym}#{args.map{|a|a.to_s}.join}").strip
+          @css_prefix = (@css_prefix+"#{sym}#{args.map{|a|a.to_s}.join} ")
           @css_depth+=1
           @css_prefix_rendered=false
           block.call
@@ -20,15 +22,37 @@ module Remarkably
               @output.chop!
               @output << "}"
             end
-            @output << "\n#{@css_prefix} {"
+            @output << "\n#{@css_prefix}{"
             @css_prefix_rendered = true
             @css_first_use = false
           end
-          @output << "#{sym.gsub('_','-')}:#{args.map{|a|a.to_s}.join(' ')};"
+          # XXX This line below is more complex than it needs to be, for some
+          # reason gsub in ruby 1.9.2 throws a method_missing breaking
+          # everything :(
+          @output << "#{sym.to_s.split('').map{|n|n=='_' ? '-' : n}.join('')}:#{args.map{|a|a.to_s}.join(' ')};"
         end
         self
       end
 
+      def css_prefix prefix, &block
+        @css_prefix << prefix
+        block.call
+        @css_prefix.chop!
+        self
+      end
+
+      def css_class args, hash, &block
+        css_prefix ".", &block
+      end
+
+      def css_id args, hash, &block
+        css_prefix "#", &block
+      end
+
+      def css_pseudo args, hash, &block
+        css_prefix ":", &block
+      end
+
       def to_s
         "#{super.chop}}".strip+"\n"
       end
@@ -42,6 +66,7 @@ module Remarkably
       end
 
     end
+    Config.default_engine = CSS
   end
 end
 

data/lib/remarkably/engines/css/helpers.rb

@@ -5,3 +5,11 @@
     end
   end
 end
+
+class Array
+  def css *args, &block
+    self.each do |item|
+      eval( 'self', block.binding ).send( item.to_sym , *args, &(lambda { yield }) )
+    end
+  end
+end

data/lib/remarkably/engines/html.rb

@@ -1,6 +1,6 @@
-require "#{File::dirname(__FILE__)}/../../remarkably"
-require "#{File::dirname(__FILE__)}/xml"
-require "#{File::dirname(__FILE__)}/css"
+require 'remarkably'
+require 'remarkably/engines/xml'
+require 'remarkably/engines/css'
 
 module Remarkably
   module Engines
@@ -20,5 +20,6 @@ module Remarkably
         method!( :style, args, hash )
       end
     end
+    Config.default_engine = HTML
   end
 end

data/lib/remarkably/engines/html/helpers.rb

@@ -0,0 +1,19 @@
+module Remarkably
+  module Engines
+    class HTML < XML
+      def bookmarklet args, hash, &block
+        inline_javascript = args.shift.split("\n").map{|l|l.strip}.join('')
+        inline_javascript.gsub!( '%', '%25' )
+        { "'" => "%27",
+          '"' => "%22",
+          '&' => "%26",
+          '/' => "%2F",
+        }.each_pair do |key,value|
+          inline_javascript.gsub!( key, value )
+        end
+        hash[:href]=%|javascript:(function(){#{inline_javascript}})();|
+        method!( :a, args, hash, &block )
+      end
+    end
+  end
+end

data/lib/remarkably/engines/xml.rb

@@ -1,4 +1,4 @@
-require "#{File::dirname(__FILE__)}/../../remarkably"
+require 'remarkably'
 
 module Remarkably
   module Engines
@@ -10,7 +10,7 @@ module Remarkably
         tag_attributes =
           hash.inject([]){|s,(k,v)| s << %{#{k.to_s.downcase}="#{v}"} }
 
-        @output << ["<#{sym}", tag_attributes].flatten.grep(/\S/).join(' ')
+        @output << ( ["<#{sym}"] +  tag_attributes).join(' ')
 
         if block_given? or not args.empty?
           @output << ">"
@@ -23,11 +23,12 @@ module Remarkably
         self
       end
 
-      def text args, hash, &block
+      def text args, hash
         @output << args.join
         self
       end
 
     end
+    Config.default_engine = XML
   end
 end

data/lib/remarkably/version.rb

@@ -0,0 +1,3 @@
+module Remarkably
+  VERSION = "0.6.2"
+end

data/loadpath.rb

@@ -0,0 +1 @@
+$:.unshift "#{File::dirname(__FILE__)}/lib/"

data/remarkably.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "remarkably/version"
+
+Gem::Specification.new do |s|
+  s.name        = "Remarkably"
+  s.version     = Remarkably::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Clive Crous"]
+  s.email       = ["clive@crous.co.za"]
+  s.homepage    = 'https://github.com/clivecrous/Remarkably'
+  s.summary     = %q{A very tiny Markaby-like XML,HTML and CSS builder}
+  s.description = %q{Remarkably is a very tiny Markaby-like XML,HTML and CSS builder}
+  s.license     = "MIT"
+
+  s.add_development_dependency "bundler", ">= 1.0.0"
+  s.add_development_dependency "rake", ">= 0.8.7"
+  s.add_development_dependency "rspec", ">= 1.3.0"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/engines/css.rb

@@ -0,0 +1,62 @@
+require 'remarkably/engines/css'
+
+describe Remarkably::Engines::CSS do
+  include Remarkably::Common
+
+  before( :all ) do
+    @remarkably_engine = Remarkably::Engines::CSS.new
+  end
+
+  it "Does basic styling" do
+    body do
+      P do
+        background_color :white
+        border "1px", :solid, :black
+      end
+      div do
+        color :blue
+      end
+    end.to_s.should == "body p {background-color:white;border:1px solid black}\nbody div {color:blue}\n"
+  end
+
+  it "uses css class" do
+    div do
+      css_class do
+        foo do
+          color :red
+        end
+      end
+      bar? do
+        color :blue
+      end
+      P do
+        color :green
+      end
+    end.to_s.should == "div .foo {color:red}\ndiv .bar {color:blue}\ndiv p {color:green}\n"
+  end
+
+  it "uses css id" do
+    div do
+      css_id do
+        foo do
+          color :red
+        end
+        bar do
+          color :blue
+        end
+      end
+      baz! do
+        color :green
+      end
+    end.to_s.should == "div #foo {color:red}\ndiv #bar {color:blue}\ndiv #baz {color:green}\n"
+  end
+
+  it "uses css pseudo" do
+    css_pseudo do
+      hover do
+        color :red
+      end
+    end.to_s.should == ":hover {color:red}\n"
+  end
+
+end

data/spec/engines/css/helpers.rb

@@ -0,0 +1,32 @@
+require 'remarkably/engines/css'
+require 'remarkably/engines/css/helpers'
+
+describe "Remarkably::Engines::CSS Helpers" do
+  include Remarkably::Common
+
+  before( :all ) do
+    @remarkably_engine = Remarkably::Engines::CSS.new
+  end
+
+  it "Uses numbers correctly" do
+    body do
+      P do
+        background_color :white
+        border 1.px, :solid, :black
+        font_size 2.5.em
+      end
+      div do
+        color :blue
+      end
+    end.to_s.should == "body p {background-color:white;border:1px solid black;font-size:2.5em}\nbody div {color:blue}\n"
+  end
+
+  it "uses arrays" do
+    body do
+      %w{h1 h2 h3}.css do
+        color :blue
+      end
+    end.to_s.should == "body h1 {color:blue}\nbody h2 {color:blue}\nbody h3 {color:blue}\n"
+  end
+
+end

data/spec/engines/html.rb

@@ -0,0 +1,81 @@
+require 'remarkably/engines/html'
+
+describe "Remarkably::Engine::HTML instance_eval" do
+  it "performs an instance_eval when a block is given to new" do
+    Remarkably::Engines::HTML.new do
+      html do
+        body do
+          P "Hello World!"
+        end
+      end
+    end.to_s.should == "<html><body><p>Hello World!</p></body></html>"
+  end
+end
+
+describe Remarkably::Engines::HTML do
+  include Remarkably::Common
+
+  before( :all ) do
+    @remarkably_engine = Remarkably::Engines::HTML.new
+  end
+
+  it "Accepts a string as a paramater" do
+    testing( "Hello World" ).to_s.should ==
+      "<testing>Hello World</testing>"
+  end
+
+  it "Accepts a block as a paramater" do
+    testing do
+      text "Hello World"
+    end.to_s.should ==
+      "<testing>Hello World</testing>"
+  end
+
+  it "Accepts multiple strings as paramaters" do
+    testing( "Hello", "World" ).to_s.should ==
+      "<testing>HelloWorld</testing>"
+  end
+
+  it "Closes empty tags neatly" do
+    testing.to_s.should ==
+      "<testing/>"
+  end
+
+  it "Accepts only attributes" do
+    testing( :id => "attributes" ).to_s.should ==
+      '<testing id="attributes"/>'
+  end
+
+  it "Accepts strings and attributes" do
+    testing( "Hello ", "World",
+             :id => "attributes", :class => "test" ).to_s.should ==
+      '<testing id="attributes" class="test">Hello World</testing>'
+  end
+
+  it "Allows yielding for internal content" do
+    def page
+      html do
+        body do
+          yield
+        end
+      end
+    end
+      
+    page do
+      P "Internal Content"
+    end.to_s.should == "<html><body><p>Internal Content</p></body></html>"
+  end
+
+  it "Does auto-style" do
+    html do
+      head do
+        style do
+          body do
+            color :blue
+          end
+        end
+      end
+    end.to_s.should == "<html><head><style>\nbody {color:blue}\n</style></head></html>"
+  end
+
+end

data/spec/engines/xml.rb

@@ -0,0 +1,92 @@
+require 'remarkably/engines/xml'
+
+describe "Remarkably::Engine::XML explicit engine usage" do
+  it "performs an instance_eval when a block is given to new" do
+    xml = Remarkably::Engines::XML.new
+    xml.html do
+      xml.body do
+        xml.P "Hello World!"
+      end
+    end.to_s.should == "<html><body><p>Hello World!</p></body></html>"
+  end
+end
+
+describe "Remarkably::Engine::XML instance_eval" do
+  it "performs an instance_eval when a block is given to new" do
+    Remarkably::Engines::XML.new do
+      html do
+        body do
+          P "Hello World!"
+        end
+      end
+    end.to_s.should == "<html><body><p>Hello World!</p></body></html>"
+  end
+end
+
+describe Remarkably::Engines::XML do
+  include Remarkably::Common
+
+  before( :all ) do
+    @remarkably_engine = Remarkably::Engines::XML.new
+  end
+
+  it "Accepts a string as a paramater" do
+    testing( "Hello World" ).to_s.should ==
+      "<testing>Hello World</testing>"
+  end
+
+  it "Accepts a block as a paramater" do
+    testing do
+      text "Hello World"
+    end.to_s.should ==
+      "<testing>Hello World</testing>"
+  end
+
+  it "Accepts multiple strings as paramaters" do
+    testing( "Hello", "World" ).to_s.should ==
+      "<testing>HelloWorld</testing>"
+  end
+
+  it "Closes empty tags neatly" do
+    testing.to_s.should ==
+      "<testing/>"
+  end
+
+  it "Accepts only attributes" do
+    testing( :id => "attributes" ).to_s.should ==
+      '<testing id="attributes"/>'
+  end
+
+  it "Accepts strings and attributes" do
+    testing( "Hello ", "World",
+             :id => "attributes", :class => "test" ).to_s.should ==
+      '<testing id="attributes" class="test">Hello World</testing>'
+  end
+
+  it "Allows yielding for internal content" do
+    def page
+      html do
+        body do
+          yield
+        end
+      end
+    end
+      
+    page do
+      P "Internal Content"
+    end.to_s.should == "<html><body><p>Internal Content</p></body></html>"
+  end
+
+  it "Does not auto-style" do
+    html do
+      head do
+        style do
+          body do
+            color :blue
+          end
+        end
+      end
+    end.to_s.should == "<html><head><style><body><color>blue</color></body></style></head></html>"
+  end
+
+end

data/utility/html2rem.rb

@@ -0,0 +1,55 @@
+require 'rubygems'
+require 'xml/libxml'
+
+def process_element( element, level = 0)
+  children = 0
+  element.each_child { children+=1 }
+
+  if element.text?
+    text = element.to_s.strip
+    return if text.size == 0
+  else
+    if children == 1 and element.child.name == "text"
+      text = element.child.to_s.strip
+    else
+      text = nil
+    end
+  end
+
+  element.name = "P" if element.name == "p"
+
+  indentation = ' '*level
+  print indentation + "#{element.name.strip}"
+
+  if text and element.name != "text"
+    print " \"#{text}\""
+  end
+
+  attributes=[]
+  element.each_attr do |attribute|
+    if attribute.name.grep( /-/ ).size > 0
+      attributes << "\"#{attribute.name}\" => \"#{attribute.value}\""
+    else
+      attributes << ":#{attribute.name} => \"#{attribute.value}\""
+    end
+  end
+  if not attributes.empty?
+    print "," if text and element.name != "text"
+    print " "+attributes.join(', ').strip 
+  end
+  if not (text and element.name != "text")
+    if element.children?
+      puts " do"
+      element.each do |inner_element|
+        process_element( inner_element, level + 2 )
+      end
+      print indentation + "end" if element.children?
+    else
+      print " \"#{text}\"" if text
+    end
+  end
+  print "\n"
+end
+
+html =  XML::Document.file( ARGV[0] ) 
+process_element( html.root )

metadata

@@ -1,53 +1,114 @@
---- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.3
-specification_version: 1
+--- !ruby/object:Gem::Specification
 name: Remarkably
-version: !ruby/object:Gem::Version 
-  version: 0.5.0
-date: 2007-05-24 00:00:00 +02:00
-summary: Remarkably is a very tiny Markaby-like XML builder
-require_paths: 
-- lib
-email: clive@darkarts.co.za
-homepage: http://www.darkarts.co.za/
-rubyforge_project: 
-description: 
-autorequire: 
-default_executable: 
-bindir: bin
-has_rdoc: false
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+version: !ruby/object:Gem::Version
+  version: 0.6.2
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
-authors: 
+authors:
 - Clive Crous
-files: 
-- lib/remarkably
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-06-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+description: Remarkably is a very tiny Markaby-like XML,HTML and CSS builder
+email:
+- clive@crous.co.za
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README
+- Rakefile
+- examples/basic_css.rb
+- examples/basic_html.rb
+- examples/basic_xml.rb
+- examples/bookmarklets.rb
+- examples/headerfooter.rb
+- examples/pages.rb
 - lib/remarkably.rb
-- lib/remarkably/engines
-- lib/remarkably/engines/css
-- lib/remarkably/engines/xml.rb
-- lib/remarkably/engines/html.rb
 - lib/remarkably/engines/css.rb
 - lib/remarkably/engines/css/helpers.rb
-test_files: []
-
+- lib/remarkably/engines/html.rb
+- lib/remarkably/engines/html/helpers.rb
+- lib/remarkably/engines/xml.rb
+- lib/remarkably/version.rb
+- loadpath.rb
+- remarkably.gemspec
+- spec/engines/css.rb
+- spec/engines/css/helpers.rb
+- spec/engines/html.rb
+- spec/engines/xml.rb
+- utility/html2rem.rb
+homepage: https://github.com/clivecrous/Remarkably
+licenses:
+- MIT
+metadata: {}
+post_install_message:
 rdoc_options: []
-
-extra_rdoc_files: []
-
-executables: []
-
-extensions: []
-
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-dependencies: []
-
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: A very tiny Markaby-like XML,HTML and CSS builder
+test_files:
+- spec/engines/css.rb
+- spec/engines/css/helpers.rb
+- spec/engines/html.rb
+- spec/engines/xml.rb