Flott - Floris Tolle Templates

This is ruby templating system with some unique features.

Installation

Use rubygems and just type:

# gem install permutation

Usage

If you want to play with the parser it's best to use the Flott method:

Flott('1 + 1 = [=1 + 1]') # => "1 + 1 = 2"

However if you want to take advantage of the directory tree walking and inclusion features, you have to use actual files:

If two template files are stored in the current directory. One file “header”:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
   "http://www.w3.org/TR/html4/strict.dtd">
<html>
 <head>
  <title>Hello [=@name]!</title>
  <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-15">
 </head>
 <body>

And one file “template”:

 [^header-]
 <h1>Hello [=@name]!</h1>
 [for i in 1..6
 if i % 2 == 0-]
 <b>Hello [=@name]!</b>
 [else-]
 <i>Hello [=@name]!</i>
 [end
 end-]
 </body>
</html>

The parser can be used like this

fp = Flott::Parser.from_filename('template')
env = Flott::Environment.new
env[:name] = "Florian"
fp.evaluate(env)

Or this:

puts Flott.string_from_file(filename, :name => "Florian")

You should also take a look at the other convenience methods in the Flott module.

The output is created by including “header” into “template” with the [^filename] syntax. [!@name] is a shortcut for [print @name] while [=@name] first calls Flott::Parser.escape on @name. It's also possible to just print or puts strings.

Note the use of the assignment to the instance variable @name before executing the template. The state passed to Parser#evaluate as an environment and can be referenced in the template itself with [=@name].

After execution the output is:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
   "http://www.w3.org/TR/html4/strict.dtd">
<html>
 <head>
  <title>Hello Florian!</title>
  <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-15">
 </head>
 <body>

 <h1>Hello Florian!</h1>
 <i>Hello Florian!</i>
 <b>Hello Florian!</b>
 <i>Hello Florian!</i>
 <b>Hello Florian!</b>
 <i>Hello Florian!</i>
 <b>Hello Florian!</b>
 </body>
</html>

Author

Florian Frank flori@ping.de

License

This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License Version 2 as published by the Free Software Foundation: www.gnu.org/copyleft/gpl.html