|
syntax
< img src="filename" ...>
synopsis
IF, NOT, ELSEIF, ELSE, and /IF are the building
blocks for conditional processing. The basic form is shown above.
"Conditional" is either a "compare" or "is defined" operation. A
compare operator is a test of the value of a macro against a literal
string:
< DEF NAME="HEADERIMG" OPTION="SRC TITLE SIZE">
< IF size>
<FONT SIZE=${size}>
< /IF>
< IMG SRC=pics/${src}>
< USE title>
< IF size>
</FONT>
< /IF>
< /DEF>
<HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
<HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
This will fail:
<HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another title">
Instead, use * like this:
< DEF NAME="MYIMG" OPTION="SRC *">
< IMG SRC="pics/${src}" $*>
< /DEF>
<MYIMG SRC="logo.gif" ALT="Our logo">
and a defined operator is a test of a macro's existance:
< imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
< imageurl url="other.domain.org/" path="/var/www/other.domain/">
For this line: < img src="logo.gif">
the local filename "logo.gif" will be used to determine image dimensions
(no URL replacement).
For this line: < img src="http://my.domain.org/logo.gif">
the local filename "/var/www/my.domain/logo.gif" will be used.
But for this line: < img src="http://other.domain.org/logo.gif">
the local file cannot be found (no prefix match), so the image dimensions
will not be added.
Order is important; last IMAGEURL tag takes precedence:
< imageurl url="/" path="/var/www/htdocs/">
< imageurl url="/test/" path="/var/www/test/">
< img src="/image.gif"> and < img src="/test/image.gif"> are mapped to
/var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
If the order of the imageurl lines would be swapped, the second
image would be mapped to /var/www/htdocs/test/image.gif.
If the NOT tag is present in the IF markup, the evaluation of the
conditional is reversed. The first IF or ELSEIF condition that
evaluates to true is chosen. If none of the conditions is true the
ELSE block is taken if it is present. A conditional block
must be closed with the /IF tag. IF tags can be nested.
|