                                                                     steve 2006
								      fous 2008

                            REKLAMA NA KIOSCICH
                            ===================

  Graficke soubory patricnych formatu umistene v tomto adresari jsou promitany
jako sporice obrazovky na jednotlivych kioscich.

  Od verze kiosku 2.1 lze vhodnym pojmenovanim souboru s obrazkem dosahnout
cileni reklamy dle konkretniho kiosku nebo lokality a zaroven urcit prioritu
daneho obrazku vzhledem k ostatnim existujicim.

  Syntaxe pojmenovani souboru
  ===========================
  
  <jmeno>[:<cil>[:<priorita>[:<datum>]]].<koncovka>
  
  * `jmeno' je libovolny identifikator, slouzi pro popis souboru
  * `cil' je specifikace ciloveho kiosku/lokality (viz dale)
  * `priorita' urcuje vahu daneho souboru oproti ostatnim (viz dale)
  * `datum' je posledni den, ktery se ma reklama zobrazovat (viz dale)
  * `koncovka' je pripona typu souboru, podporovany jsou nasledujici pripony:
       - gif
       - pjpg, pjpeg, jpeg, jpg
       - png
       - tiff
       - xbm
       - xpm

  Cil i priorita muze byt vynechan (soubor tedy tuto syntaxi nemusi respektovat
a byt pojmenovan zcela libovolne), v takovem pripade se pouzije defaultni cil a
priorita (viz dale).

  Specifikace cile
  ================
  
  Zadanim pilozky `cil' v pojmenovani souboru s obrazkem lze urcit konkretni
kiosek (skupinu kiosku, resp. oblast), na nemz ma byt tento obrazek promitan.

  Hodnotou polozky cil je bud `pojmenovana skupina' (viz dale) nebo regularni
vyraz zahrnujici hostname (bez domeny) ciloveho kiosku. Tim lze specifikovat
cil reklama od jednotlivych kiosku po jejich skupiny.

  Misto hostname lze ve specifikaci cile uvest pojmenovanou skupinu. Tou je
skupina kiosku (typicky sdruzenych podle lokality) definovana v souboru
/afs/.zcu.cz/public/kiosky/firefox/etc/location. Format tohoto souboru je
nasledujici:
     - kazdy zaznam na jednom radku
     - vse za znakem # je komentar
  zaznam ma syntaxi: <location_id>:<host_1>[,<host_2>[,...]]
     - location_id je pojmenovani, kterym se lze na danou skupinu odkazovat
     - host_n je hostname daneho kiosku; lze pouzit regularni vyraz pro
       zjednoduseni zapisu (napr. pro skupinu `all' by misto kompletniho vyctu
       stacilo zapsat .*

  Pri vynechani cile bude obrazek zobrazen na vsech kioscich.

  Priklady specifikace cile
  -------------------------
  
  obrazek:ui423p03-lps.jpg	- zobrazi se jen na ui423p03-lps
  plakat:kiosek-ep.*.png	- zobrazi se na vsech kioscich v EP
  soutez:fel.png		- `fel' je pojmenovana skupina kiosku ze
				  souboru location; zobrazi se jen na nich

  Stanoveni priority
  ==================
  
  Kazdemu obrazku lze urcit prioritu s jakou bude na cilovem kiosku promitan
vzhledem k ostatnim obrazkum. Prioritu predstavuje cislo v rozsahu <1,99>;
vyssi cislo znamena vyssi prioritu. Neni-li u obrazku priorita uvedena, je
pouzita vychozi priorita 20. Ma-li obrazek prioritu 0, neni zobrazovan vubec 
(stejne tak je-li nastavena priorita > 99).

  Priklady stanoveni priority
  ---------------------------
  
  vychozi::1.png
  soutez.png
  dulezite::40.png
  
  Tvori-li tyto tri soubory kompletni playlist pro dany kiosek, budou promitany
s relativni cetnosti default : soutez : dulezite  ==> 1 : 20 : 40.

  Vyprseni reklamy
  ================

  Do nazvu souboru je moznost pridani datumu vyprseni. Po tomto datumu nebude
na kiosku dana reklama dale zobrazovana. Datum je nutno zadat ve formatu

	rrmmdd

  tento format generuje napriklad prikaz `date +%y%m%d`.
  Pokud neni datum zadan, je obrazek zobrazovan stale.
  Podminka pro zobrazeni je

  	$date >= $today

  Priklady 
  --------

  reklama:fel:7:080314.jpg


