tenjin 0.6.0 → 0.6.1

data/doc-api/created.rid

@@ -1 +1 @@
-Sat, 04 Aug 2007 14:02:32 +0900
+Thu, 07 Feb 2008 11:07:39 +0900

data/doc-api/files/README_txt.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Sat Aug 04 06:36:16 +0900 2007</td>
+      <td>Thu Feb 07 11:04:47 +0900 2008</td>
     </tr>
     </table>
   </div>
@@ -71,25 +71,25 @@
     <div id="description">
       <h1>README</h1>
 <table>
-<tr><td valign="top">release:</td><td>0.6.0
+<tr><td valign="top">release:</td><td>0.6.1
 
 </td></tr>
-<tr><td valign="top">copyright:</td><td>copyright(c) 2007 kuwata-lab all rights reserved.
+<tr><td valign="top">copyright:</td><td>copyright(c) 2007-2008 kuwata-lab.com all rights reserved.
 
 </td></tr>
 </table>
 <h2>About</h2>
 <p>
-rbTenjin is a very fast and full-featured template engine based on embedded
-Ruby. You can embed Ruby statements and expressions into your text file.
-rbTenjin converts it into Ruby program and evaluate it.
+rbTenjin is a very fast and full-featured template engine. You can embed
+Ruby statements and expressions into your text file. rbTenjin converts it
+into Ruby program and evaluate it.
 </p>
 <h2>Features</h2>
 <ul>
 <li>Very fast (twice faster than eruby and three times faster than ERB)
 
 </li>
-<li>Lightweight (only one file which contains about 1000 lines)
+<li>Lightweight (only a file which contains about 1000 lines)
 
 </li>
 <li>Not break HTML design because it uses XML Processing Instructions (PI) as
@@ -129,13 +129,13 @@ See doc/*.html for details.
   $ sudo gem install tenjin
 </pre>
 </li>
-<li>Else download rbtenjin-X.X.X.tar.bz2 and just copy
+<li>Else download rbtenjin-0.6.1.tar.bz2 and just copy
 &#8216;lib/tenjin.rb&#8217; and &#8216;bin/rbtenjin&#8217; into proper
 directory.
 
 <pre>
-  $ tar xjf rbtenjin-X.X.X.tar.bz2
-  $ cd rbtenjin-X.X.X/
+  $ tar xjf rbtenjin-0.6.1.tar.bz2
+  $ cd rbtenjin-0.6.1/
   $ sudo copy lib/tenjin.rb /usr/local/lib/ruby/1.8/site_ruby/1.8/
   $ sudo copy bin/rbtenjin /usr/local/bin/
 </pre>

data/doc-api/files/lib/tenjin_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Sat Aug 04 10:04:29 +0900 2007</td>
+      <td>Wed Feb 06 12:44:46 +0900 2008</td>
     </tr>
     </table>
   </div>
@@ -70,7 +70,7 @@
 
     <div id="description">
       <p>
-copyright(c) 2007 kuwata-lab all rights reserved.
+copyright(c) 2007-2008 kuwata-lab.com all rights reserved.
 </p>
 <p>
 Permission is hereby granted, free of charge, to any person obtaining a

data/doc-api/fr_method_index.html

@@ -20,68 +20,70 @@
 <div id="index">
   <h1 class="section-bar">Methods</h1>
   <div id="index-entries">
-    <a href="classes/Tenjin/BaseContext.html#M000023">[] (Tenjin::BaseContext)</a><br />
-    <a href="classes/Tenjin/BaseContext.html#M000024">[]= (Tenjin::BaseContext)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000015">_P (Tenjin::ContextHelper)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000016">_decode_params (Tenjin::ContextHelper)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000014">_p (Tenjin::ContextHelper)</a><br />
-    <a href="classes/Tenjin/Template.html#M000061">add_expr (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Preprocessor.html#M000044">add_expr (Tenjin::Preprocessor)</a><br />
-    <a href="classes/Tenjin/Template.html#M000062">add_stmt (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000059">add_text (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000049">after_convert (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000048">before_convert (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000034">cachename (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000013">captured_as (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/BaseContext.html#M000024">[] (Tenjin::BaseContext)</a><br />
+    <a href="classes/Tenjin/BaseContext.html#M000025">[]= (Tenjin::BaseContext)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000016">_P (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000017">_decode_params (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000015">_p (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/Preprocessor.html#M000046">add_expr (Tenjin::Preprocessor)</a><br />
+    <a href="classes/Tenjin/Template.html#M000063">add_expr (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000064">add_stmt (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000061">add_text (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000051">after_convert (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000050">before_convert (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000036">cachename (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000014">captured_as (Tenjin::ContextHelper)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000004">checked (Tenjin::HtmlHelper)</a><br />
-    <a href="classes/Tenjin/Template.html#M000050">compile_stmt_pattern (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000047">convert (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000046">convert_file (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000035">create_template (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/Template.html#M000052">compile_stmt_pattern (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000049">convert (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000048">convert_file (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000037">create_template (Tenjin::Engine)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000006">disabled (Tenjin::HtmlHelper)</a><br />
-    <a href="classes/Tenjin/BaseContext.html#M000028">each (Tenjin::BaseContext)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000010">echo (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/BaseContext.html#M000030">each (Tenjin::BaseContext)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000011">echo (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000009">escape (Tenjin::ContextHelper)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000002">escape (Tenjin::HtmlHelper)</a><br />
-    <a href="classes/Tenjin/BaseContext.html#M000025">escape (Tenjin::BaseContext)</a><br />
-    <a href="classes/Tenjin/Preprocessor.html#M000043">escape_str (Tenjin::Preprocessor)</a><br />
-    <a href="classes/Tenjin/Template.html#M000060">escape_str (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000062">escape_str (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Preprocessor.html#M000045">escape_str (Tenjin::Preprocessor)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000001">escape_xml (Tenjin::HtmlHelper)</a><br />
-    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000018">expr_pattern (Tenjin::ArrayBufferTemplate)</a><br />
-    <a href="classes/Tenjin/Preprocessor.html#M000042">expr_pattern (Tenjin::Preprocessor)</a><br />
-    <a href="classes/Tenjin/Template.html#M000053">expr_pattern (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000031">find_template_file (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/Template.html#M000054">get_expr_and_escapeflag (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000038">get_template (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000040">hook_context (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000009">import (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000019">expr_pattern (Tenjin::ArrayBufferTemplate)</a><br />
+    <a href="classes/Tenjin/Template.html#M000055">expr_pattern (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Preprocessor.html#M000044">expr_pattern (Tenjin::Preprocessor)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000033">find_template_file (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/Template.html#M000056">get_expr_and_escapeflag (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000040">get_template (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/BaseContext.html#M000029">has_key? (Tenjin::BaseContext)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000042">hook_context (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000010">import (Tenjin::ContextHelper)</a><br />
     <a href="classes/Tenjin/BaseContext.html#M000027">key? (Tenjin::BaseContext)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000037">load_cachefile (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/BaseContext.html#M000022">new (Tenjin::BaseContext)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000029">new (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/Template.html#M000045">new (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/BaseContext.html#M000028">key? (Tenjin::BaseContext)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000039">load_cachefile (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/BaseContext.html#M000023">new (Tenjin::BaseContext)</a><br />
+    <a href="classes/Tenjin/Template.html#M000047">new (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000031">new (Tenjin::Engine)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000007">nl2br (Tenjin::HtmlHelper)</a><br />
-    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000019">parse_exprs (Tenjin::ArrayBufferTemplate)</a><br />
-    <a href="classes/Tenjin/Template.html#M000055">parse_exprs (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000052">parse_stmts (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/ErubisTemplate.html#M000017">parse_stmts (Tenjin::ErubisTemplate)</a><br />
-    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000021">quote_expr (Tenjin::ArrayBufferTemplate)</a><br />
-    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000020">quote_str (Tenjin::ArrayBufferTemplate)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000032">read_template_file (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000033">register_template (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000039">render (Tenjin::Engine)</a><br />
-    <a href="classes/Tenjin/Template.html#M000063">render (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000057">parse_exprs (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000020">parse_exprs (Tenjin::ArrayBufferTemplate)</a><br />
+    <a href="classes/Tenjin/Template.html#M000054">parse_stmts (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/ErubisTemplate.html#M000018">parse_stmts (Tenjin::ErubisTemplate)</a><br />
+    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000022">quote_expr (Tenjin::ArrayBufferTemplate)</a><br />
+    <a href="classes/Tenjin/ArrayBufferTemplate.html#M000021">quote_str (Tenjin::ArrayBufferTemplate)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000034">read_template_file (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000035">register_template (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000041">render (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/Template.html#M000065">render (Tenjin::Template)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000005">selected (Tenjin::HtmlHelper)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000011">start_capture (Tenjin::ContextHelper)</a><br />
-    <a href="classes/Tenjin/Template.html#M000057">start_text_part (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000056">statement_hook (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Template.html#M000051">stmt_pattern (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Preprocessor.html#M000041">stmt_pattern (Tenjin::Preprocessor)</a><br />
-    <a href="classes/Tenjin/ContextHelper.html#M000012">stop_capture (Tenjin::ContextHelper)</a><br />
-    <a href="classes/Tenjin/Template.html#M000058">stop_text_part (Tenjin::Template)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000036">store_cachefile (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000012">start_capture (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/Template.html#M000059">start_text_part (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000058">statement_hook (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Template.html#M000053">stmt_pattern (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Preprocessor.html#M000043">stmt_pattern (Tenjin::Preprocessor)</a><br />
+    <a href="classes/Tenjin/ContextHelper.html#M000013">stop_capture (Tenjin::ContextHelper)</a><br />
+    <a href="classes/Tenjin/Template.html#M000060">stop_text_part (Tenjin::Template)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000038">store_cachefile (Tenjin::Engine)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000003">tagattr (Tenjin::HtmlHelper)</a><br />
     <a href="classes/Tenjin/HtmlHelper.html#M000008">text2html (Tenjin::HtmlHelper)</a><br />
-    <a href="classes/Tenjin/Engine.html#M000030">to_filename (Tenjin::Engine)</a><br />
+    <a href="classes/Tenjin/Engine.html#M000032">to_filename (Tenjin::Engine)</a><br />
     <a href="classes/Tenjin/BaseContext.html#M000026">update (Tenjin::BaseContext)</a><br />
   </div>
 </div>

data/doc/examples.html

@@ -14,10 +14,10 @@
 
     <div align="left"><h1>rbTenjin Examples</h1></div>
     <div align="left">
-      last update: $Date: 2007-08-04 13:23:33 +0900 (Sat, 04 Aug 2007) $<br>
+      last update: $Date: 2007-10-23 15:29:14 +0900 (Tue, 23 Oct 2007) $<br>
     </div>
 
-<p>Release: 0.6.0
+<p>Release: 0.6.1
 </p>
 <p>Table of Contents:
 <ul>

data/doc/faq.html

@@ -14,10 +14,10 @@
 
     <div align="left"><h1>rbTenjin FAQ</h1></div>
     <div align="left">
-      last update: $Date: 2007-08-04 13:23:33 +0900 (Sat, 04 Aug 2007) $<br>
+      last update: $Date: 2008-02-04 22:21:53 +0900 (Mon, 04 Feb 2008) $<br>
     </div>
 
-<p>Release:	0.6.0
+<p>Release:	0.6.1
 </p>
 <p>Table of contents:
 <ul>

data/doc/users-guide.html

@@ -14,10 +14,10 @@
 
     <div align="left"><h1>rbTenjin User's Guide</h1></div>
     <div align="left">
-      last update: $Date: 2007-08-04 13:23:33 +0900 (Sat, 04 Aug 2007) $<br>
+      last update: $Date: 2008-02-06 12:44:46 +0900 (Wed, 06 Feb 2008) $<br>
     </div>
 
-<p>Release: 0.6.0
+<p>Release: 0.6.1
 </p>
 <p>Table of Contents:
 <ul>
@@ -430,7 +430,7 @@ Result:</div>
 <pre class="terminal">$ rbtenjin <strong>-wz</strong> example3.rbhtml
 example3.rbhtml:5: syntax error, unexpected $end, expecting kEND
 </pre>
-<p>Command-line option '-wz' is more convenient than '<code>rbtenjin -s file | ruby -wz</code>'
+<p>Command-line option '-wz' is more convenient than '<code>rbtenjin -s file | ruby -wc</code>'
 because the former can take several filenames.
 </p>
 <p>Command-line option '-q' (quiet-mode) prints nothing if it has no errors.
@@ -521,7 +521,7 @@ Result:</div>
 
 <a name="des-cmlinecontext"></a>
 <h3 class="section2">Command-line Context Data</h3>
-<p>Command-line option '<code>-z</code>' specifies context data in YAML format or Ruby code.
+<p>Command-line option '<code>-c</code>' specifies context data in YAML format or Ruby code.
 </p>
 <a name="example5.rbhtml"></a>
 <div class="program_caption">
@@ -1150,6 +1150,8 @@ filename = 'file.rbhtml'
 output = engine.render(filename, context)
 print output
 </pre>
+<p>If you want to define helper functions for template, see <a href="#dev-helpers">Add Your Helper Functions</a> section.
+</p>
 <br>
 
 
@@ -1657,6 +1659,47 @@ Result:</div>
   &lt;li&gt;&lt;a href="/"&gt;Top&lt;/a&gt;&lt;/li&gt;
 &lt;/ul&gt;
 </pre>
+<p>(D) Define helper functions in current class, set context data as instance variables, and pass self as context object
+</p>
+<a name="example16d.rb"></a>
+<div class="program_caption">
+File 'example16d.rb':</div>
+<pre class="program">require 'tenjin'
+
+class MyClass
+  <strong>include Tenjin::ContextHelper</strong>
+  <strong>#include Tenjin::HtmlHelper</strong>  # optional
+
+  def link_to(label, url)    # define helper functions in current class
+    return "&lt;a href=\"#{escape(url)}\"&gt;#{escape(label)}&lt;/a&gt;"
+  end
+
+  def render_template(template_name)
+    engine = Tenjin::Engine.new()
+    output = engine.render(template_name, <strong>self</strong>)  # pass self as context object
+    return output
+  end
+
+  def main
+    ## set context data as instance variables
+    <strong>@label = 'Top'</strong>
+    <strong>@url = '/'</strong>
+    output = render_template('example16.rbhtml')
+    print output
+  end
+
+end
+
+MyClass.new.main()
+</pre>
+<a name="example16d.result"></a>
+<div class="terminal_caption">
+Result:</div>
+<pre class="terminal">$ ruby example16d.rb
+&lt;ul&gt;
+  &lt;li&gt;&lt;a href="/"&gt;Top&lt;/a&gt;&lt;/li&gt;
+&lt;/ul&gt;
+</pre>
 <br>
 
 

data/examples/form/Makefile

@@ -0,0 +1,5 @@
+all:
+	ruby main.rb
+
+clean:
+	rm -f *.cache

data/examples/form/Rakefile

@@ -0,0 +1,7 @@
+task 'default' do
+  load 'main.rb'
+end
+
+task 'clean' do
+  rm_f Dir.glob('*.cache')
+end

data/examples/form/create.rbhtml

@@ -0,0 +1,4 @@
+<?rb @title = 'Create user' ?>
+<?rb @label = 'Create' ?>
+<?rb @action = 'action.cgi' ?>
+<?rb import(:form) ?>

data/examples/form/form.rbhtml

@@ -0,0 +1,14 @@
+<?rb #@ARGS action, params, label ?>
+<form action="${@action}" method="post">
+  <p>
+    <label>Name:</label>
+    <input type="text" name="name" value="${@params[:name]}" />
+  </p>
+  <p>
+    <label>Gender:</label>
+<?rb gender = @params[:gender] ?>
+    <input type="radio" name="gender" value="M" #{checked(gender=='M')} />Man
+    <input type="radio" name="gender" value="W" #{checked(gender=='W')} />Woman
+  </p>
+  <input type="submit" value="${@label}" />
+</form>

data/examples/form/layout.rbhtml

@@ -0,0 +1,8 @@
+<html>
+ <body>
+  <h1>${@title}</h1>
+  <div class="main-content">
+#{@_content}
+  </div>
+ </body>
+</html>

data/examples/form/main.rb

@@ -0,0 +1,9 @@
+## create Engine object
+require 'tenjin'
+engine = Tenjin::Engine.new(:postfix=>'.rbhtml', :layout=>'layout.rbhtml')
+
+## render template with context data
+params = { :name=>'Foo', :gender=>'M' }
+context = { :params=>params }
+output = engine.render(:update, context)   # :update == 'update'+postfix
+puts output

data/examples/form/update.rbhtml

@@ -0,0 +1,4 @@
+<?rb @title = 'Update user' ?>
+<?rb @label = 'Update' ?>
+<?rb @action = 'update.cgi' ?>
+<?rb import(:form) ?>

data/examples/preprocessing/Makefile

@@ -0,0 +1,8 @@
+all:
+	ruby main.rb
+
+preprocess:
+	rbtenjin -a preprocess select.rbhtml
+
+clean:
+	rm -f *.cache

data/examples/preprocessing/Rakefile

@@ -0,0 +1,11 @@
+task 'default' do
+  load 'main.rb'
+end
+
+task 'preprocess' do
+  system 'rbtenjin -a preprocess select.rbhtml'
+end
+
+task 'clean' do
+  rm_f Dir.glob('*.cache')
+end

data/examples/preprocessing/helper.rb

@@ -0,0 +1,16 @@
+LANGUAGES = [
+  ['en', 'Engilish'],
+  ['fr', 'French'],
+  ['de', 'German'],
+  ['es', 'Spanish'],
+  ['ch', 'Chinese'],
+  ['ja', 'Japanese'],
+]
+
+def link_to(label, options={})
+  action, id = options[:action], options[:id]
+  url = '/app'
+  url << '/' << action if action && !action.empty?
+  url << '/' << id     if id
+  return "<a href=\"#{CGI::escape(url).gsub(/%2F/i, '/')}\">#{label}</a>"
+end

data/examples/preprocessing/main.rb

@@ -0,0 +1,11 @@
+require 'helper'
+
+## create engine
+require 'tenjin'
+engine = Tenjin::Engine.new(:postfix=>'.rbhtml', :preprocess=>true)
+
+## render template with context data
+params = { :id=>1234, :name=>'Foo', :lang=>'ch' }
+context = { :params => params }
+output = engine.render(:select, context)
+puts output

data/examples/preprocessing/select.rbhtml

@@ -0,0 +1,15 @@
+<?RB require 'helper' ?>
+<form>
+  <label>Select your language:</label>
+  <select name="lang">
+<?rb table = { @params[:lang] => ' selected="selected"' } ?>
+<?RB for val, name in LANGUAGES ?>
+    <option value="${{val}}" #{table[#{{val.inspect}}]}>${{name}}</option>
+<?RB end ?>
+  </select>
+  <input type="submit" value="OK" />
+</form>
+<p>
+  #{{link_to('Back', :action=>'index')}} |
+  #{{link_to('Show '+_P('@params[:name]'), :action=>'show', :id=>_p('@params[:id]'))}}
+</p>