
<!-- THIS-IS-INTERNAL-RXML-DOC-AUTOMATICLY-GENERATED-FROM-THE-MANUAL -->
</dump-if>







































































<table cellpadding=1 cellspacing=0 border=0>
<tr>
<td bgcolor=#113377 width=1%>



<b><font color=#ffffff size=+3 >&nbsp;&lt;insert&gt;&nbsp;</font></b>

</td>
<td>
<img src=/internal-roxen-unit width=200 height=1 alt=""></td>
</tr>

<tr>
<td bgcolor=black colspan=2>


<table cellpadding=4 border=0 cellspacing=0 width=100%>
<tr>
<td bgcolor=#ffffff>



<tt>&lt;insert&gt;</tt> is defined in the <i>Main RXML parser</i> module.
<p>
Inserts values from files, cookies, defines or variables. If used to
insert cookies or variables <tt>&lt;insert&gt;</tt> will quote before
inserting, to make it impossible to insert dangerous RXML tags.


<br clear=all>
<img src=/internal-roxen-unit width=1 height=10 alt="">

</td>
</tr>
</table>


<table cellpadding=4 border=0 cellspacing=0>
<tr>
<td bgcolor=#113377 width=1%>
<font color=white>Attributes</font>
</td>
<td bgcolor=#ffffff>
<img src=/internal-roxen-unit width=100% height=1 alt=""></td>
</tr>
<tr>

<td bgcolor=#ffffff colspan=2>






<a href="#cookie">cookie</a>,
<a href="#cookies">cookies</a>,
<a href="#encode">encode</a>,
<a href="#define">define</a>,
<a href="#file">file</a>,
<a href="#</b></tt><i>fromword</i><tt><b>"></b></tt><i>fromword</i><tt><b></a>,
<a href="#nocache">nocache</a>,
<a href="#variable">variable</a>,
&nbsp;

</td>
</tr>
</table>


</td>
</tr>
</table>






































<p>
<b><font color=#113377 size=+2 >Attributes</font></b>



<dl>

<p><dt><tt><b><a name="cookie">cookie</a></b></tt>=<i>cookie</i>
<dd>
Inserts the value of the cookie.




<p><dt><tt><b><a name="cookies">cookies</a></b></tt>=full

<dd>
Inserts the value of all cookies. With the optional argument full, the
insertion will be more verbose.



<dl>

</dl>



<p><dt><tt><b><a name="encode">encode</a></b></tt>=none
html

<dd>
Determines what quoting method should be when inserting cookies or
variables. Default is <i>html</i>, which means that &lt;, &gt; and
&amp; will be quoted, to make sure you can't insert RXML tags. If you
choose <i>none</i> nothing will be quoted. It will be possible to
insert dangerous RXML tags so you must be of what your variables
contain.



<dl>

</dl>



<p><dt><tt><b><a name="define">define</a></b></tt>=<i>name</i>
<dd>
Inserts this define, which must have been defined by the
<tt>&lt;define&gt;</tt> tag before it is used. The define can be done in
another file, if you have inserted the file. 




<p><dt><tt><b><a name="file">file</a></b></tt>=<i>path</i>
<dd>
Inserts the file. This file will then be fetched just as if someone
had tried to fetch it through an HTTP request. This makes it possible to
include things like the result of Pike scripts.

<p>If path does not begin with <i>/</i>, it is assumed to be a URL
relative to the directory containing the page with the
<tt>&lt;insert&gt;</tt> tag. Note that included files will be parsed if they
are named with an extension the main RXML parser handles. This might
cause unexpected behavior. For example, it will not be possible to
share any macros defined by the <tt>&lt;define&gt;</tt> tags. 

<p>If you want to have a file with often used macros you should name
it with an extension that won't be parsed. For example,
<i>.txt</i>.




<p><dt><tt><b><a name="</b></tt><i>fromword</i><tt><b>"></b></tt><i>fromword</i><tt><b></a></b></tt>=<i>toword</i>
<dd>
Replaces fromword with toword in the macro or file, before insering
it. Note that only lower case character sequences can be replaced.




<p><dt><tt><b><a name="nocache">nocache</a></b></tt>

<dd>
Don't cache results when inserting files, but always fetch the file. 



<p><dt><tt><b><a name="variable">variable</a></b></tt>=<i>variable</i>
<dd>
Insert the variable.




</dl>










<b><font color=#113377 size=+2 >Example</font></b>


<table border=0 cellpadding=1 cellspacing=0 bgcolor=#000000>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=4>
 <tr>
  <td valign=top bgcolor=#113377>
   <font color=#ffffff><b>source code</b></font>
  </td>
  <td bgcolor=white>
<pre><define name=foo>
<define name=foo>This is a foo</define>

<insert name=foo>
<br><insert name=foo foo=cat>
<br><insert name=foo a=some foo=cats is=are>
</define>
<insert name=foo "<"=&lt; ">"=&gt; ></pre>
   <br clear=all>
   <img src=/internal-roxen-unit width=1 height=1 alt="">
  </td>
 </tr>
 <tr>
  <td height=1 bgcolor=#113377><img src=/internal-roxen-unit width=1 height=1 alt=""></td>
  <td height=1 bgcolor=#ffffff>

   <table border=0 cellpadding=0 cellspacing=0 width=100%>
    <tr>
     <td bgcolor=#000000>
     <img src=/internal-roxen-unit width=1 height=1 alt=""></td>
    </tr>
   </table>
  </td>
 </tr>
 <tr>
  <td valign=top bgcolor=#113377>
  <font color=#ffffff><b>result</b></font>
</td>
<td valign=top bgcolor=#ffffff>


<define name=foo>This is a foo</define>

<insert name=foo>
<br><insert name=foo foo=cat>
<br><insert name=foo a=some foo=cats is=are>


   <br clear=all>
   <img src=/internal-roxen-unit width=1 height=1 alt="">
</td>
</tr>

</table>
</td>
</tr>
</table><p>


<if not cookie=rxml-help>

</td></tr>
</table>
</body>
</html>


