RubyGems - ember - Versions diffs - 0.3.0 → 0.3.1 - Mend

ember 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

metadata CHANGED

@@ -1,48 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: ember
 version: !ruby/object:Gem::Version
-  prerelease: false
-  segments:
-  - 0
-  - 3
-  - 0
-  version: 0.3.0
+  prerelease:
+  version: 0.3.1
 platform: ruby
 authors:
 - Suraj N. Kurapati
-- Kamil Kukura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2010-04-26 00:00:00 -07:00
-default_executable:
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: inochi
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        segments:
-        - 2
-        version: "2"
-  type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency
-  name: dfect
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        segments:
-        - 2
-        version: "2"
-  type: :development
-  version_requirements: *id002
-description: Ember (EMBEdded Ruby) is an eRuby template processor that allows debugging, reduces markup, and improves composability of eRuby templates.
+date: 2011-04-22 00:00:00 Z
+dependencies: []
+description: Ember (EMBEdded Ruby) is an [eRuby] template processor that allows
 debugging, reduces markup, and improves composability of eRuby templates.
 email:
 executables:
 - ember
@@ -52,15 +23,12 @@ extra_rdoc_files: []
 files:
 - bin/ember
-- lib/ember.rb
-- lib/ember/inochi.rb
-- lib/ember/template.rb
 - lib/ember/helpers/rails_helper.rb
+- lib/ember/template.rb
+- lib/ember/inochi.rb
+- lib/ember.rb
 - LICENSE
-- CREDITS
-- man.html
-- man/man1/ember.1.gz
-has_rdoc: true
+- man/man1/ember.1
 homepage: http://snk.tuxfamily.org/lib/ember/
 licenses: []
@@ -70,23 +38,21 @@ rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      segments:
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      segments:
-      - 0
       version: "0"
 requirements: []
 rubyforge_project:
-rubygems_version: 1.3.6
+rubygems_version: 1.7.2
 signing_key:
 specification_version: 3
 summary: eRuby template processor

data/CREDITS DELETED

@@ -1,13 +0,0 @@
-%#----------------------------------------------------------------------------
-## CREDITS
-%#----------------------------------------------------------------------------
-Suraj N. Kurapati,
-Kamil Kukura
-%#----------------------------------------------------------------------------
-## LICENSE
-%#----------------------------------------------------------------------------
-%# See the file named "LICENSE".
-%< "LICENSE"

data/man.html DELETED

@@ -1,1031 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <meta http-equiv='content-type' value='text/html;charset=utf8'>
-  <meta name='generator' value='Ronn/v0.5 (http://github.com/rtomayko/ronn)'>
-  <title>ember(1) - eRuby template processor</title>
-  <style type='text/css'>
-    body {margin:0}
-    #man, #man code, #man pre, #man tt, #man kbd, #man samp {
-      font-family:consolas,monospace;
-      font-size:16px;
-      line-height:1.3;
-      color:#343331;
-      background:#fff; }
-    #man { max-width:87ex; margin:0 3ex 1ex 1ex; text-align:justify; }
-    #man div.man-navigation {
-      position:fixed;
-      top:0;
-      left:91ex;
-      height:100%;
-      width:100%;
-      padding:1ex 0 0 2ex;
-      border-left:0.5ex solid #DCDCDC;
-      background-color: #F5F5F5;
-    }
-    #man div.man-navigation a { display:block; margin-bottom:1.5ex }
-    #man h1, #man h2, #man h3 { color:#232221;clear:left }
-    #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
-    #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
-    #man h3 { font-size:16px; margin:0 0 0 4ex; }
-    #man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
-    #man pre {
-      color:#333231;
-      background:#edeceb;
-      padding:5px 7px;
-      margin:0px 0 20px 0;
-      border-left:2ex solid #ddd}
-    #man pre + h2, #man pre + h3 {
-      margin-top:22px;
-    }
-    #man h2 + pre, #man h3 + pre {
-      margin-top:5px;
-    }
-    #man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
-    #man dt { margin:0; clear:left }
-    #man dt.flush { float:left; width:8ex }
-    #man dd { margin:0 0 0 9ex }
-    #man code, #man strong, #man b { font-weight:bold; color:#131211; }
-    #man pre code { font-weight:normal; color:#232221; background:inherit }
-    #man em, var, u {
-      font-style:normal; color:#333231; border-bottom:1px solid #999; }
-    #man h1.man-title { display:none; }
-    #man ol.man, #man ol.man li { margin:2px 0 10px 0; padding:0;
-      float:left; width:33%; list-style-type:none;
-      text-transform:uppercase; font-size:18px; color:#999;
-      letter-spacing:1px;}
-    #man ol.man { width:100%; }
-    #man ol.man li.tl { text-align:left }
-    #man ol.man li.tc { text-align:center;letter-spacing:4px }
-    #man ol.man li.tr { text-align:right; float: right }
-    #man ol.man a { color:#999 }
-    #man ol.man a:hover { color:#333231 }
-    #man img { display:block; margin:auto }
-  </style>
-  <style type='text/css' media='print'>
-    #man { max-width:none }
-    #man div.man-navigation { display:none }
-    #man a[href]:not([href^="#"]):not([data-bare-link]):after {
-      content:" " attr(href);
-    }
-  </style>
-</head>
-<body>
-<div id='man'>
-<div class='man-navigation'>
-  <a href="#NAME">NAME</a>
-  <a href="#ABOUT">ABOUT</a>
-  <a href="#SYNOPSIS">SYNOPSIS</a>
-  <a href="#DESCRIPTION">DESCRIPTION</a>
-  <a href="#OPTIONS">OPTIONS</a>
-  <a href="#SYNTAX">SYNTAX</a>
-  <a href="#EXAMPLES">EXAMPLES</a>
-  <a href="#HACKING">HACKING</a>
-  <a href="#VERSIONS">VERSIONS</a>
-  <a href="#CREDITS">CREDITS</a>
-  <a href="#LICENSE">LICENSE</a>
-  <a href="#SEE-ALSO">SEE ALSO</a>
-  </div>
-<h1 class='man-title'>ember(1)</h1>
-<ol class='head man'>
-  <li class='tl'>ember(1)</li>
-  <li class='tc'>Version 0.3.0</li>
-  <li class='tr'>ember(1)</li>
-</ol>
-<h2 id='NAME'>NAME</h2>
-<p><code>ember</code> - eRuby template processor</p>
-<h2 id="ABOUT">ABOUT</h2>
-<p>Ember (<em>EMBE</em>dded <em>R</em>uby) is an <a href="http://en.wikipedia.org/wiki/ERuby">eRuby template</a> processor that allows
-debugging, reduces markup, and improves composability of eRuby templates.</p>
-<h3 id="Features">Features</h3>
-<ul>
-<li><p>Reports correct line numbers in error message stack traces.</p></li>
-<li><p>Omits newlines trailing code-only <code>&lt;% ... %&gt;</code> directives.</p></li>
-<li><p>Can infer missing <code>&lt;% end %></code> directives based on indentation.</p></li>
-<li><p>Can unindent eRuby block bodies hierarchically.</p></li>
-<li><p>Written in 361 lines of pure
-Ruby.</p></li>
-</ul>
-<h3 id="Resources">Resources</h3>
-<dl>
-<dt>Issue tracker (report bugs, request features, get help)</dt><dd><p><a href="http://github.com/sunaku/ember/issues" data-bare-link="true">http://github.com/sunaku/ember/issues</a></p></dd>
-<dt>Source code (browse online or obtain with <a href="http://git-scm.com">Git</a>)</dt><dd><p><a href="http://github.com/sunaku/ember" data-bare-link="true">http://github.com/sunaku/ember</a></p></dd>
-<dt>API documentation</dt><dd><p><a href="http://snk.tuxfamily.org/lib/ember/api/" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/api/</a></p></dd>
-<dt>Announcements feed</dt><dd><p><a href="http://snk.tuxfamily.org/lib/ember/ann.xml" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/ann.xml</a></p></dd>
-<dt>Official website</dt><dd><p><a href="http://snk.tuxfamily.org/lib/ember/" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/</a></p></dd>
-</dl>
-<h3 id="Setup">Setup</h3>
-<p>Prerequisites:</p>
-<ul>
-<li><p><a href="http://ruby-lang.org">Ruby</a> 1.8.6 or newer.</p></li>
-<li><p><a href="http://rubygems.org">RubyGems</a> 1.3.6 or newer.</p></li>
-</ul>
-<p>Installing:</p>
-<pre><code>gem install ember
-</code></pre>
-<p>Installing as a <a href="http://rubyonrails.org">Ruby on Rails</a> plugin:</p>
-<pre><code>script/plugin install git://github.com/sunaku/ember.git
-</code></pre>
-<p>Upgrading:</p>
-<pre><code>gem update ember
-</code></pre>
-<p>Removing:</p>
-<pre><code>gem uninstall ember
-</code></pre>
-<h2 id="SYNOPSIS">SYNOPSIS</h2>
-<p><code>ember</code> [<var>OPTIONS</var>] [<var>FILE</var>]</p>
-<h2 id="DESCRIPTION">DESCRIPTION</h2>
-<p>Evaluates eRuby directives (see <strong>SYNTAX</strong> below) in the given <var>FILE</var> and
-writes the result to the standard output stream (STDOUT).  If <var>FILE</var> is not
-given, then the standard input stream (STDIN) is evaluated instead.</p>
-<h2 id="OPTIONS">OPTIONS</h2>
-<dl>
-<dt><code>-s</code>, <code>--shorthand</code></dt><dd><p>Treat lines beginning with zero or more whitespace
-followed by the "%" character as eRuby directives.</p></dd>
-<dt><code>-i</code>, <code>--infer_end</code></dt><dd><p>Add missing <code>&lt;% end %></code> directives based on indentation.</p></dd>
-<dt><code>-u</code>, <code>--unindent</code></dt><dd><p>Unindent the bodies of directives that define a
-Ruby block (do ... end) or scope (begin ... end).</p></dd>
-<dt><code>-c</code>, <code>--compile</code></dt><dd><p>Print underlying Ruby program compiled
-from the input eRuby template and exit.</p></dd>
-<dt><code>-h</code>, <code>--help</code></dt><dd><p>Display this manual and exit.</p></dd>
-<dt><code>-v</code>, <code>--version</code></dt><dd><p>Print version number and exit.</p></dd>
-</dl>
-<h2 id="SYNTAX">SYNTAX</h2>
-<p>This section explains <a href="http://en.wikipedia.org/wiki/ERuby">eRuby template</a> syntax and Ember extensions thereof.</p>
-<p>eRuby templates are plain-text documents that contain special processing
-instructions known as <strong>directives</strong>.  These instructions are evaluated <em>in
-place</em>, meaning that they are replaced by the result of their evaluation.</p>
-<h3 id="Directives">Directives</h3>
-<p>Directives are expressed in either <strong>standard</strong> or <strong>shorthand</strong> notation:</p>
-<pre><code>Notation    Directive   Head   Operation   Body   Tail
---------    ---------   ----   ---------   ----   ----
-Standard    &lt;%XY%>      &lt;%     X           Y      %>
-Shorthand   %XY         %      X           Y
-</code></pre>
-<p>In standard notation, the directive is composed of a <strong>head</strong>, an
-<strong>operation</strong>, a <strong>body</strong>, and a <strong>tail</strong>; and it may appear anywhere in the
-template.</p>
-<p>In shorthand notation, the directive is composed of a <strong>head</strong>, an
-<strong>operation</strong>, and a <strong>body</strong>; and it may only appear in the template if it
-occupies an entire line (leading whitespace is permitted only in Ember;
-trailing whitespace is permitted in both Ember and eRuby).</p>
-<p>Regardless of the notation used, directives are atomic constructs; they cannot
-be nested within one another.</p>
-<h3 id="Operations">Operations</h3>
-<p>The first character following the head of a directive is known as an
-<strong>operation</strong>.  It determines how the directive is processed by Ember.</p>
-<dl>
-<dt class="flush"><code>#</code></dt><dd><p>The entire directive is omitted from the output.</p></dd>
-<dt class="flush"><code>=</code></dt><dd><p>The body of the directive is evaluated as Ruby code, and the result of
-this evaluation is inserted into the output.</p></dd>
-<dt class="flush"><code>~</code></dt><dd><p>(only in Ember) The body of the directive is evaluated as an eRuby
-template, and the result of this evaluation is inserted into the output.</p></dd>
-<dt class="flush"><code>+</code></dt><dd><p>(only in Ember) The body of the directive is evaluated as Ruby code, and
-the result of this evaluation is assumed to be a string that specifies the
-path (either absolute or relative to the eRuby template file in which this
-directive is found) to a file containing an eRuby template.  This file is
-read and its contents are evaluated as an eRuby template, and the result
-of this evaluation is inserted into the output.</p></dd>
-<dt class="flush"><code>&lt;</code></dt><dd><p>(only in Ember) The body of the directive is evaluated as Ruby code, and
-the result of this evaluation is assumed to be a string that specifies the
-path (either absolute or relative to the eRuby template file in which this
-directive is found) to a file.  This file is read and its contents are
-inserted into the output.</p></dd>
-<dt class="flush"><code>|</code></dt><dd><p>(only in Ember) The body of the directive is treated as the beginning of a
-Ruby block.  The <code>do</code> keyword is automatically appended to the body of the
-directive if missing.</p></dd>
-<dt class="flush"><code>%</code></dt><dd><p>One "%" character is omitted from the head of the directive and the entire
-directive is inserted into the output.</p></dd>
-<dt>None of the above</dt><dd><p>The body of the directive is evaluated as Ruby code, but the result of
-this evaluation <em>is not</em> inserted into the output.</p></dd>
-</dl>
-<h2 id="EXAMPLES">EXAMPLES</h2>
-<p>Begin by loading Ember into Ruby:</p>
-<pre><code>require 'rubygems' # might not be necessary; see HACKING
-require 'ember'
-</code></pre>
-<p>Instantiate an Ember template processor:</p>
-<pre><code>source   = "your eRuby template here"
-options  = {} # see API documentation
-template = Ember::Template.new(source, options)
-</code></pre>
-<p>Inspect the Ruby program that was compiled (and is used) by the Ember
-template processor to evaluate the eRuby template given as input:</p>
-<pre><code>puts template.program
-</code></pre>
-<p>View the result of evaluating the eRuby template:</p>
-<pre><code>puts template.render
-</code></pre>
-<p>See the API documentation for more information.</p>
-<h3 id="An-empty-template">An empty template</h3>
-<pre></pre>
-<p>The above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre></pre>
-<h3 id="Comment-directives">Comment directives</h3>
-<pre><code>&lt;%# this is a comment %>
-%# this is also a comment
-&lt;%# this
-is
-    a
-multi-line comment %>
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre>
-</pre>
-<h3 id="Escaped-directives">Escaped directives</h3>
-<pre><code>&lt;%% this is an escaped directive %>
-%% this is an escaped directive
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; "&lt;% this is an escaped directive %>\n"
-_erbout &lt;&lt; "% this is an escaped directive\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>&lt;% this is an escaped directive %>
-% this is an escaped directive
-</code></pre>
-<h3 id="Vocal-directives">Vocal directives</h3>
-<pre><code>&lt;%= "hello" %>
-%= "world"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; ("hello") &lt;&lt; "\n"
-_erbout &lt;&lt; ("world") &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>hello
-world
-</code></pre>
-<h3 id="Silent-directives">Silent directives</h3>
-<pre><code>&lt;% a = "hello" %>
-% b = "world"
-&lt;%= a %>
-%= b
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  a = "hello"
- b = "world"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; (a) &lt;&lt; "\n"
-_erbout &lt;&lt; (b) &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>hello
-world
-</code></pre>
-<h3 id="Block-directives">Block directives</h3>
-<pre><code>% words = %w[hello world]
-&lt;% words.each do |w| %&gt;
-  &lt;%= w %>
-&lt;% end %>
-% words.each do |w|
-  %= w
-% end
-%|words.each |w|
-  %= w
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
-_erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
- end
-_erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
- end
-_erbout &lt;&lt; "\n"
-words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>  hello
-  world
-  hello
-  world
-  hello
-  world
-</code></pre>
-<h3 id="Unindent-block-content">Unindent block content</h3>
-<pre><code>&lt;% [1].each do |i| %&gt;
-  &lt;%= i %>
-    % [2].each do |j|
-      %= j
-              %|[3].each |k|
-                   %= k
-              % end
-    % end
-&lt;% end %>
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  [1].each do |i|
-_erbout &lt;&lt; (i) &lt;&lt; "\n"
- [2].each do |j|
-_erbout &lt;&lt; (j) &lt;&lt; "\n"
-[3].each do |k|
-_erbout &lt;&lt; (k) &lt;&lt; "\n"
- end
- end
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>1
-2
-3
-</code></pre>
-<h3 id="Wrap-block-content">Wrap block content</h3>
-<p>In this manner, you can create domain specific languages in eRuby.</p>
-<pre><code>&lt;%
-  def introducing(subject, &amp;block)
-    Ember::Template.wrap_content_block(block, rand(10)) do |content|
-      "And now I would like to introduce #{subject}:\n\n#{content.join}"
-    end
-  end
-  def coin_toss(pronoun, &amp;block)
-    Ember::Template.wrap_content_block(block) do |content|
-      "#{pronoun} favorite side of a coin toss is #{content.join}."
-    end
-  end
- %&gt;
-% introducing "Matz" do |number|
-  Father of the Ruby programming language,
-  and also a jolly and well mannered fellow.
-  % coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
-  def introducing(subject, &amp;block)
-    Ember::Template.wrap_content_block(block, rand(10)) do |content|
-      "And now I would like to introduce #{subject}:\n\n#{content.join}"
-    end
-  end
-  def coin_toss(pronoun, &amp;block)
-    Ember::Template.wrap_content_block(block) do |content|
-      "#{pronoun} favorite side of a coin toss is #{content.join}."
-    end
-  end
-_erbout &lt;&lt; "\n"
- introducing "Matz" do |number|
-_erbout &lt;&lt; "Father of the Ruby programming language,\n"
-_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
-_erbout &lt;&lt; "\n"
- coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>And now I would like to introduce Matz:
-Father of the Ruby programming language,
-and also a jolly and well mannered fellow.
-His favorite side of a coin toss is tails.
-</code></pre>
-<h3 id="Capture-block-content">Capture block content</h3>
-<p>In this manner, you can create domain specific languages in eRuby.</p>
-<pre><code>&lt;%
-  def introducing(subject, &amp;block)
-    content = Ember::Template.content_from_block(block, rand(2))
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "introducing(#{subject.inspect}):\n\n#{content.join}"
-  end
-  def coin_toss(pronoun, &amp;block)
-    content = Ember::Template.content_from_block(block)
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "coin_toss(#{pronoun.inspect}): #{content.join}"
-  end
- %&gt;
-% introducing "Matz" do |number|
-  Father of the Ruby programming language,
-  and also a jolly and well mannered fellow.
-  % coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
-  def introducing(subject, &amp;block)
-    content = Ember::Template.content_from_block(block, rand(2))
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "introducing(#{subject.inspect}):\n\n#{content.join}"
-  end
-  def coin_toss(pronoun, &amp;block)
-    content = Ember::Template.content_from_block(block)
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "coin_toss(#{pronoun.inspect}): #{content.join}"
-  end
-_erbout &lt;&lt; "\n"
- introducing "Matz" do |number|
-_erbout &lt;&lt; "Father of the Ruby programming language,\n"
-_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
-_erbout &lt;&lt; "\n"
- coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>introducing("Matz"):
-Father of the Ruby programming language,
-and also a jolly and well mannered fellow.
-coin_toss("His"): heads
-</code></pre>
-<h3 id="Template-evaluation-result-buffer">Template evaluation result buffer</h3>
-<p>In this manner, you can create domain specific languages in eRuby.</p>
-<pre><code>&lt;%
-  def introducing(subject, &amp;block)
-    buffer = Ember::Template.buffer_from_block(block)
-    #
-    # you can do whatever you want with buffer,
-    # now that you have a reference to it! &gt;:-)
-    #
-    buffer &lt;&lt; "introducing(#{subject.inspect})"
-  end
- %&gt;
-% introducing "Matz" do |number|
-  Father of the Ruby programming language,
-  and also a jolly and well mannered fellow.
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
-  def introducing(subject, &amp;block)
-    buffer = Ember::Template.buffer_from_block(block)
-    #
-    # you can do whatever you want with buffer,
-    # now that you have a reference to it! &gt;:-)
-    #
-    buffer &lt;&lt; "introducing(#{subject.inspect})"
-  end
-_erbout &lt;&lt; "\n"
- introducing "Matz" do |number|
-_erbout &lt;&lt; "Father of the Ruby programming language,\n"
-_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>introducing("Matz")
-</code></pre>
-<h3 id="Infer-block-endings">Infer block endings</h3>
-<p>Omit <code>&lt;% end %></code> directives from the template:</p>
-<pre><code>% words = %w[hello world]
-&lt;% words.each do |w| %&gt;
-  &lt;%= w %>
-% words.each do |w|
-  %= w
-%|words.each |w|
-  %= w
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :infer_end=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
-_erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
-end; _erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
-end; _erbout &lt;&lt; "\n"
-words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
-end; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>  hello
-  world
-  hello
-  world
-  hello
-  world
-</code></pre>
-<h3 id="Raw-file-inclusion">Raw file inclusion</h3>
-<p>When <code>doc/example.txt</code> contains:</p>
-<pre><code>This is a plain-text file.  Notice that &lt;%=
-"eRuby directives" %> have no effect here!
-</code></pre>
-<p>And the eRuby template is:</p>
-<pre><code>&lt;%&lt; "doc/example.txt" %&gt;
-%&lt; "doc/example.txt"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>This is a plain-text file.  Notice that &lt;%=
-"eRuby directives" %> have no effect here!
-This is a plain-text file.  Notice that &lt;%=
-"eRuby directives" %> have no effect here!
-</code></pre>
-<h3 id="Template-file-inclusion">Template file inclusion</h3>
-<p>When <code>doc/example.erb</code> contains:</p>
-<pre><code>This is an eRuby template.  Notice that &lt;%=
-"eRuby directives" %> do take effect here!
-</code></pre>
-<p>And the eRuby template is:</p>
-<pre><code>&lt;%+ "doc/example.erb" %&gt;
-%+ "doc/example.erb"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>This is an eRuby template.  Notice that eRuby directives do take effect here!
-This is an eRuby template.  Notice that eRuby directives do take effect here!
-</code></pre>
-<h3 id="Dynamic-template-evaluation">Dynamic template evaluation</h3>
-<pre><code>&lt;%~ "%= 2 + 2" %>
-%~ "%= 2 + 2"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>4
-4
-</code></pre>
-<h2 id="HACKING">HACKING</h2>
-<p>This section is meant for people who want to develop Ember's source code.</p>
-<h3 id="Prerequisites">Prerequisites</h3>
-<p>Install Ruby libraries necessary for development:</p>
-<pre><code>gem install ember --development
-</code></pre>
-<h3 id="Infrastructure">Infrastructure</h3>
-<p><a href="http://snk.tuxfamily.org/lib/inochi/">Inochi</a> serves as the project infrastructure for Ember.  It handles tasks
-such as building this help manual and API documentation, and packaging,
-announcing, and publishing new releases.  See its help manual and list of
-tasks to get started:</p>
-<pre><code>inochi --help     # display help manual
-inochi --tasks    # list available tasks
-</code></pre>
-<h3 id="-LOAD_PATH-setup">$LOAD_PATH setup</h3>
-<p>Ensure that the <code>lib/</code> directory is listed in Ruby's <code>$LOAD_PATH</code> before you
-use any libraries therein or run any executables in the <code>bin/</code> directory.</p>
-<p>This can be achieved by passing an option to Ruby:</p>
-<pre><code>ruby -Ilib bin/ember
-irb -Ilib -r ember
-</code></pre>
-<p>Or by setting the <code>$RUBYLIB</code> environment variable:</p>
-<pre><code>export RUBYLIB=lib   # bash, ksh, zsh
-setenv RUBYLIB lib   # csh
-set -x RUBYLIB lib   # fish
-ruby bin/ember
-irb -r ember
-</code></pre>
-<p>Or by installing the <a href="http://github.com/chneukirchen/rup">ruby-wrapper</a> tool.</p>
-<h3 id="RubyGems-setup">RubyGems setup</h3>
-<p>If you use Ruby 1.8 or older, then ensure that RubyGems is activated before
-you use any libraries in the <code>lib/</code> directory or run any executables in the
-<code>bin/</code> directory.</p>
-<p>This can be achieved by passing an option to Ruby:</p>
-<pre><code>ruby -rubygems bin/ember
-irb -rubygems -r ember
-</code></pre>
-<p>Or by setting the <code>$RUBYOPT</code> environment variable:</p>
-<pre><code>export RUBYOPT=-rubygems   # bash, ksh, zsh
-setenv RUBYOPT -rubygems   # csh
-set -x RUBYOPT -rubygems   # fish
-</code></pre>
-<h3 id="Running-tests">Running tests</h3>
-<p>Simply execute the included test runner, which sets up Ruby's <code>$LOAD_PATH</code> for
-testing, loads the included <code>test/test_helper.rb</code> file, and then evaluates all
-<code>test/**/*_test.rb</code> files:</p>
-<pre><code>test/runner
-</code></pre>
-<p>Its exit status will indicate whether all tests have passed.  It may also
-print additional pass/fail information depending on the testing library used
-in the <code>test/test_helper.rb</code> file.</p>
-<h3 id="Contributing">Contributing</h3>
-<p>Fork this project on GitHub (see <strong>Resources</strong> above) and send a pull request.</p>
-<h2 id="VERSIONS">VERSIONS</h2>
-<p>This section contains release notes of current and past releases.</p>
-<h3 id="Version-0-3-0-2010-04-26-">Version 0.3.0 (2010-04-26)</h3>
-<p>This release adds <em>class methods</em> that let you (portably and more easily)
-create your own domain specific languages in eRuby; adds more usage
-<strong>EXAMPLES</strong> in the help manual; and removes a binding inheritance hack.</p>
-<p>New features:</p>
-<dl>
-<dt><code>Ember::Template::wrap_content_block()</code></dt><dd><p>Wraps eRuby block content appending.</p></dd>
-<dt><code>Ember::Template::content_from_block()</code></dt><dd><p>Extracts content from eRuby blocks.</p></dd>
-<dt><code>Ember::Template::buffer_from_block()</code></dt><dd><p>Gives access to template evalutaion result buffer.</p></dd>
-</dl>
-<p>Bug fixes:</p>
-<ul>
-<li>Remove hack for inheriting parent template binding.</li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li><p>Add example on unindenting node content and eRuby DSL examples that use
-the new content block methods.</p></li>
-<li><p>Simplify code examples using the new wrap_content_block() method.</p></li>
-</ul>
-<h3 id="Version-0-2-0-2010-04-25-">Version 0.2.0 (2010-04-25)</h3>
-<p>This release adds <a href="http://rubyonrails.org">Ruby on Rails</a> integration.</p>
-<p>New features:</p>
-<ul>
-<li><p>Ember can now be used directly as a <a href="http://rubyonrails.org">Ruby on Rails</a> (2.3 or newer) plugin.
-The plugin registers Ember as the default Rails template handler for "erb"
-and "rhtml" file types.  Ember processing options can be set in the Rails
-environment file:</p>
-<pre><code>ActionView::TemplateHandlers::Ember.options = {
-  :unindent =&gt; true,
-  :shorthand =&gt; true,
-  :infer_end =&gt; true
-}
-</code></pre>
-<p>This feature was contributed by Kamil Kukura.</p></li>
-</ul>
-<h3 id="Version-0-1-1-2010-04-20-">Version 0.1.1 (2010-04-20)</h3>
-<p>This release fixes a nested rendering bug, updates the manual, and further
-beautifies the Ruby code that results from eRuby template compilation.</p>
-<p>Bug fixes:</p>
-<ul>
-<li><p><code>Ember::Template#render()</code> now creates isolated contexts by default to
-prevent nested calls from clobbering each other's output!</p>
-<p>For example, if template A calls method X which renders template B
-(thinking that template B's rendering is isolated and will not affect the
-rendering of template A) then you're in for a wild bug chase!  >8-(</p></li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li><p>Upgrade to Inochi 2.0.0rc5.  Convert manual from ERBook to Ember + Ronn.</p></li>
-<li><p>Remove spaces around value insertions in template compilation output.</p></li>
-<li><p>Remove logo images from source repository because they're no longer used.</p></li>
-</ul>
-<h3 id="Version-0-1-0-2010-04-03-">Version 0.1.0 (2010-04-03)</h3>
-<p>This release improves the handling of eRuby comment directives, fixes a bug
-in the <code>&lt;% end %></code> inference logic, and performs some minor housekeeping.</p>
-<p>New features:</p>
-<ul>
-<li><p>Single-line comment directives are now ignored (treated like no-ops)
-in input templates.  This allows us to surround eRuby block directives
-with section separators made from single-line comment directives:</p>
-<pre><code>%|some_block_directive
-  Inside some_block_directive.
-%#-------------------------------------------------------------------
-  Still inside some_block_directive!
-  %#-----------------------------------------------------------------
-  %| nested_block_directive
-  %#-----------------------------------------------------------------
-    Inside nested_block_directive.
-</code></pre></li>
-</ul>
-<p>Bug fixes:</p>
-<ul>
-<li><code>&lt;% end %></code> inference did not work for blocks
-beginning with <code>def</code>, <code>class</code>, and <code>module</code> keywords.</li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li>Upgrade to Inochi 2.0.0-rc3.  This project no longer
-depends on the "inochi" or "trollop" gems at runtime.</li>
-</ul>
-<h3 id="Version-0-0-1-2009-10-03-">Version 0.0.1 (2009-10-03)</h3>
-<p>This release improves Ruby 1.9 support and revises the user manual.</p>
-<p>Bug fixes:</p>
-<ul>
-<li>Nested templates could not access parent's binding in Ruby 1.9</li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li><p>Use simpler Copyright reminder at the top of every file.</p></li>
-<li><p>Rename internal <code>Program</code> class' methods to be self-documenting.</p></li>
-<li><p>Open source is for fun, so <a href="http://loiclemeur.com/english/2009/03/never-criticize-your-competitors.html">be nice</a> and speak of "related works" instead of "competitors".</p></li>
-</ul>
-<h3 id="Version-0-0-0-2009-02-13-">Version 0.0.0 (2009-02-13)</h3>
-<p>This is the first public release of Ember.  Enjoy!</p>
-<h2 id="CREDITS">CREDITS</h2>
-<p>Suraj N. Kurapati,
-Kamil Kukura</p>
-<h2 id="LICENSE">LICENSE</h2>
-<p>(the ISC license)</p>
-<p>Copyright 2009 Suraj N. Kurapati <a href="&#x6d;&#97;&#x69;&#108;&#116;&#x6f;&#x3a;&#115;&#117;&#x6e;&#x61;&#107;&#x75;&#64;&#103;&#109;&#x61;&#x69;&#x6c;&#x2e;&#99;&#111;&#109;" data-bare-link="true">&#x73;&#117;&#110;&#97;&#x6b;&#x75;&#64;&#x67;&#109;&#97;&#105;&#108;&#x2e;&#x63;&#x6f;&#x6d;</a></p>
-<p>Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.</p>
-<p>THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.</p>
-<h2 id="SEE-ALSO">SEE ALSO</h2>
-<p>erb(1)</p>
-<ol class='foot man'>
-  <li class='tl'></li>
-  <li class='tc'>April 2010</li>
-  <li class='tr'>ember(1)</li>
-</ol>
-</div>
-</body>
-</html>