home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 25 / CDROM25.iso / Share / linux / apache / contrib / modules / mod_phantomimap.c.readme < prev    next >
Encoding:
Text File  |  1998-06-11  |  2.3 KB  |  51 lines
  1.  
  2.                               I N T R A N E T
  3.                                       
  4.                                  Web Pages
  5.                                       
  6.                              Phantom .map files
  7.                                       
  8.    .map files are part of the server-side mechanism supporting browsers
  9.    incapable of understanding the <MAP> and <AREA> tags. These files look
  10.    nothing like HTML and are a nuisance to maintain in tandem with the
  11.    modern HTML-based image maps. The webserver has now been told how to
  12.    read <MAP> and <AREA> tags in .html files directly, reducing image map
  13.    maintenance to the <AREA> tags alone. The only restrictions imposed on
  14.    <MAP> and <AREA> tags used this way is that they must be the first and
  15.    only thing on a line (whitespace excepted).
  16.    
  17.    Phantom .map behaviour is invoked with something like the following:
  18. <!-- Pretend this is a snippet from the file somefile.html -->
  19.  
  20.         <MAP NAME="whatever">
  21.         <AREA...> (several of these)
  22.         </MAP>
  23.  
  24.         <A HREF="somefile.html.whatever.map">
  25.         <IMG SRC="some.gif" ISMAP USEMAP="#whatever">
  26.         </A>
  27.  
  28.    Conceptually, the <A HREF> is asking the server to look in the file
  29.    somefile.html for whatever.map, ie the <MAP NAME="whatever"> element.
  30.    (If the .whatever had been omitted - somefile.html.map - the server
  31.    would just have used the first <MAP> tag it came across). The ISMAP in
  32.    the <IMG> tag tells older browsers to send the mouse coordinates to
  33.    the server when they request the link surrounding the image. For
  34.    browsers which don't even support this, the .map is turned into a menu
  35.    of options.
  36.    
  37.    As expected, in the same way that USEMAP="otherfile.html#this" will
  38.    refer to a <MAP NAME="this"> in otherfile.html, so <A
  39.    HREF="otherfile.html.this.map"> will refer to the same thing for the
  40.    server-based system.
  41.    
  42.    Since phantom .map files are something which require server support,
  43.    HREF="http://some.server/somefile.html.this.map" would only work if
  44.    some.server supported it. (This refers to reading the map itself, not
  45.    to the links which a map might make, once read.)
  46.    
  47.    The term Phantom is used because the .map files don't actually exist,
  48.    but they appear to.
  49.    
  50.    Old style .map files are still supported by this module.
  51.