<html>
<head>
<title>String tags</title>
<meta name="keywords" content="">
</head>

<body bgcolor=#113377 text=#000000 vlink=#551a8b alink=#00c0ff link=#0000ee>




















































<table width=100% border=0>
<tr>
  <td valign=top>
  <table width=100% cellpadding=5 cellspacing=0 border=0>
    <tr><td bgcolor="#ffffff" align=center>
       <img height=40 alt="" src="../../img/logga.gif" border=0 width=102>
    </td></tr>
    <tr><td valign=top>
      <img src=internal-roxen-unit width=1 height=3 alt="">
    </td></tr>
    <tr valign=top>
      <td bgcolor="#ffffff">




        <table cellpadding=0 cellspacing=0 border=0>
          
       <!--a1  Introduction manual.tmpl-->
    
            <tr><td><a href="../introduction/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../introduction/index.html">Introduction</a></td>
	    </tr>
    
          
       <!--a1  Publishing web pages manual.tmpl-->
    
            <tr><td><a href="../publishing/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../publishing/index.html">Publishing web pages</a></td>
	    </tr>
    
          
       <!--a1  RXML manual.tmpl-->
    
            <tr><td><a href="../rxml/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../rxml/index.html">RXML</a></td>
	    </tr>
    
          
       <!--a1  Information tags manual.tmpl-->
    
            <tr><td><a href="../information/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../information/index.html">Information tags</a></td>
	    </tr>
    
          
       <!--a1  String tags manual.tmpl-->
    
            <tr><td><a href="index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="index.html"><b>String tags</b></a></td>
	    </tr>
    
          
	</table>
	
        <table cellpadding=0 cellspacing=0 border=0>
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="ai.html"><img src="../../img/page.gif" border=0></a>&nbsp;</td>
	      <td><a href="ai.html">&lt;ai&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="autoformat.html"><img src="../../img/page.gif" border=0></a>&nbsp;</td>
	      <td><a href="autoformat.html">&lt;autoformat&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="case.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="case.html">&lt;case&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="comment.html"><img src="../../img/page.gif" border=0></a>&nbsp;</td>
	      <td><a href="comment.html">&lt;comment&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="doc.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="doc.html">&lt;doc&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="fl.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="fl.html">&lt;fl&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="obox.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="obox.html">&lt;obox&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="smallcaps.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="smallcaps.html">&lt;smallcaps&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="sort.html"><img src="../../img/page.gif" border=0></a>&nbsp;</td>
	      <td><a href="sort.html">&lt;sort&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="source.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="source.html">&lt;source&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="spell.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="spell.html">&lt;spell&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="tablify.html"><img src="../../img/page.gif" border=0></a>&nbsp;</td>
	      <td><a href="tablify.html">&lt;tablify&gt;</a></td>
	    </tr>
    
	  
      <!--b1  -->
    
	    <tr><td>&nbsp;&nbsp;<a href="trimlines.html"><img border=0 src="../../img/page.gif"></a>&nbsp;</td>
	      <td><a href="trimlines.html">&lt;trimlines&gt;</a></td>
	    </tr>
    
	  
        </table>

        <table cellpadding=0 cellspacing=0 border=0>
          
      <!--c1  -->
    
            <tr><td><a href="../variable/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../variable/index.html">Variable tags</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../url/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../url/index.html">URL tags</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../if/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../if/index.html">If tags</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../graphics/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../graphics/index.html">Graphics tags</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../database/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../database/index.html">Database tags</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../ldap/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../ldap/index.html">LDAP</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../programming/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../programming/index.html">Programming tags</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../ssi/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../ssi/index.html">SSI tags</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../image_maps/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../image_maps/index.html">Image maps</a></td>
	    </tr>
    
          
      <!--c1 intraseek -->
    
      <!--c2 intraseek -->
           
    
          
      <!--c1 logview -->
    
      <!--c2 logview -->
           
    
          
      <!--c1 platform -->
    
      <!--c2 platform -->
           
    
          
      <!--c1 platform -->
    
      <!--c2 platform -->
           
    
          
      <!--c1 platform -->
    
      <!--c2 platform -->
           
    
          
      <!--c1  -->
    
            <tr><td><a href="../supports/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../supports/index.html">Supports system</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../security/index.html"><img border=0 src="../../img/chapter.gif"></a>&nbsp;</td>
	      <td><a href="../security/index.html">Security</a></td>
	    </tr>
    
          
      <!--c1  -->
    
            <tr><td><a href="../appendix/index.html"><img src="../../img/chapter.gif" border=0></a>&nbsp;</td>
	      <td><a href="../appendix/index.html">Appendix</a></td>
	    </tr>
    
          
	</table>

      </td>
    </tr>
    <tr><td height=100%>&nbsp;</td></tr>
  </table>
  </td>
  <td>
    <img src=internal-roxen-unit width=3 height=1 alt="">
  </td>

  <td valign=top>
    <table cellspacing=0 cellpadding=5 width=100% height=100% border=0>
    <tr>
      <td bgcolor="#ffffff">
       <b><font size=+2>String tags</font></b>

	<p>String tags are container tags that process their contents somehow.
Examples are the <tt>&lt;sort&gt;</tt> tag that sorts its contents and the
<tt>&lt;tablify&gt;</tt> tag that creates good looking tables from tab
separated text files.

<p>The contents of an RXML container tag may contain other RXML tags.
However, this is not as simple as it may seem since the outer tag is,
by default, handled first. The following example will try to explain
what happens.

<p>Our example contains an <tt>&lt;obox&gt;</tt> tag enclosing
a <tt>&lt;smallcaps&gt;</tt> tag.

<p><p><center>
<table bgcolor=#d0d0d0 cellpadding=12 cellspacing=0 border=0>
<tr><td>&lt;obox&gt;
<br>&lt;smallcaps&gt;Hello World&lt;/smallcaps&gt;
<br>&lt;/obox&gt;</td></tr>
</table>
</center>
<p>


<p>Which will result in:


<center><p><table border=0 cellpadding=0 cellspacing=0>
<tr><td colspan=5 bgcolor="#000000">
<img height=1 alt="" src="../../internal-roxen-unit" width=1></td></tr>
<tr><td bgcolor="#000000"><img alt="" src="../../internal-roxen-unit" height=1 width=1></td>
<td colspan=3>
<table border=0 cellspacing=0 cellpadding=5><tr><td>
H<font size=-1>ELLO</font> W<font size=-1>ORLD</font></td></tr></table>
</td><td bgcolor="#000000"><img alt="" height=1 src="../../internal-roxen-unit" width=1></td></tr>
<tr><td colspan=5 bgcolor="#000000">
<img alt="" height=1 src="../../internal-roxen-unit" width=1></td></tr>
</table>
</center>



<p>The first thing that will happen is that the RXML parser handles
the <tt>&lt;obox&gt;</tt> tag, which creates some HTML table code to draw a
box around its contents. The result from the first pass will be
something like:


<p><p><center>
<table bgcolor=#d0d0d0 cellpadding=12 cellspacing=0 border=0>
<tr><td>&lt;generated HTML table code&gt;
<br>&lt;smallcaps&gt;Hello World&lt;/smallcaps&gt;
<br>&lt;/generated HTML table code&gt;
</td></tr>
</table>
</center>
<p>




<p>This result will then be parsed another time by the RXML parser,
which will then run the <tt>&lt;smallcaps&gt;</tt> tag.

<p>That the outer tag is handled first is usually not a problem, but
in some special cases it will cause a problem. It is, therefore,
possible to give the <i>preparse</i> attribute to all RXML
container tags. This will cause the RXML parser to parse the contents
of the tag before parsing the actual tag.

<p>Below follows an example where the <i>preparse</i> attribute
makes a huge difference.

<p><p><center>
<table bgcolor=#d0d0d0 cellpadding=12 cellspacing=0 border=0>
<tr><td>&lt;source&gt;
<br>&lt;smallcaps&gt;Hello World&lt;/smallcaps&gt;
<br>&lt;/source&gt;</td></tr>
</table>
</center>
<p>


<p>generates


<p><pre>
&lt;smallcaps&gt;Hello World&lt;/smallcaps&gt;
</pre><hr><h2></h2><hr>
H<font size=-1>ELLO</font> W<font size=-1>ORLD</font>




<p>while

<p><p><center>
<table bgcolor=#d0d0d0 cellpadding=12 cellspacing=0 border=0>
<tr><td>&lt;source preparse&gt;
<br>&lt;smallcaps&gt;Hello World&lt;/smallcaps&gt;
<br>&lt;/source&gt;</td></tr>
</table>
</center>
<p>


<p>generates


<p><pre>
H&lt;font size=-1&gt;ELLO&lt;/font&gt; W&lt;font size=-1&gt;ORLD&lt;/font&gt;
</pre><hr><h2></h2><hr>
H<font size=-1>ELLO</font> W<font size=-1>ORLD</font>





<p><a name="Special Attributes">
<b><font size=+2>Special Attributes</font></b></a>
<br>

<dl>

<dt><b>preparse</b><dd>


 is not the only special attribute that can be
given to all RXML tags. They are:

<p>
<dt><b>nooutput</b><dd>


The tag will generate no output at all. Side
effects, for example sending queries to databases, will have effect.

<p>
<dt><b>noparse</b><dd>


Can be used with all container tags. The
result of the tag will not be run through the RXML parser.

<p>
<dt><b>preparse</b><dd>


Can be used with all container tags. The
contents of the tag will be run through the RXML parser before the tag
itself is handled.
</dl>



<p><a name="String tags">
<b><font size=+2>String tags</font></b></a>
<br>

<dl>


<dt><b><a href=ai.html>&lt;ai&gt;</a></b><dd>

Makes it possible to use a database of
links.

<p>

<dt><b><a href=autoformat.html>&lt;autoformat&gt;</a></b><dd>

Replaces all
line-feeds in the content with <tt>&lt;br&gt;</tt> tags.

<p>

<dt><b><a href=case.html>&lt;case&gt;</a></b><dd>

Changes the case of the enclosed
text.

<p>

<dt><b><a href=comment.html>&lt;comment&gt;</a></b><dd>

The contents will be
completely removed from the page.

<p>

<dt><b><a href=doc.html>&lt;doc&gt;</a></b><dd>

Simplifies writing html examples.
Within the <tt>&lt;doc&gt;</tt> tag { will be replaced by &lt; and } by &gt;.
Thus eliminating the need to write &amp;lt; and &amp;gt; manually.

<p>

<dt><b><a href=fl.html>&lt;fl&gt;</a></b><dd>

Used to build folding lists.

<p>

<dt><b><a href=obox.html>&lt;obox&gt;</a></b><dd>

draws outlined boxes.

<p>

<dt><b><a href=smallcaps.html>&lt;smallcaps&gt;</a></b><dd>

Prints the contents in
smallcaps.

<p>

<dt><b><a href=sort.html>&lt;sort&gt;</a></b><dd>

Sorts the contents
alphabetically.

<p>

<dt><b><a href=source.html>&lt;source&gt;</a></b><dd>

Used to show examples of HTML
or RXML code. It will first show the source code, then a separator and
last the results of the code.

<p>

<dt><b><a href=spell.html>&lt;spell&gt;</a></b><dd>

Checks and marks common
misspellings in the contents.

<p>

<dt><b><a href=tablify.html>&lt;tablify&gt;</a></b><dd>

Generates tables from the
contents.

<p>

<dt><b><a href=trimlines.html>&lt;trimlines&gt;</a></b><dd>

Removes all empty lines
from the contents.
</dl>


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