Stepan Roh's Toplist 0.1 (c)2000,2001 Štěpán Roh
------------------------------------------------

CGI skript toplist.pl slouží k sestavování žebříčků získaných z CGI skriptů
counter.pl a ratings.pl. Používá se ve spojení s SSI (přes direktivu
#include).

Může mít dva parametry: profile určuje jméno uživatelského profilu (s kterým
je spojeno jméno konfiguračního souboru), není-li uveden, pak v případě, že
dokument odkazuje na uživatelský web (~user), bere se soubor .httoplist v
adresáři WWW daného uživatele, jinak se bere profil jménem global. Parametr
item určuje jméno položky.

Konfigurační soubor má řádky formátu jméno položky::typ::datový
soubor::řazení::klíč řazení::počet::mapovací soubor::šablona. Řádky a
položky začínající na '#' se ignorují.

Typ je jeden z counter nebo ratings a určuje typ datového souboru, což je
cesta k k datovému souboru příslušného CGI skriptu.

Řazení je buď asc pro vzestupné nebo desc pro sestupné. Klíč řazení je name
pro řazení dle názvu, value pro řazení dle počtu přístupů (typ counter) nebo
dle ohodnocení (typ ratings), a nebo votes pro řazení dle počtu hlasujících
(typ ratings).

Počet může být -1 pro zobrazení všech nebo nějaké kladné číslo jen pro
zobrazení prvních několika.

Mapovací soubor je cesta k souboru s řádky ve tvaru položka::název, který
slouží k překladu ze jména položek v datovém souboru na lidsky čitelný
název.

Šablona je lib. řetězec, ve kterém jsou pro každou položku výstupu nahrazeny
některé sekvence znaků a který je poté zobrazen. Nahraditelné sekvence jsou
%p (pozice položky ve výstupu číslované od jedné), %n (název položky), %v
(počet přístupů (typ counter) nebo ohodnocení (typ ratings)), %t (počet
hlasujících (typ ratings)), \n (znak nového řádku).

Příklady použití :

<table border="1">
<caption>Top 5</caption>
<tr><th>Position<th>Name<th>Visitors
<!--#include virtual="/cgi-bin/toplist.pl?item=counters" -->
</table>

Nakonec příklad souboru .httoplist:

counters::counter::/home/stepan/WWW/.htcounter::desc::value::5::/home/stepan/WWW/.httoplist.map::<tr><td>%p.<td>%n<td>%v\n

						Štěpán Roh <src@post.cz>