Name

aeget — Aegis CGI file access

Synopsis

aeget

DESCRIPTION

The aeget command is used with Apache (or CGI conforming any other web server) to access the files of an Aegis project. The files are searched for along the appropriate search path, including all ancestor baslines, not just the baseline of the branch.

This is useful when developing web sites using Aegis.

Install

In order to use aeget(1), you need to copy it into your cgi-bin directory.

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.

Usage

Once aeget(1) is installed, files may be accessed via

If no project name is given, a list of projects will be generated. This will lead you through a series of menus, giving access to manu useful pages of information about your projects.

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 /opt/aegis/bin/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.

PROJECT ATTRIBUTES

You can set your own project specific page headers and footers by using the "html:meta", "html:body-begin" and "html:body-end" project specific attributes.

 
project_specific =
[
  {
    name = "html:body-begin";

value = "<i>This text goes immediately after the <BODY> and before any text generated by <i>aeget</i>(1).</i>";


  },
  {
    name = "html:body-end";

value = "<i>This text goes immediately before the </BODY> and after all text generated by <i>aeget</i>(1).</i>";


  },
];

These fields may be used to customize your web pages for your project-specific or company-specific needs. Each project is configured independently.

CHANGE ATTRIBUTES

If you wish to prevent a change set appearing in the change set inventory used by aedist -replay to determine what needs to be downloaded, set the following change set attribute:

 
attribute =
[
  {
    name = "aeget:inventory:hide";
    value = "true";
  },
];

You must use the aeca(1) command for this, the tkaeca(1) command can not edit change set attributes.

COPYRIGHT

aeget version 4.22 Copyright (C) 1991-2006 Peter Miller; All rights reserved.

The aeget program comes with ABSOLUTELY NO WARRANTY; for details use the 'aeget -VERSion License' command. This is free software and you are welcome to redistribute it under certain conditions; for details use the 'aeget -VERSion License' command.

AUTHOR

Peter MillerE-Mail:millerp@canb.auug.org.au
/\/\*WWW:http://www.canb.auug.org.au/~millerp/