.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>quisp: links and urls</title>
<body bgcolor=99cc99 vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td align=right><a href="quisp_home.html">
<img src="img/quisp2.gif" border=0><br><small>quick server pages</a> &nbsp; &nbsp; </td></tr>
<td>
.>>

.TH links and URLs TDH "01-JUN-2005   TDH scg@jax.org" 

.SH Links and URLs

.ig >>
<br><br>
.>>

.SH Links to QUISP pages
Every URL involving a QUISP web site should specify the user variable \fBrtn\fR.
\fBrtn\fR tells QUISP which page script to load,
relative to your project's \fC./pages\fR subdirectory.
For example, suppose the "home page" for your site is in the file \fChome\fR ...
Other web sites would link to it using a URL like this: 
.LP
\fC<a href="http://abc.com/cgi-bin/quispcgi?rtn=home">Home page</a>\fR.
.LP
Links between two QUISP pages within the same project can use a construct such as this:
.LP
\fC<a href="?rtn=home">Home page</a>\fR
.LP
Some older browsers don't support the above relative URL construct correctly, so
an alternative is to use a predefined QUISP variable called \fBCGIPROG\fR, like this:
.LP
\fC<a href="@CGIPROG?rtn=home">Home page</a>\fR
.LP
User variables may be appended to the URL like this:
.LP
\fC<a href="?rtn=home&format=long">Home page</a>\fR
.LP


.ig >>
<br><br><br>
.>>
.SH Links to images and other static content 
.LP
\fBHTMLURL\fR
.LP
To reference static files such as images or data sets use constructs such as these:
.LP
\fC<a href="@HTMLURL/tmp/st279573.dat">Download data set</a>\fR
.LP
\fC<img src="@HTMLURL/tmp/hwo79427.png">\fR
.LP
\fBHTMLURL\fR is a variable specifying
the URL location of the directory where your static html, downloadable data, and image files
reside.  It is defined in your project config file.
.LP
See also 
.ig >>
<a href="shell.html#HTMLPATH">
.>>
\0HTMLPATH
.ig >>
</a>
.>>

.ig >>
<br><br><br>
.>>

.SH Links to other pages
Links to other pages are done the normal way, eg.
\fC<a href="ploticus.sourceforge.net/doc/news.html> .. </a>\fR

.ig >>
<br><br><br>
.>>

.SH Special URL variables 
These URL variables may be passed in URLs... and tell QUISP to take the action mentioned:
.LP
\fBrtn=\fIpathname\fR - load the QUISP page script \fIpathname\fR (relative to project dir; no \fC../\fR
constructs are allowed).

.LP
\fB_DEBUG=1\fR - output extra diagnostic info 
.ig >>
<a href="support.html">
.>>
\0(more info)
.ig >>
</a>
.>>
.LP
\fBcontenthtml=0\fR - suppress the automatic HTTP \fCContent-Type: text/html\fR header.. your 
page script must handle all HTTP headers.
.ig >>
<a href="contenttypes.html">
.>>
\0(more info)
.ig >>
</a>
.>>

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="quisp_home.html">
<img src="img/quisp2.gif" border=0></a><br>
<small>quick server pages &nbsp; &nbsp;<br>
<a href="Copyright.html">Copyright Steve Grubb</a> &nbsp; &nbsp;
</td></tr>
</table>
.>>
