String tags
String tags are container tags that process their contents somehow.
Examples are the <sort> tag that sorts its contents and the
<tablify> tag that creates good looking tables from tab
separated text files.
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.
Our example contains an <obox> tag enclosing
a <smallcaps> tag.
<obox>
<smallcaps>Hello World</smallcaps>
</obox> |
Which will result in:
The first thing that will happen is that the RXML parser handles
the <obox> tag, which creates some HTML table code to draw a
box around its contents. The result from the first pass will be
something like:
<generated HTML table code>
<smallcaps>Hello World</smallcaps>
</generated HTML table code>
|
This result will then be parsed another time by the RXML parser,
which will then run the <smallcaps> tag.
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 preparse attribute to all RXML
container tags. This will cause the RXML parser to parse the contents
of the tag before parsing the actual tag.
Below follows an example where the preparse attribute
makes a huge difference.
<source>
<smallcaps>Hello World</smallcaps>
</source> |
generates
<smallcaps>Hello World</smallcaps>
HELLO WORLD
while
<source preparse>
<smallcaps>Hello World</smallcaps>
</source> |
generates
H<font size=-1>ELLO</font> W<font size=-1>ORLD</font>
HELLO WORLD
Special Attributes
- preparse
-
is not the only special attribute that can be
given to all RXML tags. They are:
- nooutput
-
The tag will generate no output at all. Side
effects, for example sending queries to databases, will have effect.
- noparse
-
Can be used with all container tags. The
result of the tag will not be run through the RXML parser.
- preparse
-
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.
String tags
- <ai>
-
Makes it possible to use a database of
links.
- <autoformat>
-
Replaces all
line-feeds in the content with <br> tags.
- <case>
-
Changes the case of the enclosed
text.
- <comment>
-
The contents will be
completely removed from the page.
- <doc>
-
Simplifies writing html examples.
Within the <doc> tag { will be replaced by < and } by >.
Thus eliminating the need to write < and > manually.
- <fl>
-
Used to build folding lists.
- <obox>
-
draws outlined boxes.
- <smallcaps>
-
Prints the contents in
smallcaps.
- <sort>
-
Sorts the contents
alphabetically.
- <source>
-
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.
- <spell>
-
Checks and marks common
misspellings in the contents.
- <tablify>
-
Generates tables from the
contents.
- <trimlines>
-
Removes all empty lines
from the contents.
|