with

Replace a part of an included template.

part name of the part to modify
do method to use as replacement

<r:include template='layout.html'>
  <r:with part='stylesheets'>
    <r:stylesheets list='reset,zena,code'/>
    <link href="super.css" rel="Stylesheet" type="text/css"/>
  </r:with>
  <r:with part='related'/>
  <r:with part='doc_list' do='documents'>
    <li do='each' do='link'/>
  </r:with>
</r:include>

This method is a very powerful way to specialize a template by modifying only the parts that need to be different, keeping the rest as it is.

If the with is an empty tag as in the second example above, the element is removed from the included template. In the example, related will be removed.

In the last example, we use the do syntax to replace the original method. For example, if the orginal code was:

<ul id='doc_list' do='pages'>
  ...
</ul>

or

<ul><r:pages name='doc_list'>
  ...
</ul>

After replacement from the last example above, we would get:

<ul id='doc_list' do='documents'>
  <li do='each' do='link'/>
</ul>

or

<ul><r:documents name='doc_list'>
  <li do='each' do='link'/>
</ul>

See name on how names are set.