RubyGems - tenjin - Versions diffs - 0.6.2 → 0.7.0 - Mend

tenjin 0.6.2 → 0.7.0

Files changed (282) hide show

data/CHANGES.txt +163 -0
data/MIT-LICENSE +16 -17
data/README.txt +5 -5
data/benchmark/Makefile +9 -0
data/benchmark/bench.rb +3 -2
data/bin/rbtenjin +6 -3
data/doc/docstyle.css +25 -4
data/doc/users-guide.html +2088 -1563
data/lib/tenjin.rb +784 -158
data/public_html/_layout.rbhtml +33 -0
data/public_html/css/style.css +77 -0
data/public_html/env.rbhtml +15 -0
data/public_html/favicon.ico +0 -0
data/public_html/hello.rbhtml +14 -0
data/public_html/index.rbhtml +39 -0
data/public_html/rbtenjin.cgi +188 -0
data/tenjin.gemspec +9 -6
data/test/data/examples/preprocessing/main.rb +1 -1
data/test/data/examples/preprocessing/select.rbhtml +1 -1
data/test/data/faq/{ex11-bench.rb → ex10-bench.rb} +3 -3
data/test/data/faq/ex10-content.rbhtml +8 -11
data/test/data/faq/{ex11-layout1.rbhtml → ex10-layout1.rbhtml} +0 -0
data/test/data/faq/{ex11-layout2.rbhtml → ex10-layout2.rbhtml} +0 -0
data/test/data/faq/{ex11.rb → ex10.rb} +1 -1
data/test/data/faq/{ex11.rbhtml → ex10.rbhtml} +0 -0
data/test/data/faq/{ex11.source → ex10.source} +2 -2
data/test/data/faq/{ex11_arraybuffer.result → ex10_arraybuffer.result} +1 -1
data/test/data/faq/{ex5.rbhtml → ex2.rbhtml} +0 -0
data/test/data/faq/{ex5_template_args.source → ex2_template_args.source} +1 -1
data/test/data/faq/{ex7-expr-pattern.rb → ex4-expr-pattern.rb} +1 -1
data/test/data/faq/{ex7-expr-pattern.rbhtml → ex4-expr-pattern.rbhtml} +0 -0
data/test/data/faq/{ex7_expr_pattern.result → ex4_expr_pattern.result} +1 -1
data/test/data/faq/{ex6-content.rhtml → ex5-content.rhtml} +0 -0
data/test/data/faq/{ex6-layout.rhtml → ex5-layout.rhtml} +0 -0
data/test/data/faq/{ex6.rb → ex5.rb} +2 -2
data/test/data/faq/{ex6_eruby.result → ex5_eruby.result} +1 -1
data/test/data/faq/{ex2-content.rbhtml → ex6-content.rbhtml} +0 -0
data/test/data/faq/{ex2-layout.rbhtml → ex6-layout.rbhtml} +0 -0
data/test/data/faq/{ex2_removenl.result → ex6_removenl.result} +1 -1
data/test/data/faq/ex7-m18n.rb +48 -0
data/test/data/faq/{ex8-m18n.rbhtml → ex7-m18n.rbhtml} +0 -0
data/test/data/faq/{ex8_m18n.result → ex7_m18n.result} +1 -1
data/test/data/faq/ex8-baselayout.rbhtml +8 -0
data/test/data/faq/ex8-content.rbhtml +6 -0
data/test/data/faq/{ex9-mylayout.rbhtml → ex8-mylayout.rbhtml} +0 -0
data/test/data/faq/{ex9_changelayout.result → ex8_changelayout.result} +1 -1
data/test/data/faq/ex9-baselayout.rbhtml +24 -5
data/test/data/faq/ex9-content.rbhtml +12 -6
data/test/data/faq/{ex10-customlayout.rbhtml → ex9-customlayout.rbhtml} +1 -1
data/test/data/faq/{ex10_inherit.result → ex9_inherit.result} +1 -1
data/test/data/faq/helpers1.rb +17 -0
data/test/data/faq/helpers1.rbhtml +4 -0
data/test/data/faq/helpers1.result +11 -0
data/test/data/faq/helpers2.rb +21 -0
data/test/data/faq/helpers2.rbhtml +4 -0
data/test/data/faq/helpers2.result +11 -0
data/test/data/faq/weekday1.rb +6 -0
data/test/data/faq/weekday1.rbhtml +9 -0
data/test/data/faq/weekday1.result +23 -0
data/test/data/faq/weekday2.rb +8 -0
data/test/data/faq/weekday2.rbhtml +10 -0
data/test/data/faq/weekday2.result +24 -0
data/test/data/faq/weekday3.rb +22 -0
data/test/data/faq/weekday3.rbhtml +3 -0
data/test/data/faq/weekday3.result +28 -0
data/test/data/users_guide/test_010/main.rb +14 -0
data/test/data/users_guide/test_010/result.output +13 -0
data/test/data/users_guide/test_010/views/page.rbhtml +11 -0
data/test/data/users_guide/test_011/main.rb +14 -0
data/test/data/users_guide/test_011/result.output +2 -0
data/test/data/users_guide/test_011/views/page.rbhtml +11 -0
data/test/data/users_guide/test_020/main.rb +14 -0
data/test/data/users_guide/test_020/result.output +13 -0
data/test/data/users_guide/test_020/views/page.rbhtml +11 -0
data/test/data/users_guide/test_021/main.rb +12 -0
data/test/data/users_guide/test_021/result.output +12 -0
data/test/data/users_guide/test_021/views/page.rbhtml +11 -0
data/test/data/users_guide/test_030/main.rb +14 -0
data/test/data/users_guide/test_030/result.output +23 -0
data/test/data/users_guide/test_030/views/_layout.rbhtml +10 -0
data/test/data/users_guide/test_030/views/page.rbhtml +11 -0
data/test/data/users_guide/test_040/main.rb +14 -0
data/test/data/users_guide/test_040/result.output +23 -0
data/test/data/users_guide/test_040/views/_layout.rbhtml +10 -0
data/test/data/users_guide/test_040/views/page.rbhtml +12 -0
data/test/data/users_guide/test_050/main.rb +14 -0
data/test/data/users_guide/test_050/result.output +14 -0
data/test/data/users_guide/test_050/views/_layout.rbhtml +10 -0
data/test/data/users_guide/test_050/views/page.rbhtml +13 -0
data/test/data/users_guide/test_051/main.rb +14 -0
data/test/data/users_guide/test_051/result.output +12 -0
data/test/data/users_guide/test_051/views/_layout.rbhtml +11 -0
data/test/data/users_guide/test_051/views/page.rbhtml +13 -0
data/test/data/users_guide/test_060/main.rb +14 -0
data/test/data/users_guide/test_060/result.output +29 -0
data/test/data/users_guide/test_060/views/_footer.rbhtml +3 -0
data/test/data/users_guide/test_060/views/_header.rbhtml +3 -0
data/test/data/users_guide/test_060/views/_layout.rbhtml +13 -0
data/test/data/users_guide/test_060/views/page.rbhtml +13 -0
data/test/data/users_guide/test_070/main.rb +14 -0
data/test/data/users_guide/test_070/result.output +29 -0
data/test/data/users_guide/test_070/views/_footer.rbhtml +3 -0
data/test/data/users_guide/test_070/views/_header.rbhtml +3 -0
data/test/data/users_guide/test_070/views/_layout.rbhtml +13 -0
data/test/data/users_guide/test_070/views/page.rbhtml +13 -0
data/test/data/users_guide/test_capturing/main.rb +24 -0
data/test/data/users_guide/test_capturing/result.output +28 -0
data/test/data/users_guide/test_capturing/views/_layout.rbhtml +21 -0
data/test/data/users_guide/test_capturing/views/blog-post.rbhtml +13 -0
data/test/data/users_guide/test_context/context.rb +5 -0
data/test/data/users_guide/test_context/context.yaml +4 -0
data/test/data/users_guide/test_context/example.rbhtml +5 -0
data/test/data/users_guide/test_context/result1.output +6 -0
data/test/data/users_guide/test_context/result2.output +6 -0
data/test/data/users_guide/test_context/result3.output +6 -0
data/test/data/users_guide/test_context/result4.output +6 -0
data/test/data/users_guide/test_convert/example.rbhtml +5 -0
data/test/data/users_guide/test_convert/result1.output +7 -0
data/test/data/users_guide/test_convert/result2.output +6 -0
data/test/data/users_guide/test_escape/main.rb +4 -0
data/test/data/users_guide/test_escape/result.output +5 -0
data/test/data/users_guide/test_escape/views/page.rbhtml +4 -0
data/test/data/users_guide/test_execute/example.rbhtml +6 -0
data/test/data/users_guide/test_execute/result.output +6 -0
data/test/data/users_guide/test_fragmentcache/cache.d/items/1 +5 -0
data/test/data/users_guide/test_fragmentcache/main.rb +21 -0
data/test/data/users_guide/test_fragmentcache/result.output +8 -0
data/test/data/users_guide/test_fragmentcache/result2.output +6 -0
data/test/data/users_guide/test_fragmentcache/views/items.rbhtml +10 -0
data/test/data/users_guide/test_logging/ex-logger.rb +11 -0
data/test/data/users_guide/test_logging/example.rbhtml +0 -0
data/test/data/users_guide/test_logging/result1.output +3 -0
data/test/data/users_guide/test_logging/result2.output +2 -0
data/test/data/users_guide/test_m17n/m17n.rb +44 -0
data/test/data/users_guide/test_m17n/m17n.rbhtml +5 -0
data/test/data/users_guide/test_m17n/result.output +9 -0
data/test/data/users_guide/test_m17n/result_en.output +4 -0
data/test/data/users_guide/test_m17n/result_fr.output +4 -0
data/test/data/users_guide/test_nested/main.rb +8 -0
data/test/data/users_guide/test_nested/result.output +15 -0
data/test/data/users_guide/test_nested/views/_blog_layout.rbhtml +5 -0
data/test/data/users_guide/{layout8_html.rbhtml → test_nested/views/_site_layout.rbhtml} +0 -0
data/test/data/users_guide/test_nested/views/blog_post.rbhtml +4 -0
data/test/data/users_guide/test_preprocessing/pp-example1.rb +14 -0
data/test/data/users_guide/test_preprocessing/result1a.output +11 -0
data/test/data/users_guide/test_preprocessing/result1b.output +5 -0
data/test/data/users_guide/test_preprocessing/result1c.output +6 -0
data/test/data/users_guide/test_preprocessing/result2a.output +10 -0
data/test/data/users_guide/test_preprocessing/result2b.output +10 -0
data/test/data/users_guide/test_preprocessing/result3a.output +2 -0
data/test/data/users_guide/test_preprocessing/result3b.output +2 -0
data/test/data/users_guide/test_preprocessing/views/pp-example1.rbhtml +4 -0
data/test/data/users_guide/{example12.rbhtml → test_preprocessing/views/pp-example2.rbhtml} +4 -4
data/test/data/users_guide/test_preprocessing/views/pp-example3.rbhtml +7 -0
data/test/data/users_guide/test_retrieve/example.rbhtml +10 -0
data/test/data/users_guide/test_retrieve/result1.output +11 -0
data/test/data/users_guide/test_retrieve/result2.output +11 -0
data/test/data/users_guide/test_retrieve/result3.output +11 -0
data/test/data/users_guide/test_retrieve/result4.output +8 -0
data/test/data/users_guide/test_retrieve/result5.output +5 -0
data/test/data/users_guide/test_safe/result.output +6 -0
data/test/data/users_guide/test_safe/safe-test.rb +21 -0
data/test/data/users_guide/test_safehelper/main.rb +16 -0
data/test/data/users_guide/test_safehelper/result.output +8 -0
data/test/data/users_guide/{example3.rbhtml → test_syntax_check/example.rbhtml} +0 -0
data/test/data/users_guide/test_syntax_check/result.output +2 -0
data/test/data/users_guide/test_trace/layout.rbhtml +7 -0
data/test/data/users_guide/test_trace/main.rbhtml +5 -0
data/test/data/users_guide/test_trace/result.output +16 -0
data/test/data/users_guide/test_trace/trace-example.rb +4 -0
data/test/oktest.rb +755 -0
data/test/test_all.rb +24 -14
data/test/test_engine.rb +628 -63
data/test/test_engine.yaml +40 -3
data/test/test_examples.rb +14 -12
data/test/test_faq.rb +17 -12
data/test/test_htmlhelper.rb +104 -33
data/test/test_main.rb +32 -21
data/test/test_main.yaml +2 -2
data/test/test_safe.rb +206 -0
data/test/test_store.rb +220 -0
data/test/test_tcache.rb +94 -0
data/test/test_template.rb +65 -23
data/test/test_template.yaml +7 -7
data/test/test_users_guide.rb +75 -29
data/test/testcase-helper.rb +20 -18
data/test/testunit-assertions.rb +71 -0
metadata +185 -159
data/doc-api/classes/Tenjin.html +0 -141
data/doc-api/classes/Tenjin/ArrayBufferTemplate.html +0 -270
data/doc-api/classes/Tenjin/BaseContext.html +0 -329
data/doc-api/classes/Tenjin/Context.html +0 -126
data/doc-api/classes/Tenjin/ContextHelper.html +0 -461
data/doc-api/classes/Tenjin/Engine.html +0 -616
data/doc-api/classes/Tenjin/ErubisTemplate.html +0 -166
data/doc-api/classes/Tenjin/HtmlHelper.html +0 -359
data/doc-api/classes/Tenjin/Preprocessor.html +0 -242
data/doc-api/classes/Tenjin/Template.html +0 -916
data/doc-api/created.rid +0 -1
data/doc-api/files/README_txt.html +0 -188
data/doc-api/files/lib/tenjin_rb.html +0 -136
data/doc-api/fr_class_index.html +0 -36
data/doc-api/fr_file_index.html +0 -28
data/doc-api/fr_method_index.html +0 -91
data/doc-api/index.html +0 -24
data/doc-api/rdoc-style.css +0 -208
data/doc/examples.html +0 -312
data/doc/faq.html +0 -909
data/examples/preprocessing/select.rbhtml.cache +0 -17
data/test/Rookbook.yaml +0 -14
data/test/assert-text-equal.rb +0 -45
data/test/data/faq/ex10-baselayout.rbhtml +0 -27
data/test/data/faq/ex11-content.rbhtml +0 -9
data/test/data/faq/ex8-m18n.rb +0 -77
data/test/data/users_guide/content6.rbhtml +0 -3
data/test/data/users_guide/content7.rbhtml +0 -5
data/test/data/users_guide/content8.rbhtml +0 -2
data/test/data/users_guide/contextdata.rb +0 -7
data/test/data/users_guide/datafile.rb +0 -5
data/test/data/users_guide/datafile.yaml +0 -10
data/test/data/users_guide/ex.rbhtml +0 -6
data/test/data/users_guide/ex.result +0 -7
data/test/data/users_guide/ex.script +0 -5
data/test/data/users_guide/ex_script.result +0 -7
data/test/data/users_guide/ex_source.result +0 -8
data/test/data/users_guide/example1.rbhtml +0 -12
data/test/data/users_guide/example1.result +0 -17
data/test/data/users_guide/example10.rbhtml +0 -4
data/test/data/users_guide/example10_template_args.result +0 -6
data/test/data/users_guide/example11.rbhtml +0 -5
data/test/data/users_guide/example11_template_args_result +0 -2
data/test/data/users_guide/example12_preprocessed.result +0 -10
data/test/data/users_guide/example12_preprocessed_source.result +0 -10
data/test/data/users_guide/example13.rbhtml +0 -6
data/test/data/users_guide/example13_preprocessed.result +0 -2
data/test/data/users_guide/example13_preprocessed_source.result +0 -2
data/test/data/users_guide/example14.rb +0 -32
data/test/data/users_guide/example14.rbhtml +0 -6
data/test/data/users_guide/example14_tmplclass.result +0 -15
data/test/data/users_guide/example15.rb +0 -10
data/test/data/users_guide/example15_escapefunc.result +0 -14
data/test/data/users_guide/example16.rbhtml +0 -4
data/test/data/users_guide/example16a.rb +0 -10
data/test/data/users_guide/example16a.result +0 -4
data/test/data/users_guide/example16b.rb +0 -13
data/test/data/users_guide/example16b.result +0 -4
data/test/data/users_guide/example16c.rb +0 -12
data/test/data/users_guide/example16c.result +0 -4
data/test/data/users_guide/example16d.rb +0 -27
data/test/data/users_guide/example16d.result +0 -4
data/test/data/users_guide/example1_S.result +0 -14
data/test/data/users_guide/example1_SXNC.result +0 -10
data/test/data/users_guide/example1_source.result +0 -14
data/test/data/users_guide/example2.rbhtml +0 -3
data/test/data/users_guide/example2_sb.result2 +0 -9
data/test/data/users_guide/example3_syntaxcheck.result +0 -2
data/test/data/users_guide/example4.rbhtml +0 -13
data/test/data/users_guide/example4_datafile_rb.result +0 -13
data/test/data/users_guide/example4_yaml.result +0 -13
data/test/data/users_guide/example5.rbhtml +0 -9
data/test/data/users_guide/example5_datastr_rb.result +0 -9
data/test/data/users_guide/example5_datastr_yaml.result +0 -9
data/test/data/users_guide/example6.rbhtml +0 -19
data/test/data/users_guide/example6_layout.result +0 -29
data/test/data/users_guide/example6_nested.result +0 -28
data/test/data/users_guide/example7_layout2.result +0 -13
data/test/data/users_guide/example8_layout3.result +0 -8
data/test/data/users_guide/example9.rbhtml +0 -18
data/test/data/users_guide/example9_capture.result +0 -26
data/test/data/users_guide/footer.html +0 -5
data/test/data/users_guide/footer.rbhtml +0 -4
data/test/data/users_guide/layout6.rbhtml +0 -17
data/test/data/users_guide/layout7.rbhtml +0 -9
data/test/data/users_guide/layout8_xhtml.rbhtml +0 -6
data/test/data/users_guide/layout9.rbhtml +0 -25
data/test/data/users_guide/sidemenu.rbhtml +0 -5
data/test/data/users_guide/user_app.cgi +0 -39
data/test/data/users_guide/user_app.result +0 -30
data/test/data/users_guide/user_create.rbhtml +0 -6
data/test/data/users_guide/user_edit.rbhtml +0 -7
data/test/data/users_guide/user_form.rbhtml +0 -10
data/test/data/users_guide/user_layout.rbhtml +0 -16

data/doc/faq.html DELETED

@@ -1,909 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-  <meta http-equiv="Content-Type" content="text/html">
-  <title>rbTenjin FAQ</title>
-  <meta name="generator" content="kwaser">
-  <meta http-equiv="Content-Style-Type" content="text/css">
-  <link rel="stylesheet" href="docstyle.css" type="text/css">
- </head>
- <body>
-  <blockquote>
-   <div class="mainbody">
-    <div align="left"><h1>rbTenjin FAQ</h1></div>
-    <div align="left">
-      last update: $Date: 2008-02-04 22:21:53 +0900 (Mon, 04 Feb 2008) $<br>
-    </div>
-<p>Release:	0.6.2
-</p>
-<p>Table of contents:
-<ul>
-  <li><a href="#faq-basic">Basic</a>
-  <ul>
-    <li><a href="#faq-syntax-error">I got an SyntaxError exception.</a>
-    </li>
-    <li><a href="#faq-delete-newline">'#{@_content}' includes extra newline at end. Can I delete it?</a>
-    </li>
-    <li><a href="#faq-change-funcname">Can I change 'escape()' function name?</a>
-    </li>
-    <li><a href="#faq-change-bufname">Can I change '_buf' variable name?</a>
-    </li>
-  </ul>
-  </li>
-  <li><a href="#faq-template">Template</a>
-  <ul>
-    <li><a href="#faq-template-args">Is it possible to specify variables passed to template?</a>
-    </li>
-    <li><a href="#faq-eruby-template">Is there any way to use eRuby template?</a>
-    </li>
-    <li><a href="#faq-exprpat">Is it able to change embedded expression pattern?</a>
-    </li>
-    <li><a href="#faq-m17n">Does rbTenjin support M17N?</a>
-    </li>
-  </ul>
-  </li>
-  <li><a href="#faq-layout">Layout Template</a>
-  <ul>
-    <li><a href="#faq-change-layout-template">Can I change layout template name in a template file?</a>
-    </li>
-    <li><a href="#faq-nested-layout-template">Can I nest layout templates for any depth?</a>
-    </li>
-    <li><a href="#faq-diable-layout">Can I disable default layout template for a certain template?</a>
-    </li>
-    <li><a href="#faq-template-inheritance">Is Django-like "Template Inheritance" supported?</a>
-    </li>
-  </ul>
-  </li>
-  <li><a href="#faq-performance">Performance</a>
-  <ul>
-    <li><a href="#How fast is rbTenjin compared with other solutions?">How fast is rbTenjin compared with other solutions?</a>
-    </li>
-    <li><a href="#faq-why-so-fast">Why rbTenjin is so fast?</a>
-    </li>
-    <li><a href="#faq-performance-tuning">Is there any way to get more speed?</a>
-    </li>
-  </ul>
-  </li>
-</ul>
-</p>
-<a name="faq-basic"></a>
-<h2 class="section1">Basic</h2>
-<a name="faq-syntax-error"></a>
-<h3 class="section2">I got an SyntaxError exception.</h3>
-<p>Command-line option '-z' checks syntax of template file.
-You should check template by it.
-</p>
-<a name="ex1.rbhtml"></a>
-<div class="program_caption">
-File 'ex1.rbhtml':</div>
-<pre class="program">&lt;ul&gt;
-&lt;?rb (0..10).each { |i| ?&gt;
-  &lt;li&gt;#{i}&lt;/li&gt;
-&lt;?rb end ?&gt;
-&lt;/ul&gt;
-</pre>
-<a name="ex1_chksyntax.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ rbtenjin <strong>-wz</strong> ex1.rbhtml
-ex1.rbhtml:4: syntax error, unexpected kEND, expecting '}'
-ex1.rbhtml:5: syntax error, unexpected $end, expecting '}'
-</pre>
-<br>
-<a name="faq-delete-newline"></a>
-<h3 class="section2">'#{@_content}' includes extra newline at end. Can I delete it?</h3>
-<p>Yes. You can use '<code>&lt;?rb echo(@_content) ?&gt;</code>' or '<code>&lt;?rb _buf &lt;&lt; @_content ?&gt;</code>' instead of '<code>#{@_conent}</code>'.
-</p>
-<a name="ex2-layout.rbhtml"></a>
-<div class="program_caption">
-File 'ex2-layout.rbhtml':</div>
-<pre class="program">&lt;!-- --&gt;
-<strong>#{@_content}</strong>
-&lt;!-- --&gt;
-&lt;!-- --&gt;
-<strong>&lt;?rb echo(@_content) ?&gt;</strong>
-&lt;!-- --&gt;
-&lt;!-- --&gt;
-<strong>&lt;?rb _buf &lt;&lt; @_content ?&gt;</strong>
-&lt;!-- --&gt;
-</pre>
-<a name="ex2-content.rbhtml"></a>
-<div class="program_caption">
-File 'ex2-content.rbhtml':</div>
-<pre class="program">foo
-bar
-baz
-</pre>
-<a name="ex2_removenl.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ rbtenjin --layout=ex2-layout.rbhtml ex2-content.rbhtml
-&lt;!-- --&gt;
-foo
-bar
-baz
-&lt;!-- --&gt;
-&lt;!-- --&gt;
-foo
-bar
-baz
-&lt;!-- --&gt;
-&lt;!-- --&gt;
-foo
-bar
-baz
-&lt;!-- --&gt;
-</pre>
-<br>
-<a name="faq-change-funcname"></a>
-<h3 class="section2">Can I change 'escape()' function name?</h3>
-<p>Yes. You can change them by setting <code>:escapefunc</code> option for Tenjin::Template.new() or Tenjin::Engine.new().
-</p>
-<a name="ex3.rb"></a>
-<div class="program_caption">
-File 'ex3.rb':</div>
-<pre class="program">require 'tenjin'
-engine = Tenjin::Engine.new(<strong>:escapefunc=&gt;'CGI.escapeHTML'</strong>)
-template = engine.get_template('ex3.rbhtml')
-print template.script
-</pre>
-<a name="ex3.rbhtml"></a>
-<div class="program_caption">
-File 'ex3.rbhtml':</div>
-<pre class="program">Hello ${@name}!
-</pre>
-<a name="ex3_escapefunc1.result"></a>
-<div class="program_caption">
-Result:</div>
-<pre class="program">$ ruby ex3.rb
- _buf &lt;&lt; %Q`Hello #{<strong>CGI.escapeHTML</strong>((@name).to_s)}!\n`
-</pre>
-<p>Command-line option '--escapefunc=<em>name</em>' is equivarent to the above.
-</p>
-<a name="ex3_escapefunc2.result"></a>
-<div class="program_caption">
-Result:</div>
-<pre class="program">$ rbtenjin -sb <strong>--escapefunc=CGI.escapeHTML</strong> ex3.rbhtml
- _buf &lt;&lt; %Q`Hello #{<strong>CGI.escapeHTML</strong>((@name).to_s)}!\n`
-</pre>
-<br>
-<a name="faq-change-bufname"></a>
-<h3 class="section2">Can I change '_buf' variable name?</h3>
-<p>No. Variable name '_buf' should not and will never be changed.
-</p>
-<br>
-<br>
-<a name="faq-template"></a>
-<h2 class="section1">Template</h2>
-<a name="faq-template-args"></a>
-<h3 class="section2">Is it possible to specify variables passed to template?</h3>
-<p>Yes. You can specify template arguments by '<code>&lt;?rb #@ARGS arg1, arg2, arg3 ?&gt;</code>'.
-</p>
-<a name="ex5.rbhtml"></a>
-<div class="program_caption">
-File 'ex5-layout.rbhtml'</div>
-<pre class="program">&lt;?xml version="1.0 ?&gt;
-<strong>&lt;?rb #@ARGS x, y ?&gt;</strong>
-&lt;p&gt;
-  x = #{x}
-  y = #{y}
-  z = #{z}
-&lt;/p&gt;
-</pre>
-<p>Template arguments line is converted into local variable assignment statements.
-</p>
-<a name="ex5_template_args.source"></a>
-<div class="terminal_caption">
-Source code</div>
-<pre class="terminal">$ rbtenjin -s ex5.rbhtml
-_buf = '';  _buf &lt;&lt; %Q`&lt;?xml version="1.0 ?&gt;\n`
-<strong> x = @x; y = @y;</strong>
- _buf &lt;&lt; %Q`&lt;p&gt;
-  x = #{x}
-  y = #{y}
-  z = #{z}
-&lt;/p&gt;\n`
-_buf.to_s
-</pre>
-<p>Undeclared arguments are not available even when they are passed via context object.
-</p>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ rbtenjin -c 'x=10; y=20; z=30' ex5.rbhtml
-ex5.rbhtml:6:in `_render': undefined local variable or method `z' for #&lt;Tenjin::Context:0x35a9e4&gt; (NameError)
-</pre>
-<br>
-<a name="faq-eruby-template"></a>
-<h3 class="section2">Is there any way to use eRuby template?</h3>
-<p>Yes. It is able to use eRuby template files by Tenjin::ErubisTemplate class.
-</p>
-<p>It is required to install <a href="http://www.kuwata-lab.com/erubis">Erubis</a> to use Tenjin::ErubisTemplate class.
-</p>
-<a name="ex6-layout.rhtml"></a>
-<div class="program_caption">
-File 'ex6-layout.rhtml'</div>
-<pre class="program">&lt;html&gt;
- &lt;body&gt;
-  &lt;h1&gt;<strong>&lt;%=h @title %&gt;</strong>&lt;/h1&gt;
-<strong>&lt;%= @_content %&gt;</strong>
- &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<a name="ex6-content.rhtml"></a>
-<div class="program_caption">
-File 'ex6-content.rhtml'</div>
-<pre class="program">  <strong>&lt;% @title = 'eRuby template example' %&gt;</strong>
-  &lt;ul&gt;
-  <strong>&lt;% for item in @items %&gt;</strong>
-   &lt;li&gt;<strong>&lt;%=h item %&gt;</strong>&lt;/li&gt;
-  <strong>&lt;% end %&gt;</strong>
-  &lt;/ul&gt;
-</pre>
-<a name="ex6.rb"></a>
-<div class="program_caption">
-File 'ex6-main.rb':</div>
-<pre class="program"><strong>require 'erubis'</strong>
-require 'tenjin'
-include Erubis::XmlHelper
-context = { :items =&gt; ['&lt;AAA&gt;', 'B&amp;B', '"CCC"'] }
-engine = Tenjin::Engine.new(:layout=&gt;'ex6-layout.rhtml',
-                           <strong>:templateclass=&gt;Tenjin::ErubisTemplate</strong>)
-output = engine.render('ex6-content.rhtml', context)
-print output
-</pre>
-<a name="ex6_eruby.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ ruby ex6.rb
-&lt;html&gt;
- &lt;body&gt;
-  &lt;h1&gt;eRuby template example&lt;/h1&gt;
-  &lt;ul&gt;
-   &lt;li&gt;&amp;lt;AAA&amp;gt;&lt;/li&gt;
-   &lt;li&gt;B&amp;amp;B&lt;/li&gt;
-   &lt;li&gt;&amp;quot;CCC&amp;quot;&lt;/li&gt;
-  &lt;/ul&gt;
- &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<br>
-<a name="faq-exprpat"></a>
-<h3 class="section2">Is it able to change embedded expression pattern?</h3>
-<p>Yes, you can create subclass of Template class and override embedded expression pattern.
-</p>
-<a name="ex7-expr-pattern.rbhtml"></a>
-<div class="program_caption">
-ex7-expr-pattern.rbhtml:</div>
-<pre class="program">&lt;p&gt;HTML escaped: ${@value}&lt;/p&gt;
-&lt;p&gt;not escaped:  #{@value}&lt;/p&gt;
-&lt;p&gt;not escaped:  <strong>&lt;%= @value %&gt;</strong>&lt;/p&gt;
-</pre>
-<a name="ex7-expr-pattern.rb"></a>
-<div class="program_caption">
-ex7-expr-pattern.rb:</div>
-<pre class="program">require 'tenjin'
-class MyTemplate &lt; Tenjin::Template
-  ## return pattern object for embedded expressions
-  def <strong>expr_pattern()</strong>
-    return /([$#])\{(.*?)\}|&lt;%=(.*?)%&gt;/m
-  end
-  ## if you don't use '#{...}', you must escape '#' in addition to '\\' and '`'
-  #def escape_str(str)
-  #  return str.gsub(/[\\`\#]/, '\\\\\&amp;')
-  #end
-  ## return expression string and flag whether escape or not from matched object
-  def <strong>get_expr_and_escapeflag(match)</strong>
-    if match[1]
-      expr = match[2]
-      escapeflag = match[1] == '$'
-    else
-      expr = match[3].strip()
-      escapeflag = false
-    end
-    return expr, escapeflag
-  end
-end
-if __FILE__ == $0
-  context = { :value =&gt; 'AAA&amp;BBB' }
-  engine = Tenjin::Engine.new(<strong>:templateclass=&gt;MyTemplate</strong>)
-  output = engine.render('ex7-expr-pattern.rbhtml', context)
-  puts output
-end
-</pre>
-<a name="ex7_expr_pattern.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ ruby ex7-expr-pattern.rb
-&lt;p&gt;HTML escaped: AAA&amp;amp;BBB&lt;/p&gt;
-&lt;p&gt;not escaped:  AAA&amp;BBB&lt;/p&gt;
-&lt;p&gt;not escaped:  AAA&amp;BBB&lt;/p&gt;
-</pre>
-<br>
-<a name="faq-m17n"></a>
-<h3 class="section2">Does rbTenjin support M17N?</h3>
-<p>No, but it is easy to support M17N.
-The point is:
-</p>
-<ul type="disc">
-<li>Change cache filename according to language.
-   For example, create cache file 'file.rbhtml.en.cache', 'file.rbhtml.fr.cache', 'file.rbhtml.it.cache', and so on from template file 'file.rbhtml'.
-</li>
-<li>Create Engine object for each language.
-</li>
-<li>(optinal) Use preprocessing for performance reason.
-</li>
-</ul>
-<p>The following is an example to generate M17N pages from a template file.
-</p>
-<a name="ex8-m18n.rbhtml"></a>
-<div class="program_caption">
-ex8-m18n.rbhtml:</div>
-<pre class="program">&lt;div&gt;
-&lt;?RB ## '_()' represents translator method ?&gt;
- &lt;p&gt;<strong>${{_('Hello')}}</strong> ${@username}!&lt;/p&gt;
-&lt;/div&gt;
-</pre>
-<a name="ex8-m18n.rb"></a>
-<div class="program_caption">
-ex8-m18n.rb:</div>
-<pre class="program">require 'tenjin'
-##
-## message catalog to translate message
-##
-MESSAGE_CATALOG = {
-  'en' =&gt; { 'Hello'   =&gt; 'Hello',
-            'Good bye'=&gt; 'Good bye', },
-  'fr' =&gt; { 'Hello'   =&gt; 'Bonjour',
-            'Good bye'=&gt; 'Au revoir', },
-}
-##
-## add translation method to Context class
-##
-class Tenjin::Context
-  def _(message_key)
-    message_dict = MESSAGE_CATALOG[@_lang]
-    return message_key unless message_dict
-    return message_dict[message_key] || message_key
-  end
-end
-##
-## engine class which supports M17N
-##
-class M17NEngine &lt; Tenjin::Engine
-  <strong>attr_accessor :lang</strong>
-  ## constructor takes ':lang' options
-  def initialize(properties={})
-    super(properties)
-    @lang = properties[:lang] || 'en'   # set language
-  end
-  ## change cache filename to 'file.html.lang.cache'
-  <strong>def cachename(filename)</strong>
-    <strong>return "#{filename}.#{@lang}.cache"</strong>
-  <strong>end</strong>
-  ## set language to context object
-  def hook_context(context)
-    context = super(context)
-    context['_lang'] = @lang
-    return context
-  end
-end
-##
-## test program
-##
-if $0 == __FILE__
-  template_name = 'ex8-m18n.rbhtml'
-  context = { :username =&gt; 'World' }
-  ## engine for english
-  engine = <strong>M17NEngine</strong>.new(:preprocess=&gt;true)
-  output = engine.render(template_name, context)   # same template
-  puts "--- lang: %s ---" %  engine.lang
-  puts output
-  puts
-  ## engine for French
-  engine = <strong>M17NEngine</strong>.new(:preprocess=&gt;true, <strong>:lang=&gt;'fr'</strong>)
-  output = engine.render(template_name, context)   # same template
-  puts "--- lang: %s ---" %  engine.lang
-  puts output
-end
-</pre>
-<a name="ex8_m18n.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ ruby ex8-m18n.rb
---- lang: en ---
-&lt;div&gt;
- &lt;p&gt;<strong>Hello</strong> World!&lt;/p&gt;
-&lt;/div&gt;
---- lang: fr ---
-&lt;div&gt;
- &lt;p&gt;<strong>Bonjour</strong> World!&lt;/p&gt;
-&lt;/div&gt;
-</pre>
-<p>rbTenjin doesn't provide M17N feature directly because requirements for M17N are
-different for each applications or frameworks.
-Some applications or frameworks adapt GetText library and others use its original M17N library.
-What rbTenjin should do is not to provide M17N feature but to show an example to support M17N.
-</p>
-<br>
-<br>
-<a name="faq-layout"></a>
-<h2 class="section1">Layout Template</h2>
-<a name="faq-change-layout-template"></a>
-<h3 class="section2">Can I change layout template name in a template file?</h3>
-<p>Yes. If you set <code>@_layout</code>,
-its value is regarded as layout template name.
-</p>
-<ul type="disc">
-<li>You can specify template file name (ex. 'user_list.rbhtml') or template short name (ex. :list).
-</li>
-<li>If you set true to '@_layout', default layout template name is used instead.
-</li>
-<li>It is able to N-th level nested template.
-</li>
-</ul>
-<p>See the next section for details.
-</p>
-<br>
-<a name="faq-nested-layout-template"></a>
-<h3 class="section2">Can I nest layout templates for any depth?</h3>
-<p>Yes. If you set <code>@_layout</code>,
-you can nest layout templates in any depth.
-</p>
-<p>The following example shows that:
-</p>
-<ul type="disc">
-<li>'ex8-content.rbhtml' uses 'ex8-mylayout.rbhtml' as layout template.
-</li>
-<li>'ex8-mylayout.rbhtml' uses 'ex8-baselayout.rbhtml' as layout template.
-</li>
-</ul>
-<a name="ex9-content.rbhtml"></a>
-<div class="program_caption">
-File 'ex9-content.rbhtml':</div>
-<pre class="program">&lt;?rb @title = 'Changing Layout Template Test' ?&gt;
-&lt;?rb ## specify layout template name ?&gt;
-<strong>&lt;?rb @_layout = 'ex9-mylayout.rbhtml' ?&gt;</strong>
-foo
-bar
-baz
-</pre>
-<a name="ex9-mylayout.rbhtml"></a>
-<div class="program_caption">
-File 'ex9-mylayout.rbhtml':</div>
-<pre class="program">&lt;?rb ## use default layout template name ?&gt;
-<strong>&lt;?rb @_layout = true ?&gt;</strong>
-&lt;div id="content"&gt;
-<strong>&lt;?rb _buf &lt;&lt; @_content ?&gt;</strong>
-&lt;/div&gt;
-</pre>
-<a name="ex9-baselayout.rbhtml"></a>
-<div class="program_caption">
-File 'ex9-baselayout.rbhtml':</div>
-<pre class="program">&lt;html&gt;
-  &lt;body&gt;
-&lt;?rb if @title ?&gt;
-    &lt;h1&gt;${@title}&lt;/h1&gt;
-&lt;?rb end ?&gt;
-<strong>&lt;?rb _buf &lt;&lt; @_content ?&gt;</strong>
-  &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<a name="ex9_changelayout.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ rbtenjin --layout=ex9-baselayout.rbhtml ex9-content.rbhtml
-&lt;html&gt;
-  &lt;body&gt;
-    &lt;h1&gt;Changing Layout Template Test&lt;/h1&gt;
-&lt;div id="content"&gt;
-foo
-bar
-baz
-&lt;/div&gt;
-  &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<br>
-<a name="faq-diable-layout"></a>
-<h3 class="section2">Can I disable default layout template for a certain template?</h3>
-<p>Yes. If you set false to @_layout, default layout template will not be applied.
-</p>
-<br>
-<a name="faq-template-inheritance"></a>
-<h3 class="section2">Is Django-like "Template Inheritance" supported?</h3>
-<p>No, but you can emulate it partially by combination of template capturing and '@_layout'.
-</p>
-<a name="ex10-baselayout.rbhtml"></a>
-<div class="program_caption">
-File 'ex10-baselayout.rbhtml':</div>
-<pre class="program">&lt;html&gt;
- &lt;body&gt;
-&lt;?rb ## if variable '@header_part' is defined then print it, ?&gt;
-&lt;?rb ## else print default header part. ?&gt;
-  &lt;div id="header"&gt;
-<strong>&lt;?rb unless captured_as(:header_part) ?&gt;</strong>
-   &lt;img src="img/logo.png" alt="logo" ?&gt;
-<strong>&lt;?rb end ?&gt;</strong>
-  &lt;/div&gt;
-&lt;?rb ## main content part ?&gt;
-  &lt;div id="content"&gt;
-&lt;?rb _buf &lt;&lt; @content_part ?&gt;
-  &lt;/div&gt;
-&lt;?rb ## if variable '@footer_part' is defined then print it, ?&gt;
-&lt;?rb ## else print default footer part. ?&gt;
-  &lt;div id="footer"&gt;
-<strong>&lt;?rb unless captured_as(:footer_part) ?&gt;</strong>
-   &lt;hr /&gt;
-   &lt;em&gt;webmaster@example.com&lt;/em&gt;
-<strong>&lt;?rb end ?&gt;</strong>
-  &lt;/div&gt;
- &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<a name="ex10-customlayout.rbhtml"></a>
-<div class="program_caption">
-File 'ex10-customlayout.rbhtml':</div>
-<pre class="program">&lt;?rb ## '@_layout' variable is equivarent to '{% extends "foobar.html" %}' ?&gt;
-&lt;?rb ## in Django template engine. ?&gt;
-<strong>&lt;?rb @_layout = 'ex10-baselayout.rbhtml' ?&gt;</strong>
-&lt;?rb ## you can override header or footer by capturing. ?&gt;
-<strong>&lt;?rb start_capture(:footer_part) ?&gt;</strong>
-&lt;address style="text-align:right"&gt;
-  copyright&amp;copy; 2007 kuwata-lab all rights reserved&lt;br /&gt;
-  &lt;a href="webmaster&amp;#64;kuwata-lab.com"&gt;webmaster&amp;#64;kuwata-lab.com&lt;/a&gt;
-&lt;/address&gt;
-<strong>&lt;?rb stop_capture() ?&gt;</strong>
-</pre>
-<a name="ex10-content.rbhtml"></a>
-<div class="program_caption">
-File 'ex10-content.rbhtml':</div>
-<pre class="program">&lt;?rb ## '@_layout' variable is equivarent to '{% extends "foobar.html" %}' ?&gt;
-&lt;?rb ## in Django template engine. ?&gt;
-<strong>&lt;?rb @_layout = 'ex10-customlayout.rbhtml' ?&gt;</strong>
-&lt;?rb ## main content part ?&gt;
-<strong>&lt;?rb start_capture(:content_part) ?&gt;</strong>
-&lt;ul&gt;
-&lt;?rb for item in @items ?&gt;
-  &lt;li&gt;${item}&lt;/li&gt;
-&lt;?rb end ?&gt;
-&lt;/ul&gt;
-<strong>&lt;?rb stop_capture() ?&gt;</strong>
-</pre>
-<p>'<code>captured_as()</code>' is a pre-defined helper function.
-For example,
-</p>
-<pre class="program">&lt;?rb <strong>unless captured_as(:header_part):</strong> ?&gt;
-   &lt;img src="img/logo.png" alt="logo" ?&gt;
-&lt;?rb <strong>end</strong> ?&gt;
-</pre>
-<p>is equivarent to the following.
-</p>
-<pre class="program">&lt;?rb <strong>if @header_part:</strong> ?&gt;
-&lt;?rb     <strong>_buf &lt;&lt; @header_part</strong> ?&gt;
-&lt;?rb <strong>else</strong> ?&gt;
-   &lt;img src="img/logo.png" alt="logo" ?&gt;
-&lt;?rb <strong>end</strong> ?&gt;
-</pre>
-<p>The following is the result. It shows that footer part in baselayout is overrided by other templates.
-</p>
-<a name="ex10_inherit.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ rbtenjin -c "@items=['AAA', 'BBB', 'CCC']" ex10-content.rbhtml
-&lt;html&gt;
- &lt;body&gt;
-  &lt;div id="header"&gt;
-   &lt;img src="img/logo.png" alt="logo" ?&gt;
-  &lt;/div&gt;
-  &lt;div id="content"&gt;
-&lt;ul&gt;
-  &lt;li&gt;AAA&lt;/li&gt;
-  &lt;li&gt;BBB&lt;/li&gt;
-  &lt;li&gt;CCC&lt;/li&gt;
-&lt;/ul&gt;
-  &lt;/div&gt;
-  &lt;div id="footer"&gt;
-&lt;address style="text-align:right"&gt;
-  copyright&amp;copy; 2007 kuwata-lab all rights reserved&lt;br /&gt;
-  &lt;a href="webmaster&amp;#64;kuwata-lab.com"&gt;webmaster&amp;#64;kuwata-lab.com&lt;/a&gt;
-&lt;/address&gt;
-  &lt;/div&gt;
- &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<br>
-<br>
-<a name="faq-performance"></a>
-<h2 class="section1">Performance</h2>
-<a name="How fast is rbTenjin compared with other solutions?"></a>
-<h3 class="section2">How fast is rbTenjin compared with other solutions?</h3>
-<p>rbTenjin contains benchmark script.
-This shows that rbTenjin works much faster than other solutions.
-</p>
-<div class="terminal_caption">
-MacOS X 10.4 Tiger, Intel CoreDuo 1.83GHz, Memory 2GB</div>
-<pre class="terminal">$ cd rbtenjin-X.X.X/benchmark
-$ ruby -v
-ruby 1.8.6 (2007-03-13 patchlevel 0) [i686-darwin8.9.1]
-$ ruby bench.rb -n 10000
-                     user     system      total        real
-eruby           12.190000   0.260000  12.450000 ( 12.464225)
-eruby-cache     11.320000   0.410000  11.730000 ( 11.756440)
-erb             36.190000   0.370000  36.560000 ( 36.694964)
-erb-reuse       10.720000   0.020000  10.740000 ( 10.770338)
-erubis          10.130000   0.310000  10.440000 ( 10.476733)
-erubis-reuse     6.380000   0.010000   6.390000 (  6.405158)
-tenjin           6.600000   0.410000   7.010000 (  7.021953)
-tenjin-nocache   8.180000   0.360000   8.540000 (  8.562649)
-tenjin-reuse     4.370000   0.180000   4.550000 (  4.549724)
-</pre>
-<p>In addition, module size of rbTenjin is small, and it is very light-weight to import it.
-This is important for CGI program.
-Other solutions may be very heavy to import the module and suitable only for apache module or FastCGI.
-</p>
-<br>
-<a name="faq-why-so-fast"></a>
-<h3 class="section2">Why rbTenjin is so fast?</h3>
-<p>Because it doesn't use template engine original language.
-</p>
-<p>Other template engines, such as Template-Toolkit(perl), Django(python), or Smarty(php),
-has their original languages.
-This is not good idea for script language because:
-</p>
-<ul type="disc">
-<li>They are slow.
-</li>
-<li>Implementation will be complex.
-</li>
-<li>Learning cost is high.
-</li>
-</ul>
-<p>In addition, rbTenjin is faster than Jakarta Velocity which is a very popular template engine in Java.
-(It means that dynamic Java is slower than script languages.)
-</p>
-<p>Template engine should use their host language directly unless there are some kind of reasons.
-</p>
-<br>
-<a name="faq-performance-tuning"></a>
-<h3 class="section2">Is there any way to get more speed?</h3>
- <ul type="disc">
- <li>Tenjin::ArrayBufferTemplate may be a litte faster than Tenjin::Template.
-    Tenjin::ArrayBufferTemplate generates Ruby code which use Array buffer and Array#push() method.
-<a name="ex11.rbhtml"></a>
-<div class="program_caption">
-File 'ex11.rbhtml':</div>
-<pre class="program">&lt;table&gt;
-&lt;?rb @items.each_with_index do |item, i| ?&gt;
-  &lt;tr&gt;
-    &lt;td&gt;#{i}&lt;/td&gt;
-    &lt;td&gt;${item}&lt;/td&gt;
-  &lt;/tr&gt;
-&lt;?rb end ?&gt;
-&lt;/table&gt;
-</pre>
-<a name="ex11.source"></a>
-<div class="terminal_caption">
-Ruby code:</div>
-<pre class="terminal">$ rbtenjin -s <strong>--templateclass=Tenjin::ArrayBufferTemplate</strong> ex11.rbhtml
-<strong>_buf = []</strong>;  <strong>_buf.push</strong>('&lt;table&gt;
-'); @items.each_with_index do |item, i|
- <strong>_buf.push</strong>('  &lt;tr&gt;
-    &lt;td&gt;', (i).to_s, '&lt;/td&gt;
-    &lt;td&gt;', escape((item).to_s), '&lt;/td&gt;
-  &lt;/tr&gt;
-'); end
- <strong>_buf.push</strong>('&lt;/table&gt;
-');
-_buf.to_s
-</pre>
-<a name="ex11.rb"></a>
-<div class="program_caption">
-File 'ex11.rb':</div>
-<pre class="program">require 'tenjin'
-engine = Tenjin::Engine.new(<strong>:templateclass=&gt;Tenjin::ArrayBufferTemplate</strong>)
-context = { :items=&gt;['AAA', 'BBB', 'CCC'] }
-output = engine.render('ex11.rbhtml', context)
-puts output
-</pre>
-<a name="ex11_arraybuffer.result"></a>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ ruby ex11.rb
-&lt;table&gt;
-  &lt;tr&gt;
-    &lt;td&gt;0&lt;/td&gt;
-    &lt;td&gt;AAA&lt;/td&gt;
-  &lt;/tr&gt;
-  &lt;tr&gt;
-    &lt;td&gt;1&lt;/td&gt;
-    &lt;td&gt;BBB&lt;/td&gt;
-  &lt;/tr&gt;
-  &lt;tr&gt;
-    &lt;td&gt;2&lt;/td&gt;
-    &lt;td&gt;CCC&lt;/td&gt;
-  &lt;/tr&gt;
-&lt;/table&gt;
-</pre>
-<p>    The following is an example of benchmark of Tenjin::Template and Tenjin::ArrayBufferTemplate.
-    This shows that Tenjin::ArrayBufferTemplate is faster than Tenjin::Template when template object (or template engine object) is able to be reused.
-</p>
-<div class="terminal_caption">
-Result:</div>
-<pre class="terminal">$ ruby bench.rb -n 10000 tenjin tenjin-nocache tenjin-reuse \
-    tenjin-arrbuf tenjin-arrbuf-nocache tenjin-arrbuf-reuse
-                          user     system      total        real
-tenjin                 6.660000   0.430000   7.090000 (  7.106619)
-tenjin-nocache         8.260000   0.360000   8.620000 (  8.655595)
-tenjin-reuse           4.360000   0.060000   <strong>4.420000</strong> (  4.439242)
-tenjin-arrbuf          6.630000   0.430000   7.060000 (  7.078775)
-tenjin-arrbuf-nocache 10.150000   0.370000  10.520000 ( 10.574526)
-tenjin-arrbuf-reuse    4.080000   0.070000   <strong>4.150000</strong> (  4.160438)
-</pre>
-<p>    Notice that Tenjin::ArrayBufferTemplate is an experimental.
-</p>
- </li>
- <li>'<code>&lt;?rb _buf &lt;&lt; @_content ?&gt;</code>' may be a litte faster than '<code>#{@_content}</code>' if @_content is large.
-<a name="ex11-layout1.rbhtml"></a>
-<div class="program_caption">
-File 'ex11-layout1.rbhtml':</div>
-<pre class="program">&lt;html&gt;
-  &lt;body&gt;
-<strong>#{@_content}</strong>
-  &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<a name="ex11-layout2.rbhtml"></a>
-<div class="program_caption">
-File 'ex11-layout2.rbhtml':</div>
-<pre class="program">&lt;html&gt;
-  &lt;body&gt;
-<strong>&lt;?rb _buf &lt;&lt; @_content ?&gt;</strong>
-  &lt;/body&gt;
-&lt;/html&gt;
-</pre>
-<div class="program_caption">
-File 'ex11-content.rbhtml':</div>
-<pre class="program">&lt;table&gt;
-  &lt;tbody&gt;
-&lt;?rb for i in (1..100) ?&gt;
-    &lt;tr id="row#{i}"&gt;
-      &lt;td&gt;#{i}&lt;/td&gt;
-    &lt;/tr&gt;
-&lt;?rb end ?&gt;
-  &lt;/tbody&gt;
-&lt;/table&gt;
-</pre>
-<a name="ex11-bench.rb"></a>
-<div class="program_caption">
-File 'ex11-bench.rb':</div>
-<pre class="program">## create Engine object for each layout file
-require 'tenjin'
-engine1 = Tenjin::Engine.new(:layout=&gt;'ex11-layout1.rbhtml')
-engine2 = Tenjin::Engine.new(:layout=&gt;'ex11-layout2.rbhtml')
-## warm up
-filename = 'ex11-content.rbhtml'
-output1 = engine1.render(filename)
-output2 = engine2.render(filename)
-raise "*** output1 != output2" if output1 != output2
-## do benchmark
-require 'benchmark'
-N = 10000
-Benchmark.bm(20) do |job|
-  GC.start()
-  job.report('layout1') do
-    N.times do
-      output1 = engine1.render(filename)
-    end
-  end
-  GC.start()
-  job.report('layout2') do
-    N.times do
-      output2 = engine2.render(filename)
-    end
-  end
-end
-</pre>
-<div class="terminal_caption">
-Result: (MacOS 10.4 Tiger, Intel CoreDuo 1.83GHz, Memory 2GB)</div>
-<pre class="terminal">$ ruby ex11-bench.rb
-                          user     system      total        real
-layout1               3.920000   0.200000   4.120000 (  4.201779)
-layout2               3.900000   0.190000   4.090000 (  4.179283)
-</pre>
- </li>
- </ul>
-<br>
-<br>
-   </div>
-  </blockquote>
- </body>
-</html>