This directory contains the CGI scripts that implement a Combo community website. Following each link will cause the script to serve you its full documentation.

Resource Management

A ``resource'' is either a file or a ``collection'' -- a directory. All of these utilities use the same formatting ``engine'' to convert resources to viewable HTML; the main differences is in how they are invoked, and what they do with the formatted result.

All of the following are normally invoked by appending the URL-path of the resource to be operated on to the URL-path of the script, e.g., /Ccgi/view/path/to/page.ht

comment
Add a comment to an existing page. This is done by appending the comment to a separate ``comments'' page.
edit
Edit a file or directory using a web form appropriate to its type.
preview
Preview a resource after uploading or editing it. Essentially the same as view.cgi except that it provides controls for
process
Preprocess a resource that is normally formatted to HTML on-the-fly (with view.cgi) so that it can be served more efficiently.
view
Process (format) a resource to HTML and serve the result.

Handlers

Unlike the resource-management scripts, these handlers are normally invoked invisibly by the web server in response to requests made directly to the resource in question.

dir-index
Handle a web request (GET or POST) directly to a directory.
not-found
Produce ordinary directory indices. [Actually this ought to be done by view.cgi.]

Account Management

login
Log in (or log out)
register
Register (create an account)

Site Administration

file
Perform file management operations including downloading (without any of the usual server-side processing), uploading and editing.
Admin/
Site administration tools are in the Admin/ subdirectory.