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