1Contents
2--------
3
4	1. Using uprecords as CGI program
5	2. Configuring the output of uprecords as CGI program
6	3. Inserting the output of uprecords into existing pages
7
81. Using uprecords as CGI program
9---------------------------------
10
11Copy the uprecords binary to your CGI directory and rename it:
12
13	cp uprecords /www/cgi-bin/uprecords.cgi
14
15Uprecords will automatically recognize it is being run as CGI program by
16it's .cgi filename and add the necessary Content-type header and some HTML
17tags.
18
192. Configuring the output of uprecords as CGI program
20-----------------------------------------------------
21
22When run as CGI, uprecords.cgi checks for a file called uprecords.conf in
23the current (= cgi-bin) directory. This configuration file allows you to
24control the way uprecords.cgi will look.
25
26LAYOUT can be any of "pre", "list", or "table". "pre" uses the <pre> tag to
27create output close to that of running uprecords from the console and is the
28default option. "list" creates a list using the <ul> and <li> tags and
29"table" creates a table using the <table>, <tr> and <td> tags.
30
31SHOW_MAX defines how many entries should be shown at maximum.
32
33If the file uprecords.header is present, it will be printed before the
34output. You can use this to create the most smashing looks, from a simple
35<body> tag to change to background colour to a comprehensive page including
36all the latest CSS style-sheets. If the file uprecords.footer is present, it
37will be printed after the output.
38
39There are some sample files in the sample-cgi/ directory of this package.
40
413. Inserting the output of uprecords into existing pages
42--------------------------------------------------------
43
44You can include the output within existing HTML pages to get the same
45lay-out as the rest of your site using server-side includes, PHP, etc.
46
47Example tags to put within your pages:
48
49SSI:	<!--#include virtual="/cgi-bin/uprecords.cgi"-->
50PHP:	<? virtual("/cgi-bin/uprecords.cgi"); ?>
51
52For more information on SSI, read the Apache manuals (if Apache is your
53webserver) or contact your Internet Service/Presence Provider. For more
54information on PHP, visit http://www.php.net/
55