quisp: links and urls

quick server pages
| Manual page for links(and)

## Links and URLs

## Links to QUISP pages

Every URL involving a QUISP web site should specify the user variable rtn.`` rtn tells QUISP which page script to load, relative to your project's `./pages` subdirectory.`` For example, suppose the "home page" for your site is in the file `home` ...`` Other web sites would link to it using a URL like this:

`<a href="http://abc.com/cgi-bin/quispcgi?rtn=home">Home page</a>`.``

Links between two QUISP pages within the same project can use a construct such as this:

`<a href="?rtn=home">Home page</a>`

Some older browsers don't support the above relative URL construct correctly, so an alternative is to use a predefined QUISP variable called CGIPROG, like this:

`<a href="@CGIPROG?rtn=home">Home page</a>`

User variables may be appended to the URL like this:

`<a href="?rtn=home&format=long">Home page</a>`

## Links to images and other static content

HTMLURL

To reference static files such as images or data sets use constructs such as these:

`<a href="@HTMLURL/tmp/st279573.dat">Download data set</a>`

`<img src="@HTMLURL/tmp/hwo79427.png">`

HTMLURL 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.``

See also HTMLPATH

## Links to other pages

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

## Special URL variables

These URL variables may be passed in URLs... and tell QUISP to take the action mentioned:

rtn=pathname - load the QUISP page script pathname (relative to project dir; no `../` constructs are allowed).``

_DEBUG=1 - output extra diagnostic info (more info)

contenthtml=0 - suppress the automatic HTTP `Content-Type: text/html` header.. your page script must handle all HTTP headers.`` (more info)
quick server pages
Copyright Steve Grubb

Markup created by unroff 1.0, `` `` June 01, 2005.