htp on-line reference : IMAGEURL

syntax

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



synopsis

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.

For example:

  <imageurl url="http://my.domain.org/" path="./">
  <imageurl url="other.domain.org/" path="./">

  If this line: <img src="logo.gif">
  becomes this after processing: <img src="logo.gif" width="16" height="16">
  (no URL replacement)

  Then this line: <img src="http://my.domain.org/logo.gif">
  becomes this after processing:  
  <img src="http://my.domain.org/logo.gif" width="16" height="16">
  (using filename "./logo.gif")

  But this line: <img src="http://other.domain.org/logo.gif">
  remains unchanged
  (no prefix match!)

  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 IMAGEURL is specified with a URL but no PATH attribute, it is treated as an undefine, and is removed.

Since this is useful for a number of images used throughout a set of documents, IMAGEURL is most appropriate in an include file or a default file.

In addition to WIDTH and HEIGHT, htp can also (semi-)automatically add an ALT text attribute to IMG tags.