#set TITLE = "links and URLs"
#include top

.SH Links and URLs

#include space2

.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


#include space
.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 
#set FILE = "shell.html#HTMLPATH"
#set TAG = "HTMLPATH"
#include link

#include space

.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

#include space

.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 
#set FILE = "support.html"
#set TAG = "(more info)"
#include link
.LP
\fBcontenthtml=0\fR - suppress the automatic HTTP \fCContent-Type: text/html\fR header.. your 
page script must handle all HTTP headers.
#set FILE = "contenttypes.html"
#set TAG = "(more info)"
#include link

#include bottom
