<BLOCK syntax>
<imageurl url="imageurl" [ path="path/in/local/filesystem" ]>
</BLOCK>

<BLOCK synopsis>

<P>
<STRONG>IMAGEURL</STRONG> tells htp, where to find images on the local
file system.  declares an URL replacement that is used for
size lookups in any <A HREF="img.html">IMG</A> tag. This definitions
takes effect only if the <A HREF="opt.html">IMGXY</A> option is
enabled.  Beacause htp can't lookup files in the world wide web
you have to map absolute image URLs to a directory in
the local file system.</P>

<P>
When an IMG tag is encountered where htp has to insert width and
height the defined URL replacements will be taken into account (later
definitions take precedence to earlier): For each defined imageurl it
checks (case-insensitive) if it is a prefix of the image's SRC
attribute. If it matches this prefix is replaced by the given PATH.
If no IMAGEURL matches the SRC is considered as relative link and
looked up in the current directory.</P>

<P>
For example:</P>

<htpcode>
  <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.
</htpcode>
<P>
If IMAGEURL is specified with a URL but no PATH attribute, it is treated as
an undefine, and is removed.</P>
<P>
Since you usually need the url mapping for a number of images used throughout
a set of documents, IMAGEURL is most appropriately put into an
<A HREF="file.html">include file</A> or the
<a href="default.html">htp.def</a> file.</P>
<P>
In addition to WIDTH and HEIGHT, htp can also (semi-)automatically add 
an <a href="alttext.html">ALT text</a> attribute to 
<a href="img.html">IMG</A> tags.</P>

</BLOCK>

