README.imap 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344
  1. Description: this code adds a new output filter to dot/tcldot.
  2. The new filter is called "imap". It is used just like "ps,"
  3. "ismap," "gif," and the rest of the output filters.
  4. The new filter produces an "imap" file, the new-style
  5. Apache-compatible equivalent of the old-style "ismap" file which
  6. dot already knows how to produce. In either case, the purpose is
  7. to map regions or points on a gif image to URLs, so that the user
  8. of a web browser can click on the gif image and activate anchors
  9. that invoke other pages. The "ismap" map file style which was
  10. commonly used with early (NCSA) http servers required an external
  11. mapping mechanism kept in the cgi-bin dir (ismap executable or
  12. user-supplied equivalent), whereas recent Apache servers include
  13. the imap functionality in the server itself. To configure an
  14. Apache server to use imap files correctly, uncomment this line
  15. # If you wish to use server-parsed imagemap files, use
  16. AddHandler imap-file map
  17. in srm.conf. From then on, you can use files of the form mumble.map
  18. as follows:
  19. <A HREF="./EER.Database.map">
  20. <IMG ISMAP SRC="./EER.Database.gif">
  21. </A>
  22. The .map file will be used as the image map for the associated
  23. gif image. The new "imapgen" filter for dot produces valid imap
  24. files for use with Apache servers.
  25. In addition to being Apache-compliant, the imap file produced
  26. by imapgen can include clickable edge points as well as node
  27. rectangles. If the attribute "URL" is defined for an edge, then
  28. the label virtual node will be bound/mapped to that URL, as will
  29. spline points along the edge. If the special attributes "tailURL"
  30. and/or "headURL" are set, then the head and tail points of the
  31. edge will be bound to those URL, otherwise the head and tail will
  32. default to the main URL. The older ismapgen code did not
  33. support edge URLs.
  34. [JCE may wish to correct my wording in the description of ismap
  35. (old-style) files above]