← Back to branch summary

~ubuntu-branches/ubuntu/lucid/graphviz/lucid-security

« back to all changes in this revision

Viewing changes to dotneato/common/README.imap

  • Committer: Bazaar Package Importer
  • Author(s): Stephen M Moraco
  • Date: 2002-02-05 18:52:12 UTC
  • Revision ID: james.westby@ubuntu.com-20020205185212-8i04c70te00rc40y
Tags: upstream-1.7.16
Import upstream version 1.7.16

Show diffs side-by-side

added added

removed removed

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