Parametre programu

Keďže program má použitie aj ako CGI skript (teda internetová aplikácia, ktorá z prehliadača získa údaje vo forme GET, POST alebo zmiešaného URL requestu), ale aj ako program spustiteľný z príkazového riadka (či už v linuxe alebo pod DOS/Windows), parametre sa v niektorých prípadoch rôznia. Je to z toho dôvodu, že command-line verzia často používa jeden parameter v závislosti od ostatných na rôzne účely, avšak pre webovské rozhranie je potrebné, aby každý parameter mal osobitné meno (úvodný formulár napr. potrebuje viacero údajov určujúcich roky). Odlišnosti medzi parametrami pre URL requesty a command-line verziu programu uvádzame na príslušných miestach.

Okrem toho command-line verzia môže byť spustená v tzv. batch móde (dávkové spracovanie), keď pre určité dvoma dátumami ohraničené obdobie vytvorí dávkový súbor (skript), ktorý po spustení generuje modlitby pre dané obdobie. Tento spôsob použitia sa značne líši od ostatných, preto ho popisujeme na osobitnom mieste.

• q | Typ úlohy, ktorú má program vykonať (query type)
  • pdnes | Úvodné okno
  • pdt | Závisí od hodnôt ďalších parametrov
    • ak je zadaný presný dátum (bez modlitby) | Informácie o dni
    • ak je zadaný presný dátum s modlitbou | Konkrétna modlitba
    • ak je zadaný dátum s použitím * | Liturgický kalendár pre daný mesiac alebo pre celý rok
  • pdet | Detaily dňa
  • par | Prikázané sviatky a slávnosti Pána
  • ptab | Tabuľka dátumov pohyblivých slávení
  • plo | Liturgické obdobie (napr. zadáte Adventné obdobie; 2. týždeň; streda)
  • pmr | Liturgický kalendár
  • pbm | Tzv. batch mode (dávkové spracovanie).
  • pxml | XML export liturgického kalendára pre daný deň/mesiac a export jednotlivých options parametrov (zatiaľ experimentálne)
• d | Deň dátumu (pre pdt, pdnes, hodnoty: 1-31, * znamená "všetky dni")
• dvt (pre command line: d) | Deň v týždni (pre pcr, hodnoty: 1-31 resp. pondelok-nedeľa)
• m | Mesiac dátumu (pre pdt, pdnes, hodnoty: 1-12, resp. január-december, * znamená "všetky mesiace")
• mr (pre command line: m) | Mesiac roka (pre pmr)
• r | Rok dátumu (napr. 2000)
• rr (pre command line: r) | Rok (pmr)
• p | Modlitba
  • mi | invitatórium
  • mrch | ranné chvály
  • mpc | posvätné čítanie
  • mpred | modlitba predpoludním
  • mna | modlitba napoludnie
  • mpo | modlitba popoludní
  • mv | vešpery
  • mk | kompletórium
  • mpv | prvé vešpery (len pre niektoré dni/slávenia)
  • mpk | kompletórium po prvých vešperách (len pre niektoré dni/slávenia)
• t | Týždeň žaltára (hodnoty: 1-4) pre pcr
• ds (pre command line: x) | "poradie svätého" (hodnoty: 1-3, niekedy je totiž viacero svätcov na jeden deň, a v takom prípade je možné voliť ktorúkoľvek ľubovoľnú spomienku, resp. 4 pre spomienku Panny Márie v sobotu)
• o0 (pre command line: 0) | možnosť 0 (option 0), špeciálne časti modlitieb
  • 1. bit (1): číslovanie (čísla) veršov v žalmoch, chválospevoch a biblických čítaniach
  • 2. bit (2): biblické referencie na dkc.kbs.sk
  • 3. bit (4): liturgické čítania (odkaz na lc.kbs.sk)
  • 4. bit (8): či sa slávi Zjavenie Pána 6.1. (0 = default) alebo v nedeľu medzi 2. a 8. januárom (1)
  • 5. bit (16): či sa slávi Nanebovstúpenie Pána vo štvrtok (40. deň po Veľkej noci, 0 = default) alebo sa prenáša na nasledujúcu nedeľu (1)
  • 6. bit (32): či sa Najsv. Kristovho Tela a Krvi slávi vo štvrtok, 11.-ty deň po Zoslaní Ducha Sv. (0 == default) alebo v nasledujúcu nedeľu (1)
• o1 (pre command line: 1) | možnosť 1 (option 1), pevné súčasti modlitieb: 0 = nie; 1 = áno
  • 1. bit (1): Te Deum
  • 2. bit (2): rubriky
  • 3. bit (4): evanjeliové chválospevy (Benedictus, Magnifikat, Nunc dimittis)
  • 4. bit (8): Sláva Otcu
  • 5. bit (16): Otčenáš
  • 6. bit (32): doplnková psalmódia pre modlitbu cez deň
  • 7. bit (64): vigílie pre nedele, slávnosti a sviatky (posvätné čítanie)
  • 8. bit (128): brať na spomienky časti zo spoločných častí
  • 9. bit (256): zobraziť plné znenie responzórií (v posvätných čítaniach)
  • 10. bit (512): použiť v modlitbe žalm 95 miesto žalmov 24, 67, 100 (ak sa použili v invitatóriu)
  • 11. bit (1024): zvolanie v prosbách zobraziť (opakovať) po každej prosbe
  • 12. bit (2048): skryť popis (napr. životopis svätca)
  • 13. bit (4096): možnosť zobraziť informáciu o spoločnej časti
  • 14. bit (8192): použiť (pre ktorýkoľvek deň v roku) kratšie prosby k vešperám z dodatku
• o2 (pre command line: 2) | možnosť 2 (option 2), HTML export
  • 1. bit (1): formát dátumu v ISO 8601 formáte (napr. "2011-04-13") alebo iba deň (napr. "13")
  • 2. bit (2): zobraziť pre nedele a vybrané slávenia možnosť priamo v daný deň zvoliť prvé vešpery
  • 3. bit (4): použiť bezpätkové písmo (Sans Serif) alebo pätkové (Serif)
  • 4. bit (8): zobraziť možnosť výberu písma (drop-down list)
  • 5. bit (16): zobraziť možnosť výberu veľkosti písma (drop-down list)
  • 6. bit (32): zobraziť navigáciu v textoch modlitieb (tlačidlá pre jednotlivé modlitby)
  • 7. bit (64): zalamovať dlhé riadky ako v tlačenom vydaní (poetické časti)
  • 8. bit (128): zobraziť buttony pre modlitby v úspornej podobe (tabuľka) kvôli mobilným zariadeniam
  • 9. bit (256): nočný režim (tmavé pozadie, svetlý text)
  • 10. bit (512): zobraziť rozličné možnosti priamo v textoch modlitieb (skryjú sa na úvodnej stránke, budú formou hypertextových odkazov priamo v textoch modlitieb)
  • 11. bit (1024): možnosť zobraziť/skryť navigáciu (tlačidlá) v modlitbe a pre "dnes", ak je zvolený 6. bit
  • 12. bit (2048): skryť kalendárik pre "dnes"
  • 13. bit (4096): skryť "ďalšie možnosti 1" pre "dnes" (na titulnej stránke; nemá vplyv na command-line HTML offline vygenerované texty)
  • 14. bit (8192): skryť "ďalšie možnosti 2" pre "dnes" (na titulnej stránke; nemá vplyv na command-line HTML offline vygenerované texty)
• o4 (pre command line: 4) | možnosť 4 (option 4), HTML export ďalšie
  • 1. bit (1): mesiac jednoducho (default: nie jednoducho, ale HTML pekne pre web) alebo pekne "zložito"
• rfrom (pre command line: f) | Rok, počnúc ktorým sú roky zobrazené v tabuľke pohyblivých slávení (pre ptab)
• rto (pre command line: g) | Rok, do ktorého sú zobrazené roky v tabuľke pohyblivých slávení (pre ptab)
• l (len pre command line) | Možnosť, či zobrazovať hypertextové linky (default: nie)
• e (len pre command line) | Názov súboru, do ktorého sa má exportovať (DOS default: export.htm, linux default: stdout)
• a (len pre command line) | Možnosť, či v prípade existencie súboru pre export do tohto súboru pridávať (teda neprepísať ho – append; default: nie – čiže prepísať)
• j | Jazyk pre odlišné jazykové mutácie (default: sk; ostatné podporované možnosti: cz, c2)
• c | Názov css súboru, ktorý sa má použiť pri generovaní modlitieb (CSS musí pritom spĺňať isté štandardy)
• u (len pre command line) | spôsob zapisovania dátumu pre súbory v batch móde | hodnoty: 0 (simple) alebo 1 (full)
• k (len pre slovenskú verziu) | Kalendár rehoľnej rodiny (saleziáni: sdb, redemptoristi: cssr, ...)
• M (len pre command line) | Možnosti offline HTML exportu (použite hodnoty: 2 alebo 3)

Pre parametre určujúce možnosti majú nasledujúce hodnoty: bitová-hodnota * 1 – áno, 0 – nie (jednotlivé bitové komponenty pre danú option sa sčítajú).

Ak dostane program nesprávne parametre (zahŕňa i prípady nesprávnych hodnôt parametrov alebo ďalšie chýbajúce parametre závisiace od iných parametrov), export obsahuje chybové hlásenie. Naviac, command line verzia vypíše chybové hlásenie na stderr.

Ako zistiť nastavenie jednotlivých parametrov

Spôsob, ako zistiť parametre podľa vašich nastavení v prehliadači, najmä teda pre bitové položky (option 1 až 5). Postupujte takto:

1. Otvorte si úvodnú stránku v samostatnom okne/záložke prehliadača tak, aby ste videli v riadku s internetovou adresou (URL, „address bar“) odkaz zakončený takto: /cgi-bin/l.cgi?qt=pdnes (otvoriť v novom okne/záložke prehliadača).
2. Ponastavujte jednotlivé nastavenia (v časti Voľby vybraných detailov).
3. Stlačte tlačidlo Potrdiť.
4. Stlačte tlačidlo dnes (nachádza sa navrchu stránky, bezprostredne pod hlavným nadpisom, ktorý zodpovedá aktuálnemu dátumu).
5. Všimnite si, že odkaz v riadku s internetovou adresou (URL, „address bar“) sa zmenil; je dlhší. Vyzerá napríklad takto: http://breviar.sk/cgi-bin/l.cgi?qt=pdnes&f=Cambria&s=medium&o0=3&o1=0 (niekedy môže byť ešte dlhší). To, čo obsahuje, sú všetky vami zvolené nastavenia presne tak, ako ste ich zadali. Tento odkaz si uložte medzi „obľúbené adresy“. Používajte ho namiesto štandardného odkazu „Verzia stránok pre mobilné zariadenia (bez rámcov) (napr. pre mobilné telefóny, PDA a pod.)“ z hlavnej stránky internetovej Liturgie hodín.

Príklad: http://breviar.sk/cgi-bin/l.cgi?qt=pdnes&o0=3&o1=4160&o2=760

Odtiaľ vidno, že parameter pre option 0 má hodnotu 3, pre option 1 je hodnota 4160 a pre option 2 hodnotu 760.

Príklady

Ako sa vraví, príklad môže všetky pochybnosti razom odstrániť alebo naopak, podnietiť ďalšie otázky. Za oboma účelmi sú uvedené nasledujúce príkady použitia command-line programu (novšie príklady pre batch mód).

• breviar.exe -qpbm -d1 -m1 -r2013 -f31 -g12 -p2013 -brobSK.bat -jsk -nbreviar.exe -i..\..\breviar.sk\include\ -usimple -M2 -00 -15191 -2224
  Program vytvorí súbor robSK.bat a jednotlivé podadresáre pre celý rok 2013, ide o „šikovnú verziu“ (pozrite nastavenia option 1 = 5191 a option 2 = 224) z download sekcie webstránok. Všimnite si použitie parametra M (hodnota 2) a u (hodnota simple). Potom stačí spustiť tento súbor robSK.bat, ktorý behom niekoľkých minút predgeneruje všetky modlitby na rok 2013 (vrátane stránok obsahujúcich informácie o jednotlivých dňoch a mesiacoch). (Použitie v DOSe/Windows.)
• breviar.exe -qpbm -d1 -m1 -r2013 -f31 -g12 -p2013 -brobCZ.bat -jcz -nbreviar.exe -i..\..\breviar.sk\include_cz\ -usimple -M2 -00 -15191 -2224
  Program vytvorí súbor robCZ.bat a jednotlivé podadresáre pre celý rok 2013, ide o „šikovnú verziu“ pre českú LH (j = cz) z download sekcie webstránok. Potom stačí spustiť tento súbor robCZ.bat, ktorý behom niekoľkých minút predgeneruje všetky modlitby na rok 2013. (Použitie v DOSe/Windows.)
• breviar.exe -qpbm -d1 -m1 -r2013 -f31 -g12 -p2013 -brobSK-sdb.bat -ksdb -jsk -nbreviar.exe -i..\..\breviar.sk\include\ -usimple -M2 -00 -113727 -2120
  Program vytvorí súbor robSK.bat a jednotlivé podadresáre pre celý rok 2013, verzia pre saleziánsku rodinu podľa požiadaviek ich nastavení. (Použitie v DOSe/Windows.)
• ./l.cgi -qpbm -d1 -m1 -r2013 -f31 -g12 -p2013 -brobSK-sdb.sh -ksdb -jsk -n./l.cgi -i../../include/ -usimple -M2 -00 -15535 -2120
  Program vytvorí súbor robSK-sdb.sh a jednotlivé podadresáre pre celý rok 2013, verzia pre saleziánsku rodinu podľa požiadaviek ich nastavení. Pre spustenie je treba pridať práva pre tento súbor (chmod 755 robSK-sdb.sh) a spustiť ho takto: ./robSK-sdb.sh. (Použitie v UNIXe.)

Staršie príklady:

• breviar.exe -qpdt -d30 -m4 -r2002 -pmrch -ic:\breviar\ -emoja.htm -a1
  Program vygeneruje do súboru moja.htm modlitbu ranných chvál na 30. apríla 2002. Ak súbor moja.htm existuje, neprepíše sa, ale program pridá modlitbu na jeho koniec (append). Pritom include adresár sa nachádza v adresári c:\breviar\ (meno programu je breviar.exe). (Použitie v DOSe/Windows.)
• breviar.exe -qpsqs -s"qt=pdt&d=12&m=7&r=2003"
  Program vygeneruje do default súboru (export.htm) rozbor dňa 12. júla 2003. Pritom parametre sú dané simuláciou query stringu.

Ak sa vyskytnú nejaké nezrovnalosti alebo nefunkčnosti, prosím píšte. Command-line verzia je viac-menej experiment. Ďakujem.

Autor programovej časti © 1999-2016 Juraj Vidéky
Všetky práva vyhradené.
Posledná aktualizácia: 2013-01-22
© 1999-2016 Juraj Vidéky