{!-- This example showcases exec macros, "if" conditionals and loops.
  -- The template to execute can be inline, defined in the optional
  -- {% body %}...{% endbody %} section, or you can execute a template
  -- snippet from anywhere in your theme.
  --
  -- {% exec [template-name] %}
  --
  --    {% data [@[xml|json|json-strict]] %}
  --      PARAMS...
  --    {% enddata %}
  --
  --    {% body %}
  --      ...
  --    {% endbody %}
  --
  -- {% endexec %}
  --
  -- If both a template reference *and* a {% body %} section are
  -- provided, the template reference will take priority.
  --
  -- A simple xml parser is built-in, but you must add the json-smart
  -- library jar or jackson-databind to your classpath if you wish to
  -- use "@json" or "@json-strict" parameter formatting.
  --}
{% exec %}

 {% data @json %}
{
  name: "Jim and Della",
  assets: [{name:"Hair",value:"195"},
           {name:"Watch",value:"145"}]
}
 {% enddata %}

 {% body %}
<div>

 <h1>{$name}</h1>

 {% if ($assets) %}
 <h2>Assets</h2>
 <ul>
  {% loop in $assets as $asset %}
  <li>{$asset.name} - ${%  $asset.value|sprintf(%.2f)  %}</li>
  {% endloop %}
 </ul>
 {% endif %}

</div>
 {% endbody %}

{% endexec %}

Theme theme = new Theme();

// fetch template from themes/example.chtml
Chunk html = theme.makeChunk("example");

// Insert business logic here.
// Normally you write a lot of html.set("this","that") calls here.

StreamWriter out = getStreamWriter();
html.render( out );

///// or, return the rendered template as a string
// return html.toString();

{!-- {% include %} is simpler but does not offer a data prep step.
  --
  -- {% exec %}...{% endexec %} runs any template macro-style,
  -- with different data assignments per use.
  --
  -- For convenience, {% data %} and {% body %} tags are optional;
  -- if one section is present, the rest is assumed to be the other.
  --
  -- NB: If {% data %} tags are omitted, data format can be specified
  -- in the exec tag, eg: {% exec @xml %}
  --}
<h2>Include:</h2>
<p class="docnote">Simpler, but no data prep.</p>

{% include #example_3 %}

<hr/>

<h2>Exec:</h2>
<p class="docnote">Provide data for included template.</p>

{% exec #example_3 @json %}
 {name:"Armstrong",
  message:"Your turn to buy beer."}
{% endexec %}

Theme theme = new Theme();

// fetch template from themes/example.chtml
Chunk html = theme.makeChunk("example");

// Insert business logic here.
// Normally you write a lot of html.set("this","that") calls here.

StreamWriter out = getStreamWriter();
html.render( out );

///// or, return the rendered template as a string
// return html.toString();

{#example_3}
<div>
 Earth to {$name}.  Come in, {$name}.
 {% if ($message) %}
  <p>{$message}</p>
 {% endif %}
</div>
{#}

//...

{!--
  --    {% exec [template] @xml %}     (tag values passed via XML)
  --}
{% exec #example_3 @xml %}
<values>
 <name>XML</name>
 <message>Oh, XML, you're so bloated.</message>
</values>
{% endexec %}

Theme theme = new Theme();

// fetch template from themes/example.chtml
Chunk html = theme.makeChunk("example");

// Insert business logic here.
// Normally you write a lot of html.set("this","that") calls here.

StreamWriter out = getStreamWriter();
html.render( out );

///// or, return the rendered template as a string
// return html.toString();

{!--
  --    {% exec [template] %}    (default arg-passing format)
  --}
{% exec #example_3 %}
 {$name = Apollo}
{% endexec %}

Theme theme = new Theme();

// fetch template from themes/example.chtml
Chunk html = theme.makeChunk("example");

// Insert business logic here.
// Normally you write a lot of html.set("this","that") calls here.

StreamWriter out = getStreamWriter();
html.render( out );

///// or, return the rendered template as a string
// return html.toString();

{!--
  --    {% exec [template] %}
  --
  -- This example shows tag assignments in simple form ($name)
  -- and long form ($message).
  --
  --}
{% exec #example_3 %}
 {$name = Apollo}
 {$message=}{% include lorem_ipsum %}{=}
{% endexec %}

Theme theme = new Theme();

// fetch template from themes/example.chtml
Chunk html = theme.makeChunk("example");

// Insert business logic here.
// Normally you write a lot of html.set("this","that") calls here.

StreamWriter out = getStreamWriter();
html.render( out );

///// or, return the rendered template as a string
// return html.toString();

{!--
  -- XML attributes are assigned to an {$elt_name@attr_name} tag.
  -- Nested elements are just a dot away: {$parent_elt.child_elt}
  --}
{% exec %}
  {% data @xml %}
<values>
 <name>XML</name>
 <message type="taunt">Oh, XML, you're so bloated.</message>
 <favorite_place>
   <name>Tahiti</name>
 </favorite_place>
</values>
  {% enddata %}

<div>
  Earth to {$name}.  Come in, {$name}.
  {% if ($message) %}
    <p class="{$message@type}">{$message}</p>
  {% endif %}

  <p>{$name} likes to travel to {$favorite_place.name}.</p>

</div>

{% endexec %}

Theme theme = new Theme();

// fetch template from themes/example.chtml
Chunk html = theme.makeChunk("example");

// Insert business logic here.
// Normally you write a lot of html.set("this","that") calls here.

StreamWriter out = getStreamWriter();
html.render( out );

///// or, return the rendered template as a string
// return html.toString();