aegis.cgi(1)

NAME
aegis.cgi - Aegis web interface script

SYNOPSIS
aegis.cgi

DESCRIPTION
The aegis.cgi command is used to interface between a web server and Aegis.

  Deprecated
This scripts is DEPRECATED since a long time and has been removed from the distribution as of aegis-4.24.1. The preferred way to publish an aegis repository on the Web is using aeget(1).

  Installation
If you have a Web server, you may like to install the Aegis web interface. You do this by copying the aegis.cgi script from /aegis.cgi into your web server's cgi-bin directory. There is an aegis.cgi.i helper script, if you don't know where your web server's cgi-bin directory is.

You may prefer to use a symbolic link, as this will be more stable across Aegis upgrades. However, this requires a corresponding follow-symlinks setting in your web server's configuration file. (Use the aegis.cgi.i -s option.)

Within the aegis.cgi script, you may set the AEGIS_PATH environment variable, if you want it to be able to see more projects than just the global projects. You do this by creating a /usr/local/lib/aegis.cgi.conf file (there isn't one, by default) and setting the AEGIS_PATH environment variable in it. This is a fragment of Bourne shell script, not just the name.

  Usage
Once installed, it should be possible to see the project list by following this URL:
    http://localhost/cgi-bin/aegis.cgi?
You may need to replace localhost with the machine's exact name.

  Cascading Style Sheets
The web interface uses Cascading Style Sheets. You can give the web interface a personalised look and feel, by creating stylesheets in the web server's Document Root directory. The interface will use it's default styles, then styles from a global style sheet called aedefault.css, and then styles from a project stylesheet called projectname.css (replace projectname with the name of the project).

There is an example style sheet in /aedefault.css which demonstrates the style elements used. This particular stylesheet is not designed to be aesthetically pleasing, but to exercise all of the elements. Using this stylesheet unmodified will give psychedelic results. Use it as a template.