TheWay is a set of Perl scripts which perform the functions of linking web sites together in a ring or loop. Although currently the scripts are only used to run the Infinite Fractal Loop, they are designed to support an arbitrary number of rings from a single server.
         Commands for TheWay are constructed by referring to the base URL for the script and adding parameters and a command to the end. Parameters are separated from each other and from the command by semicolons (;) and from the base URL by a question mark (?). Three scripts are currently used:

http://www.fractalus.com/cgi-bin/theway
This is the basic navigation script. All commands used to move from site to site must be directed to this script.

http://www.fractalus.com/cgi-bin/theway.admin
This is the administration script, used to add and remove sites from the ring and its associated queue, and to edit information for sites. This script will rarely be accessed directly; normally it will be used from a form.

http://www.fractalus.com/cgi-bin/theway.stats
This script parses the ring's log and tabulates statistics for the ring. It has no other function.

General Parameters

ring=<ringname> 
This parameter is required for all commands. It specifies which ring to apply the command to. <ringname> specifies the name of the ring to use. Currently, only one ring (the Infinite Fractal Loop, name "fractals") is in use.

id=<siteID> 
This parameter is required for all commands which refer to a specific site. <siteID> is the numerical site ID for the site originating the request (or, in the case of the go command, the destination site).

Navigation Commands

next 
This command moves to the next site in the ring, wrapping at the end to the first site. "Next" is determined by listing order in the ring's database, not by numerical site ID, so sites can be in any order.

prev 
This command moves to the previous site in the ring, wrapping at the beginning to the last site. "Previous" is determined by listing order in the ring's database, not by numerical site ID, so sites can be in any order.

skip 
This command moves to the site after the next site in the ring, skipping the next site.

sprev 
This command moves to the site before the previous site in the ring, skipping the previous site.

next5 
This command displays a page listing the next five sites in the ring, wrapping at the end. The appearance of this listing is governed by a template, not by the script itself.

prev5 
This command displays a page listing the previous five sites in the ring, wrapping at the beginning. The appearance of this listing is governed by a template, not by the script itself.

random 
This command moves to a random site in the ring. A site ID is required, to insure that the site originating the request is not selected at random.

go 
This command moves directly to the site whose ID is provided. Using the script to find the URL means that the link does not have to be changed if the site moves (as long as the ring database is updated).

list 
This command lists all the sites in the ring. A site ID is not required, but will be logged if it is provided. The appearance of this listing is governed by a template, not by the script itself.

queue 
This command lists all the sites in the waiting queue for the ring. A site ID is not required, but will be logged if it is provided. The appearance of this listing is governed by a template, not by the script itself.

index 
This command lists all the sites in the ring. It is similar to list, but it uses a different template. It is intended as a more detailed listing of sites. A site ID is not required, but will be logged if it is provided. The appearance of this listing is governed by a template, not by the script itself.

qindex 
This command lists all the sites in the ring's queue. It is similar to queue, but it uses a different template. It is intended as a more detailed listing of sites. A site ID is not required, but will be logged if it is provided. The appearance of this listing is governed by a template, not by the script itself.

home 
This command jumps to the ring's home page. A site ID is not required, but will be logged if it is provided.

help 
This command jumps to the ring's help page. A site ID is not required, but will be logged if it is provided.

join 
This command jumps to the ring's sign-up page. A site ID is not required, but will be logged if it is provided.

Administration Commands

Currently undocumented.

Statistics Commands

Currently undocumented.

         Back to the IFL home

 

Copyright © 1997-99 Damien M. Jones