Combo / cgi

[..] [files]

This directory contains the CGI scripts that comprise the Combo community website operating software.

Annotated Contents

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. Allows most operations on files in a collection to be done by making requests to the collection.
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. Can be used stand-alone (=== after some more work ===). Implements a useable, if spartan, WebDAV server. Essentially the same as edit except that it does not use the Combo type classes, and so presents the same boring interface to everything. Does not allow previews.
Admin/
Site administration tools are in the Admin/ subdirectory.
Copyright © 2002-2003 PenguinSong $Id: HEADER.html,v 1.4 2003/05/09 19:32:14 steve Exp $ 
      Name                    Last modified      Size  Description
      Parent Directory                             -   
      CVS/                    24-Nov-2004 18:11    -   
      HEADER.inc              01-Jul-2003 08:17  2.7K  
      Makefile                13-May-2002 23:35  294   
      comment.cgi             25-Nov-2002 07:52  2.8K  
      dir-index.cgi           01-Jul-2003 08:17  7.0K  
      edit.cgi                01-Jul-2003 08:17  7.0K  
      file.cgi                24-Nov-2004 18:11   26K  
      login.cgi               23-Nov-2002 08:12  7.5K  
      preview.cgi             25-Nov-2002 07:52  2.3K  
      process.cgi             01-Jul-2003 08:17  2.8K  
      register.cgi            04-May-2003 15:14  5.6K  
      view.cgi                01-Jul-2003 08:17  2.9K