HTP

htp on-line reference : IMAGEURL

Table of Contents
  Introduction
  License
  Tutorial
  Usage
  HTP Tags
    ALTTEXT
    BLOCK
    BLOCKDEF
    DEF
    FILE
    IF
    INC
    IMG
  > IMAGEURL
    OPT
    OUTPUT
    QUOTE
    SET
    UNDEF
    UNSET
    USE, $
    WHILE
    <!---
  History
  Wish list
  Bugs

syntax

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

synopsis

IMAGEURL tells htp, where to find images on the local file system. declares an URL replacement that is used for size lookups in any IMG tag. This definitions takes effect only if the IMGXY 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.

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:

  <[ref]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
  <[ref]imageurl url="other.domain.org/" path="/var/www/other.domain/">

  For this line: <[ref]img src="logo.gif">
  the local filename "logo.gif" will be used to determine image dimensions
  (no URL replacement).

  For this line: <[ref]img src="http://my.domain.org/logo.gif">
  the local filename "/var/www/my.domain/logo.gif" will be used.

  But for this line: <[ref]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:
  <[ref]imageurl url="/" path="/var/www/htdocs/">
  <[ref]imageurl url="/test/" path="/var/www/test/">

  <[ref]img src="/image.gif"> and <[ref]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 IMAGEURL is specified with a URL but no PATH attribute, it is treated as an undefine, and is removed.

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 include file or the htp.def file.

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

  page source
  htp project
  htp homepage
hosted by
Sourceforge
HTML coding Powered by htp
htp on-line reference / http://htp.sourceforge.net/ref/
Authors: Jim Nelson, Jochen Hoenicke, Michael Möller.
Maintainers: Jochen Hoenicke.

Copyright © 1995–96 Jim Nelson.
Copyright © 2001–2014 Jochen Hoenicke.
Permission to reproduce and distribute this hypertext document granted according to terms described in the License section.

last updated Sat May 16, 2015