HTML Generation (Next Generation CGI)

Hi,

This idea for the next generation of CGI has me thinking (see
http://rubygarden.org/ruby?NextGenerationCGI). It seems that CGI would be
best if it were broken in two. One side handled generating html, and the
other handled all the other stuff (params, headers, etc…).

Last night I started prototyping some of my ideas and came up with the
following:

class HtmlGenerator
def render(klass, &blk)
hg = klass.new
hg.render(&blk)
end
end
class Html4
attr_accessor :encoding
def render(&blk)
"#{self.instance_eval(&blk)}\n"
end
def head(&blk)
"\n#{self.instance_eval(&blk)}\n"
end
def title(&blk)
"\n#{self.instance_eval(&blk)}“
end
def meta(hash = {})
”\n" + ''
end
def body(&blk)
"\n#{self.instance_eval(&blk)}\n"
end
def h1(&blk)
"\n

#{self.instance_eval(&blk)}


end
def h2(&blk)
”\n

#{self.instance_eval(&blk)}


end
def p(&blk)
”\n

#{self.instance_eval(&blk)}


end
def b(&blk)
#{self.instance_eval(&blk)}
end
def i(&blk)
#{self.instance_eval(&blk)}"
end
end

hg = HtmlGenerator.new
puts hg.render(Html4) {
encoding = "US/English"
head {
title { “My Document” } +
meta(:name => “description”, :content => “this is a description of this
document”)
} +
body {
h1 { “Heading 1” } +
p { “A small paragraph.” } +
h2 { “Heading 2” } +
p { b { “Bold” } + " " + i { “Italic” } }
}
}

I like the syntax of this very much, but I would like input on two things.

The first this would require heavy use of instance_eval. Would this be a
good thing? It strikes me that the main problem with instance_eval is that
you can begin to change the interface of the class. However, as this is
implemented above you can see that changes to the implementation would only
effect an instance of the HtmlXX class, which would go into never never land
as soon as the render call is completed.

The second, a bit harder, I would like to remove the need for the pluses in
order to chain the results together. Any Ruby gurus that would like to try
and take a stab at it? I can think of one possible solution, but I’m not
sure if the results would really be satisfactory.

···


John Long
contact me through: www.wiseheartdesign.com

Last night I started prototyping some of my ideas and came up with the
following:
[…]
hg = HtmlGenerator.new
puts hg.render(Html4) {
encoding = “US/English”
head {
title { “My Document” } +
meta(:name => “description”, :content => “this is a description of this
document”)
} +
body {
h1 { “Heading 1” } +
p { “A small paragraph.” } +
h2 { “Heading 2” } +
p { b { “Bold” } + " " + i { “Italic” } }
}
}

You can use a technique similar to flgr’s Junction or oGMo’s criteria to build a
“parse tree”.

What would be really cool would be taking a DTD and generating the Ruby
code from that that validates the document as it is built.
It would be possible to define how blocks can be nested, etc, in
practice, ensuring that no illegal sequence of calls is made.

···

On Sun, Nov 23, 2003 at 01:50:29AM +0900, John W. Long wrote:


_ _

__ __ | | ___ _ __ ___ __ _ _ __
'_ \ / | __/ __| '_ _ \ / ` | ’ \
) | (| | |
__ \ | | | | | (| | | | |
.__/ _,
|_|/| || ||_,|| |_|
Running Debian GNU/Linux Sid (unstable)
batsman dot geo at yahoo dot com

Are Linux users lemmings collectively jumping off of the cliff of
reliable, well-engineered commercial software?
– Matt Welsh

Date: Sun, 23 Nov 2003 18:19:56 +0900
From: Mauricio Fernández batsman.geo@yahoo.com
Newsgroups: comp.lang.ruby
Subject: Re: HTML Generation (Next Generation CGI)

Last night I started prototyping some of my ideas and came up with the
following:
[…]
hg = HtmlGenerator.new
puts hg.render(Html4) {
encoding = “US/English”
head {
title { “My Document” } +
meta(:name => “description”, :content => “this is a description of this
document”)
} +
body {
h1 { “Heading 1” } +
p { “A small paragraph.” } +
h2 { “Heading 2” } +
p { b { “Bold” } + " " + i { “Italic” } }
}
}

what advantage would this give over:

~ > cat bar.rb
require ‘amrita/template’

template = Amrita::TemplateText.new <<-html

html

data = Hash[
:title => ‘My Document’,
:meta => Amrita::a(:name => ‘description’){‘this is a description of this document’},
:h1 => ‘Heading 1’,
:stuck_out_tongue: => ‘A small paragraph’,
:h2 => ‘Heading 2’,
:b => ‘Bold’,
:i => ‘Italic’,
]
template.expand STDOUT, data

~ > ruby bar.rb

My Document

Heading 1

Heading 2

Bold Italic

You can use a technique similar to flgr’s Junction or oGMo’s criteria to build a
“parse tree”.

What would be really cool would be taking a DTD and generating the Ruby
code from that that validates the document as it is built.
It would be possible to define how blocks can be nested, etc, in
practice, ensuring that no illegal sequence of calls is made.

~ > cat foo.rb

require ‘amrita/template’
template = Amrita::TemplateText.new <<-html






html
data = Hash.new[ :row => {:a => ‘illegal’, :b => ‘row’} ]
template.expand STDOUT, data

~ > ruby foo.rb

/data/ruby-1.8.0//lib/ruby/site_ruby/1.8/amrita/parser.rb:304:in `parse’: error hapend in :2( can’t be in ) (Amrita::HtmlParseError)

==>>


from /data/ruby-1.8.0//lib/ruby/site_ruby/1.8/amrita/parser.rb:269:in parse_text' from /data/ruby-1.8.0//lib/ruby/site_ruby/1.8/amrita/template.rb:405:in load_template’
from /data/ruby-1.8.0//lib/ruby/site_ruby/1.8/amrita/template.rb:208:in setup_template' from /data/ruby-1.8.0//lib/ruby/site_ruby/1.8/amrita/template.rb:115:in expand’
from foo.rb:10

amrita is pretty hard to beat. at the very lest, it could be built on. it’s
handling of array’s make generating complex pages very easy:

~ > cat foobar.rb
require ‘amrita/template’
template = Amrita::TemplateText.new <<-html

html

data = Hash[
:rows => [
{:name => ‘joe’, :ssn => ‘574-86-3205’},
{:name => ‘bob’, :ssn => ‘572-84-8964’},
# imagine there are many of these
]
]
template.expand STDOUT, data

~ > ruby foobar.rb

joe574-86-3205
bob572-84-8964

it will hard to beat amrita’s handling of nested data structures. another
thing that is really good about it is that it separated html from cgi logic.
that way to can say “don’t like how it looks?, here’s the template - add
something” to your web designers.

anyhow, amrita is worth checking out.

-a

···

On Sun, 23 Nov 2003, Mauricio Fernández wrote:

On Sun, Nov 23, 2003 at 01:50:29AM +0900, John W. Long wrote:

ATTN: please update your address books with address below!

===============================================================================

EMAIL :: Ara [dot] T [dot] Howard [at] noaa [dot] gov
PHONE :: 303.497.6469
ADDRESS :: E/GC2 325 Broadway, Boulder, CO 80305-3328
STP :: Solar-Terrestrial Physics Data | NCEI
NGDC :: http://www.ngdc.noaa.gov/
NESDIS :: http://www.nesdis.noaa.gov/
NOAA :: http://www.noaa.gov/
US DOC :: http://www.commerce.gov/

The difference between art and science is that science is what we
understand well enough to explain to a computer.
Art is everything else.
– Donald Knuth, “Discover”

/bin/sh -c ‘for l in ruby perl;do $l -e “print "\x3a\x2d\x29\x0a"”;done’
===============================================================================

You can use a technique similar to flgr’s Junction or oGMo’s criteria to
build a
“parse tree”.

I’m not familiar with either library. How would you see a parse tree helping
in this situation?

What would be really cool would be taking a DTD and generating the Ruby
code from that that validates the document as it is built.
It would be possible to define how blocks can be nested, etc, in
practice, ensuring that no illegal sequence of calls is made.

Honestly I don’t think it would be that hard to do. The hairiness of the
project would be understanding the finer points of dtd. Simply creating a
generator object with a smart method_missing shouldn’t be that hard. This
object could then recursively create other generator objects that contain
the appropriate subset of the dtd for the section of the document you are
working on.

···


John Long
http://wiseheartdesign.com

– Ara Howard wrote: –
what advantage would this give over:

Actually I have used Amrita. And yes Amrita is a good library. I think it
will be even better after it gets some of the kinks worked out of it. (Maybe
it already has. I last looked at Amrita in the spring.)

I’m not so interested in creating a template library. CGI currently has the
kind of functionality I suggested. Personally I’m not sure I would
personally use it, but it does meet another need. It can generate HTML code
in several different flavors. From HTML3 - XHTML transitional if I remember
right. This is kind of a neat idea, although as I said I’m not totally sure
I would use it myself.

···


John Long
http://wiseheartdesign.com