Videokazety Dokumentace k zápočtovému příkladu z IZI238 Michal Hauzírek

Transkript

1 Videokazety Dokumentace k zápočtovému příkladu z IZI238 Michal Hauzírek

2 Videokazety: Dokumentace k zápočtovému příkladu z IZI238 Michal Hauzírek Vydáno Copyright 2002 Michal Hauzírek

3 Obsah Předmluva... vi 1. Obecně o systému... 1 Základní vlastnosti... 1 Používané soubory Struktura zdrojového dokumentu... 2 Úvod... 2 Údaje o majiteli... 2 Definice možností smazání... 2 Definice typů filmů... 3 Seznam kazet a filmů na nich Převod do XHTML... 7 Použití... 7 Popis stylu... 7 Základní šablona... 8 Šablona prvni_kazety... 9 Šablony odkazy a odkaz Šablony kazeta a film Šablony volno a abc_filmy Převod do XSL-FO Použití Popis stylu iii

4 Seznam tabulek 3.1. Parametry stylu pro převod do XHTML Parametry stylu pro převod do XSL-FO iv

5 Seznam příkladů 2.1. Zápis údajů o majiteli Standardní definice možností smazání Standardní definice typů filmů Kompletní příklad správného zdrojového souboru Text je odkazem pouze při splnění podmínky Základní šablona stylu Kousky kódu ze šablony prvni_kazety Kousky kódu ze šablon odkazy a odkaz Kousky kódu ze šablon kazeta a film Kousky kódu ze šablon abc_filmy a volno Kousky kódu ze stylu pro XSL-FO v

6 Předmluva Tento dokument je dokumentací k systému pro správu videokazet vytvořenému jako zápočtový příklad pro předmět IZI238 Teorie a praxe značkovacích jazyků [ v zimním semestru roku Hlavní motivací k jeho vytvoření byla moje snaha osvojit si základy XML a přidružených technologií a vyzkoušet si jejich použití na praktickém příkladu. vi

7 Kapitola 1. Obecně o systému Základní vlastnosti Celý tento systém slouží ke snadné správě domácí videotéky. Umožňuje udržovat přehled detailních informací o všech videokazetách a samozřejmě také o filmech na nich nahraných. Kromě elementárních údajů jako název filmu, pozice jeho začátku na kazetě a jeho délka jsou to takové údaje jako typ (komedie, sportovní, atd.), jazyk a další (viz kapitolu 2 Struktura zdrojového dokumentu ). Kromě údajů o nahraných filmech jsou uchovávána také data o volném místě na kazetách. Různé výstupní dokumenty generované z jediného zdrojového dokumentu umožňují přehledné zobrazení nebo zpracování dat. V současnosti jsou k dispozici styly pro převod do XHTML, které vytvoří podle zadaných parametrů sadu XHTML stránek, dále styl pro převod do XSL-FO pro vytištěné výstupy a zkušební verze stylu, který vytvoří MySQL-Dump použitelný k importu dat do databáze. Kromě jednoduchého převodu do zobrazitelné podoby dovolují styly pro XHTML a XSL-FO také vygenerovat abecední seznam filmů a přehled volného místa řazený podle délky. Najít jakýkoliv film z videotéky je potom velice snadné, stejně jako najít vhodnou kazetu s prázdným místem požadované délky. Používané soubory Vše je tvořeno následujícími soubory: video.xml zdrojový XML dokument s údaji o videokazetách a filmech video.rng Relax NG schéma na kontrolu struktury a obsahu zdrojového dokumentu video.xsl XSLT styl na převod dokumentu do několika XHTML stran video.css kaskádové styly připojené k vygenerovaným XHTML dokumentům video-fo.xsl XSLT styl na převod dokumentu do XSL-FO pro tištěný výstup ico/ adresář se základními obrázky používanými ve vygenerovaných dokumentech video-sql.xsl zkušební verze XSLT stylu pro převod dokumentu na MySQL-Dump pro import dat do databáze 1

8 Kapitola 2. Struktura zdrojového dokumentu Úvod Veškeré údaje o kazetách se nacházejí v jednom zdrojovém XML dokumentu (video.xml). Jeho struktura je definována pomocí Relax NG [ schématu v souboru video. rng. To, jestli má zdrojový dokument správnou strukturu a odpovídá tomuto schématu, lze zjistit například pomocí validátoru Jing [ takto: jing video.rng video.xml Kořenovým elementem zdrojového dokumentu je element video. Hned prvním vnořeným elementem je datum, který udává datum poslední aktualizace. Datum je ve formátu YYYY-MM-DD. Zbytek zdrojového dokumentu je možné rozdělit na čtyři části údaje o majiteli videotéky (viz Údaje o majiteli ), definici úrovní smazatelnosti filmů (viz Definice možností smazání ), definici typů filmů (viz Definice typů filmů ) a konečně samotný seznam kazet a filmů na nich (viz Seznam kazet a filmů na nich ). Údaje o majiteli Celá tato část je nepovinná. Pokud ji chcete uvést použijte v elementu majitel povinné elementy jmeno a prijmeni. Dále můžete použít (v daném pořadí) volitelné elementy a icq. Význam všech elementů je zřejmý z jejich názvu a příkladu 2.1. Příklad 2.1. Zápis údajů o majiteli <majitel> <jmeno>michal</jmeno> <prijmeni>hauzírek</prijmeni> < >xhaum07@vse.cz</ > <icq> </icq> </majitel> Definice možností smazání U každého nahraného filmu je nožné nastavit jak moc důležitý je (myšleno za jakých okolností se může přehrát něčím jiným). Má to smysl zejména při případném zpracování dat pomocí aplikace, která dynamicky vyhledává souvislé volné místo. Ta může přijímat jako parametr, filmy s jakou úrovní smazatelnosti má ještě považovat za volné místo. Protože takové hodnocení je poměrně subjektivní a každá videotéka může používat vlastní počet i význam stupňů hodnocení, je jejich definice přímo součástí zdrojového dokumentu. Tato část je povinná a musí obsahovat alespoň jednu takovou definici. U každého filmu potom musí být uvedena některá ze zde definovaných hodnot. 1 Samotná definice se provádí v jediném elementu smazatids pomocí několika elementů smazatid. Ty mají jeden atribut id, který musí mít jako svou hodnotu malé písmeno s následované přirozeným číslem. Toto číslo je onou hodnotou, kterou případně zpracovává aplikace (například jako volné místo určí filmy s hodnotou větší než 2). Obsahem elementu smazatid je text popisující danou úroveň (může být zobrazen jako titulek nebo ho může používat aplikace k úpravě uživatelského rozhraní). 1 Protože Relax NG v současné době neumožňuje definovat pravidla pro referenční integritu, je tento jednoduchý případ řešený pomocí datových typů ID a IDREF. Protože je takovýchto referencí použito více druhů (id filmů, typy filmů, smazatelnost ), jsou tyto základní datové typy zúženy. Jejich hodnoty musejí odpovídat šabloně x[0-9]+ (kde x je konkrétní malé písmeno např. f pro jedinečné identifikátory filmů, s pro smazatelnost a t pro typ filmu). 2

9 Při generování statických dokumentů (zejména převodu do XHTML) je možné tyto údaje použít k zobrazení barevně odlišných ikon u filmů. Poznámka Kapitola 2. Struktura zdrojového dokumentu Standardní ikony obsažené v adresáři ico/prehrat jsou určeny pro situaci kterou znázorňuje příklad 2.2. Pokud zvolíte jako hodnoty jiná čísla, bude nutné nahradit i obrázky ve zmíněném adresáři. 2 Příklad 2.2. Standardní definice možností smazání <smazatids> <smazatid id="s1">nikdy nemazat</smazatid> <smazatid id="s2">mazat v nouzi</smazatid> <smazatid id="s3">mazat výjimečně</smazatid> <smazatid id="s5">na zkouknutí</smazatid> <smazatid id="s7">volné místo</smazatid> </smazatids> Definice typů filmů Velice obdobná situace jako při používání smazatelnosti nastává u typů filmů. Každý film má povinně přiřazen jeden z předem definovaných typů. 1 Ty se opět mohou výrazně lišit pro různé uživatele. Co jsou například pro jednoho prostě dva válečné filmy, může druhý rozlišovat na filmy o první a druhé světové válce. Tato část je opět povinná a má velmi obdobnou strukturu jako část pro popis smazatelnosti popsaná výše. Hlavním rozdílem je, že zde musí být v elementu typids definovány alespoň dva typy. Prvním je speciální typ určený výslovně pro volné místo. Ten musí mít identifikátor t0 a musí být uveden na prvním místě. Další typy filmů se definují pomocí elementů typid jak je to zřejmé z příkladu 2.3. Hodnoty atributů id musejí začínat písmenem t a pokračovat číslem. Poznámka Situaci znázorněné v příkladu 2.3 odpovídají také obrázky pro použití v XHTML dokumentech vygenerovaných pomocí standardního stylu. Jsou umístěny v adresáři ico/typy. Pokud se rozhodnete pro vlastní odlišné varianty, bude nutné nahradit i obrázky ve zmíněném adresáři. 2 Příklad 2.3. Standardní definice typů filmů <typids> <typid id="t0">volné místo</typid> <!-- prvni povinna definice pro volne misto --> <typid id="t1">neurčeno</typid> <typid id="t3">akční</typid> <typid id="t4">komedie</typid> <typid id="t5">krimi</typid> <typid id="t6">dokument</typid> <typid id="t7">cartoon</typid> <typid id="t8">historický</typid> <typid id="t9">horror</typid> <typid id="t10">hudba</typid> <typid id="t11">sci-fi</typid> <typid id="t12">sport</typid> <typid id="t13">western</typid> <typid id="t14">film</typid> 2 Obrázky jsou ve formátu GIF s průhledným pozadím a mají velikost 25x25 pixelů. Obrázky pro smazatelnost jsou v adresáři ico/prehrat (obrázek pro typ s1 je 1.gif, pro s2 je 2.gif atd.). Obrázky pro typy filmů jsou v adresáři ico/typy (obrázek pro typ t0 je 0.gif, pro t1 je 1.gif atd.). 3

10 <typid id="t15">home video</typid> </typids> Seznam kazet a filmů na nich Kapitola 2. Struktura zdrojového dokumentu V poslední (a nejrozsáhlejší) části zdrojového dokumentu se už nachází samotné údaje o tom, jaké kazety ve videotéce jsou a co je na nich nahráno. Také tato část je samozřejmě povinná. Celá je uzavřena v elementu kazety, který obsahuje jednotlivé elementy kazeta. Ty musí povinně obsahovat elementy cislo (číslo kazety) a delka (délka kazety v minutách). Kvůli snadnějšímu zpracování pomocí stylů musí být kazety ve zdrojovém dokumentu seřazeny vzestupně podle čísla. Dále následuje jeden nebo více elementů film s jedinečným atributem id (jeho hodnota musí být písmeno f následované číslem). 1 Dalšími (rovněž povinnými) atributy jsou typ a smazat. První z nich obsahuje jednu z hodnot definovaných dříve v elementu typids (viz Definice typů filmů ). Velmi obdobně druhý atribut odkazuje na jednu z hodnot definovaných v elementu smazatids (viz Definice možností smazání ). Obsahem elementu film jsou další povinné i volitelné elementy, které popisují konkrétní film. K těm povinným patří (v daném pořadí) nazev, zacatek a delka. Element nazev obsahuje nečekaně název filmu :). Element zacatek obsahuje číslo udávající vzdálenost začátku filmu od začátku kazety v minutách standardního nahrávání (SP). 3 Další element delka obsahuje délku filmu v minutách standardního nahrávání (tedy polovina délky pro LP). Tento element má povinný atribut LP, který je buď 1 nebo 0 podle toho jestli je nebo není daný film nahrán v režimu LP. Mezi nepovinné elementy u filmů patří (v daném pořadí) jazyk, titulky, datum a imdbid. Jazyk zvuku ve filmu se zapisuje do elementu jazyk, jazyk případných titulků pak do elementu titulky. Obojí má formát dvoupísmenného kódu jazyka podle ISO 639. Předposlední element datum umožňuje u každého filmu zaznamenat datum, kdy byl nahrán (opět ve formátu YYYY-MM-DD). V elementu imdbid lze filmu přiřadit sedmimístné číslo, které má v internetová databázi filmů The Internet Movie Database [ (IMDb). Pomocí tohoto čísla je možné při transformaci do XHTML rovnou k jednotlivým filmům dávat odkazy přímo na informace o nich z tohoto zdroje. Vzhledem k tomu, že je pomocí stylů (a případně aplikací) hojně pracováno také s volným místem, je pro snadnější zpracování potřeba aby i volné místo na kazetě bylo ve zdrojovém souboru zaznamenáno jako specifický typ filmu (typu t0). Tuto kapitolu uzavřeme delším příkladem kompletního a funkčního zdrojového souboru. Příklad 2.4. Kompletní příklad správného zdrojového souboru <?xml version="1.0" encoding="windows-1250"?> <video> <datum> </datum> <majitel> <jmeno>michal</jmeno> <prijmeni>hauzírek</prijmeni> 3 Tuhle trochu šílenou definici hned objasním. Pokud nepoužíváte nahrávání s dvojnásobnou délkou záznamu (ale nižší kvalitou) long play (LP), je to prostě počet minut od začátku kazety k začátku filmu (např. když je na jedné kazetě před filmem A nahraný film B s délkou 1:30, bude zacatek filmu A 90). Když LP používáte, je situace trochu složitější. Můžete totiž samozřejmě na jedné kazetě kombinovat oba způsoby (a to vůbec nemluvím o případu, kdy je kus filmu SP a kus LP). Při používání LP se náš již zmíněný film B o délce 1:30 ve skutečnosti vejde do místa na pásce, která normálně pojme 45 minut záznamu. Video se ale podle údajů na displeji tváří, že pásku v tom místě natáhlo na 1:30. Když ale budete chtít film B přehrát filmem C o délce pouhých 45 minut a budete ho chtít nahrát pro změnu na SP, vejde se tam úplně přesně. Navíc kdyby za filmem B byly nějaké další filmy, tímto jeho přehráním se jejich začátky (podle displeje videa) záhadně posunuly o 45 minut zpátky. Proto tento systém interně používá pro veškeré výpočty délku při standardním nahrávání na SP. Hodnotu elementu zacatek tedy (pokud používáte LP) buď dopočítejte podle údajů na displeji (odečtěte polovinu délky filmů na LP nahraných před), nebo použijte pro vygenerování zdrojového souboru nějakou aplikaci, která pracuje interně také pouze se standardním nahráváním na SP. 4

11 <icq> </icq> </majitel> <smazatids> <smazatid id="s1">nikdy nemazat</smazatid> <smazatid id="s2">mazat v nouzi</smazatid> <smazatid id="s3">mazat výjimečně</smazatid> <smazatid id="s5">na zkouknutí</smazatid> <smazatid id="s7">volné místo</smazatid> </smazatids> <typids> <typid id="t0">volné místo</typid> <typid id="t1">neurčeno</typid> <typid id="t3">akční</typid> <typid id="t4">komedie</typid> <typid id="t5">krimi</typid> <typid id="t6">dokument</typid> <typid id="t7">cartoon</typid> <typid id="t8">historický</typid> <typid id="t9">horror</typid> <typid id="t10">hudba</typid> <typid id="t11">sci-fi</typid> <typid id="t12">sport</typid> <typid id="t13">western</typid> <typid id="t14">film</typid> <typid id="t15">home video</typid> </typids> <kazety> <kazeta> <cislo>1</cislo> <delka>210</delka> <film id="f12" typ="t3" smazat="s2"> <nazev>batman</nazev> <zacatek>0</zacatek> <delka LP="0">117</delka> <jazyk>cs</jazyk> <imdbid> </imdbid> </film> <film id="f14" typ="t3" smazat="s3"> <nazev>cobra</nazev> <zacatek>117</zacatek> <delka LP="0">80</delka> <jazyk>cs</jazyk> <imdbid> </imdbid> </film> <film id="f7" typ="t0" smazat="s7"> <nazev>volno</nazev> <zacatek>197</zacatek> <delka LP="0">13</delka> </film> </kazeta> <kazeta> <cislo>2</cislo> <delka>240</delka> <film id="f175" typ="t11" smazat="s1"> <nazev>matrix</nazev> <zacatek>0</zacatek> <delka LP="0">124</delka> <jazyk>en</jazyk> <titulky>cs</titulky> <datum> </datum> Kapitola 2. Struktura zdrojového dokumentu 5

12 <imdbid> </imdbid> </film> <film id="f176" typ="t7" smazat="s1"> <nazev>south park</nazev> <zacatek>124</zacatek> <delka LP="0">78</delka> <jazyk>en</jazyk> <imdbid> </imdbid> </film> <film id="f158" typ="t0" smazat="s7"> <nazev>volno</nazev> <zacatek>202</zacatek> <delka LP="0">38</delka> </film> </kazeta> <!-- (...) --> </kazety> </video> Kapitola 2. Struktura zdrojového dokumentu 6

13 Kapitola 3. Převod do XHTML Použití Standardní XSLT styl pro převod do XHTML generuje sadu provázaných XHTML stránek. Tento styl je určen pro XSLT procesor Saxon [ ve verzi 6.5. Chování stylu můžete ovlivnit pomocí několika parametrů. Jejich přehled je uveden v tabulce 3.1. Převod provedete takto: saxon [-o vystup.html] video.xml video.xsl ["parametr1=hodnota1" "parametr2=hodnota2"...] Jak již bylo uvedeno, lze ovlivnit podobu vygenerovaného výstupu použitím několika parametrů. Je jich celkem osm a jejich základní přehled poskytuje následující tabulka. Tabulka 3.1. Parametry stylu pro převod do XHTML Parametr Význam Výchozí hodnota stranka maximální počet kazet na jedné stránce 10 mazat zobrazovat ikony pro smazatelnost filmů 0 prazdne zobrazovat i volné místo na kazetách a prázdné kazety 0 volno vygenerovat zvlášť seznam volného místa řazený vzestupně podle délky 1 minvolno minimální délka volného místa v minutách pro zařazení do výše zmiňovaného seznamu filmy vygenerovat zvlášť abecední seznam všech filmů 1 path cesta k adresáři, kam se mají uložit vygenerované soubory. (aktuální adresář) index na standardní výstup vygenerovat stránku, která provede automaticky přesměrování 1 na první vygenerovanou stránku se seznamem kazet a 15 a Styl zpracovává kazety tak, že podle jejich čísla určí, do kterého souboru patří. Protože kazety s některým číslem mohou chybět, existuje teoretická možnost, že soubor s kazetou s nejnižším číslem bude mít jiný název než 001.html. Proto lze tímto způsobem zajistit (např. uložením výstupu do souboru index.html), že bude prohlížeč vždy přesměrován na začátek videotéky. Poznámka Pokud parametrem určíte jiný cílový adresář, bude nutné do něho zkopírovat adresář s obrázky ico/ a soubor s kaskádovými styly styly.css. Popis stylu Na začátku stylu jsou definovány parametry popsané v tabulce 3.1 a klíče sloužící k rychlému přiřazování popisků pro typy filmů a smazatelnost, dále se určí nejmenší a největší číslo kazety pro další výpočty. 4 Kromě toho je tu definováno záhlaví a zápatí, které je společné pro všechny vygenerované stránky. V záhlaví je použito malého triku k vytvoření hypertextového odkazu. Jde o to, že text se má zobrazit vždy ale má být odkazem jenom za určité podmínky (v tomto případě když je uvedena ová adresa). Celý text i s odkazem je uložen do proměnné. Ta je následně při splnění podmínky zavolána funkcí xsl:copy-of, která vrací hodnotu proměnné včetně značkování. Když podmínka splněna není, volá se proměnná funkcí xsl:value-of, která vrací pouze textový obsah proměnné. Stejný způsob je použit například i při generování lišty s odkazy na další stránky, kdy odkaz na aktuální stránku nemá být aktivní. Vše ilustruje příklad Kazety ve zdrojovém souboru jsou seřazeny vzestupně podle čísla takže to není moc složité, ale přesto se to musí udělat s ohledem na parametr prazdne. Tedy vzít v úvahu, že když nechceme pracovat s prázdným místem, musíme úplně ignorovat prázdné kazety (ty které obsahují pouze filmy typu t0). 7

14 Kapitola 3. Převod do XHTML Příklad 3.1. Text je odkazem pouze při splnění podmínky <xsl:variable name="majitel"> Majitel: <a href="mailto:{/video/majitel/ }"> <xsl:value-of select="concat(/video/majitel/jmeno,' ',/video/majitel/prijmeni)"/> </a> </xsl:variable> <xsl:choose> <xsl:when test="/video/majitel/ "> <xsl:copy-of select="$majitel"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="$majitel"/> </xsl:otherwise> </xsl:choose> Tento kus kódu se stará o správné vygenerování jména majitele v záhlaví i s případným odkazem na jeho e- mailovou adresu pokud je uvedena. Pokud bude ve zdrojovém souboru například toto <majitel> <jmeno>michal</jmeno> <prijmeni>hauzírek</prijmeni> < >xhaum07@vse.cz</ > </majitel> vygeneruje styl následující kus kódu. Majitel: <a href="mailto:xhaum07@vse.cz">michal Hauzírek</a> Kdyby ová adresa nebyla uvedena, výstupem bude Majitel: Michal Hauzírek Zbytek stylu si popíšeme po jednotlivých šablonách, které slouží ke konkrétním účelům a postupně se na různé části zdrojového dokumentu volají. Základní šablona Jádrem celého stylu je jediný element xsl:template který má atribut match. (pokud nepočítáme další dva méně významné s atributem match jeden pro generování přesměrovávacího výstupu a druhý pro zamezení automatickému vypisování obsahu elementů). Tento atribut má hodnotu kazety. Nejprve je zkontrolováno, jestli parametr stranka není menší než 2. Potom je pro každý element kazeta volána šablona prvni_kazety s parametrem prev. Ten udává číslo stránky, na kterou patřila předchozí kazeta. Každá kazeta je totiž na stránku umisťována podle svého čísla. Z tohoto čísla se dá při znalosti parametru stranka jistit, na kterou stránku patří bez ohledu na celkový počet kazet a případné díry v číslování. To je důležité zejména pro pozdější tvorbu odkazů na kazety, kdy musí být jasné, na kterou stránku se máme odkazovat. Číslo stránky na kterou patří kazeta se vypočítá takto (aktuálním uzlem je kazeta): floor((number(cislo)-1) div $stranka) +1 Kde $stranka je parametr definovaný na začátku stylu. Pokud bude tento parametr například 10, kazety s číslem 1-10 budou na první stránce (soubor 001.html), kazety s číslem na druhé stránce (soubor 002.html) atd. Když bude tento parametr 15, na třetí stránce budou kazety s čísly v rozmezí Tím starost této šablony o vypsání seznamu kazet končí. Nakonec už jenom zjistí, jestli jsou parametry volno a filmy nastaveny na jedničku a v tom případě se zavolají šablony volno a abc_filmy pro vygenerování seznamu 8

15 Kapitola 3. Převod do XHTML volného místa a abecedního seznamu filmů. O všechno další se postará šablona prvni_kazety a další jí volané šablony. Kompletní výpis kódu této základní šablony je uveden v příkladu 3.2. Příklad 3.2. Základní šablona stylu <xsl:template match="kazety"> <xsl:if test="$stranka < 2"> <xsl:message terminate="yes">parametr stranka musi byt vetsi nez 1</xsl:message> </xsl:if> <xsl:for-each select="kazeta"> <xsl:call-template name="prvni_kazety"> <xsl:with-param name="prev"> <xsl:value-of select="(floor((number(preceding-sibling::kazeta[1]/cislo)-1) div $stranka) +1)"/> </xsl:with-param> </xsl:call-template> </xsl:for-each> <xsl:if test="$volno=1"> <xsl:call-template name="volno"/> </xsl:if> <xsl:if test="$filmy=1"> <xsl:call-template name="abc_filmy"/> </xsl:if> </xsl:template> Šablona prvni_kazety Tato šablona má za úkol hlavně najít kazety, které podle čísla patří na novou stránku, tuto novou stránku vytvořit a zpracovat všechny další kazety, které na ní patří. Že kazeta patří na novou stránku se pozná podle toho, že číslo stránky na kterou patří je větší než číslo stránky na kterou patřila předchozí kazeta (kazety jsou ve zdrojovém souboru seřazeny vzestupně). V takovém případě šablona vytvoří novou stránku a zapíše do ní standardní záhlaví. Zavolá další šablonu odkazy, která se postará o vložení lišty s odkazy na ostatní soubory. Jako další krok je volána šablona kazeta pro aktuální kazetu (tu první na stránce). Dál se uloží do proměnné aktuální číslo stránky (aby se při dalším průchodu neměnilo s kontextem) a potom se prochází a následně opět šablonou kazeta zpracují všechny následující (případně pouze neprázdné) kazety, které patří na stejnou stránku (jejich číslo je nejvýše rovno číslu aktuální stránky krát počtu kazet na stránku). Dolů je opět vložena ještě jedna lišta s odkazy na další soubory a vše je zakončeno vložením zápatí. Zajímavé části z kódu šablony prvni_kazety jsou uvedeny v příkladu 3.3. Příklad 3.3. Kousky kódu ze šablony prvni_kazety <xsl:if test="self::kazeta/cislo=$minimum or $prev < (floor((number(cislo)-1) div $stranka) +1)"> testování, jestli kazeta patří na novou stránku href="{$path}/{format-number((floor( (number(self::kazeta/cislo)-1) div $stranka) +1),'000')}.html" atribut href určující cestu k nově vytvářenému souboru <xsl:variable name="soubor"> <xsl:value-of select="floor((number(cislo)-1) div $stranka +1)"/> </xsl:variable> <xsl:choose> <xsl:when test="$prazdne=1"> 9

16 Kapitola 3. Převod do XHTML <xsl:for-each select="following-sibling::kazeta[number(cislo) <=number($stranka*$soubor)]"> <xsl:call-template name="kazeta"/> </xsl:for-each> </xsl:when> <xsl:otherwise> <xsl:for-each <=number($stranka*$soubor)]"> <xsl:call-template name="kazeta"/> </xsl:for-each> </xsl:otherwise> </xsl:choose> zpracování následujících kazet na stejné stránce (buď všech nebo jenom neprázdných) Šablony odkazy a odkaz Šablona odkazy vytváří lištu s odkazy, která propojuje jednotlivé soubory. Tato lišta se skládá z několika odkazů přímo na stránky s videokazetami, dvou šipek pro pohyb dopředu a dozadu a případně ještě odkazů na seznamy volného místa a abecední seznam filmů. Tato šablona je volána s dvěma parametry s trochu podivnými jmény. První se jmenuje ted a jeho hodnotou je číslo poslední stránky, která bude vygenerována. Hodnota tohoto parametru je během rekurzivního volání šablony odkaz (která se stará o vypsání jednotlivých číselných odkazů) postupně snižována. Když dosáhne čísla první generované stránky (typicky 1), zanořování rekurze skončí a postupně se vypíší odkazy na jednotlivé stránky. Druhý parametr má název tenhle. V tom se uchovává číslo aktuální stránky, pro kterou se lišta zrovna generuje. To je využito jednak ke správnému určení cíle odkazů na šipkách dopředu a dozadu, druhak k tomu, aby text představující v liště aktuální stránku nebyl odkazem. Používá se tu stejný trik s xsl:copy-of a xsl:valueof, jaký byl popsán výše a je znázorněn v příkladu 3.1. V textu odkazů jsou čísla určující rozmezí kazet. Pro jednoduchost se to, jestli kazety s hraničním číslem skutečně existují, zjišťuje a opravuje pouze u první a poslední stránky. Tedy odkaz [ ] ve skutečnosti může ukazovat na stránku, která obsahuje kazety až od čísla 12 či 13 (protože ty s číslem 11 resp. 12 neexistují nebo jsou prázdné). Ovšem jestli jsou minimální a maximální čísla neprázdných kazet 3 a 25, první odkaz bude mít text např. [ 3-10 ] a poslední [ ]. Odkazy na abecední seznam filmů a seznam volného místa jsou tvořeny zvlášť mimo rekurzi. Parametr tenhle pro ně nabývá zvláštních hodnot -1 resp. 0. Výběr zajímavých částí z kódu šablon odkazy a odkaz následuje v příkladu 3.4. Příklad 3.4. Kousky kódu ze šablon odkazy a odkaz <xsl:param name="levasipka"> [<a href="{format-number(number($tenhle)-1,'000')}.html">< <</a>] </xsl:param> <xsl:choose> <xsl:when test="$tenhle > (floor($minimum div $stranka)+1) and $tenhle!=0 and $tenhle!=-1"> <xsl:copy-of select="$levasipka"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="$levasipka"/> </xsl:otherwise> </xsl:choose> Výpis levé šipky, která je odkazem doleva, když je kam doleva jít <xsl:call-template name="odkaz"> 10

17 Kapitola 3. Převod do XHTML <xsl:with-param name="ted"> <xsl:value-of select="$ted"/> </xsl:with-param> <xsl:with-param name="tenhle"> <xsl:value-of select="$tenhle"/> </xsl:with-param> </xsl:call-template> První volání šablony odkaz s původními parametry ze šablony odkazy <xsl:param name="volnoodkaz"> [<a href="volno.html">volno</a>] </xsl:param> <xsl:if test="$volno=1"> <xsl:choose> <xsl:when test="$tenhle!=0"> <xsl:copy-of select="$volnoodkaz"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="$volnoodkaz"/> </xsl:otherwise> </xsl:choose> </xsl:if> Pokud se má generovat seznam volného místa vypíše text [volno]. Když se zrovna generuje lišta s odkazy pro jiný soubor než právě seznam volného místa, bude ten text i odkazem. <xsl:param name="ted"/> <xsl:param name="tenhle"/> <xsl:if test="$ted>(floor($minimum div $stranka)+1)"> <xsl:call-template name="odkaz"> <xsl:with-param name="ted"><xsl:value-of select="number($ted)-1"/></xsl:with-param> <xsl:with-param name="tenhle"><xsl:value-of select="$tenhle"/></xsl:with-param> </xsl:call-template> </xsl:if> Rekurzivní volání sebe sama na začátku šablony odkaz <xsl:param name="cislaodkaz"> [<a href="{format-number($ted,'000')}.html"> <xsl:choose> <xsl:when test="number($stranka*$ted)+1-$stranka < $minimum"> <xsl:value-of select="$minimum"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="number($stranka*$ted)+1-$stranka"/> </xsl:otherwise> </xsl:choose> - <xsl:choose> <xsl:when test="$stranka*$ted > $maximum"> <xsl:value-of select="$maximum"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="number($stranka*$ted)"/> </xsl:otherwise> </xsl:choose> </a>] </xsl:param> <xsl:choose> <xsl:when test="$ted!=$tenhle"> <xsl:copy-of select="$cislaodkaz"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="$cislaodkaz"/> 11

18 Kapitola 3. Převod do XHTML </xsl:otherwise> </xsl:choose> Stanovení textu odkazů na stránky s videokazetami (s kontrolou minima a maxima) a jejich vypsání jako odkazů jestliže by neodkazovaly na aktuální soubor Šablony kazeta a film Šablona kazeta vytvoří po svém zavolání tabulku, která obsahuje číslo kazety spolu s návěštím (to slouží jako cíl pro odkazy na jednotlivé kazety) a vnořené tabulky pro filmy. Ty vytváří šablona film, která je volána buď pro všechny filmy, nebo jenom pro neprázdné v závislosti na hodnotě parametru prazdne. V šabloně film se vytvoří vnořená tabulka a nastaví se jí příslušná hodnota atributu class, která je u volného místa odlišná. Následně se vloží ikonka typu filmu a případně i smazatelnosti. K obrázkům se pomocí volání funkce key s příslušnými parametry (jméno klíče a jeho požadovaná hodnota kód typu filmu resp. smazatelnosti) jako alternativní text a titulek přidají popisy získané z příslušného elementu typid resp. smazatid. Vypíše se samozřejmě i název filmu a k němu se poznamenají případné další údaje že je nahrán na LP, titulky a jazyk když je jiný než český. V dalším sloupci se generuje čas začátku filmu. Počet minut se převede na hodiny a minuty. Ještě předtím se ale čas upraví tak, že se k němu přičte délka všech filmů na stejné kazetě nahraných před aktuálním filmem v systému LP. Tím se dosáhne toho, že údaj o začátku filmu bude souhlasit s údajem, který ukazuje video na displeji (viz také 3 ). Předposledním údajem je délka filmu. Z výše zmiňovaných důvodů se délka filmů nahraných na LP zapisuje do zdrojového souboru v poloviční délce. K výpočtu skutečné délky je použito malého triku, který využívá toho, že se informace zda je film v tomto režimu nahrán, zapisuje hodnotami 0 resp. 1 atributu LP elementu delka. Skutečná délka se pak vypočítá na jednom řádku tímto výrazem. delka*(delka/@lp+1) V úplně posledním sloupci tabulky filmu je pro filmy, které mají záznam v internetové databázi filmů, vygenerován odkaz na tento záznam v podobě ikonky s logem IMDb. Zajímavé úryvky kódu z těchto dvou šablon jsou opět uvedeny v příkladu 3.5. Příklad 3.5. Kousky kódu ze šablon kazeta a film <xsl:choose> <xsl:when test="$prazdne=1"> <xsl:for-each select="film"> <xsl:call-template name="film"/> </xsl:for-each> </xsl:when> <xsl:otherwise> <xsl:for-each select="film[@typ!='t0']"> <xsl:call-template name="film"/> </xsl:for-each> </xsl:otherwise> </xsl:choose> Volání šablony film pro všechny nebo jenom neprázdné filmy <table> <xsl:choose> <xsl:when test="@typ='t0'"> <xsl:attribute name="class"> film-table-prazdny </xsl:attribute> </xsl:when> <xsl:otherwise> 12

19 Kapitola 3. Převod do XHTML <xsl:attribute name="class"> film-table-normal </xsl:attribute> </xsl:otherwise> </xsl:choose> Volba hodnoty atributu class podle toho, jestli se jedná o volné místo <xsl:variable name="tid"><xsl:value-of select="@typ"/></xsl:variable> <img width="25" height="25" src="./ico/typy/{substring(@typ,2)}.gif" alt="{key('key_typ',@typ)}" title="{key('key_typ',@typ)}"/> Vložení ikony typu filmu společně s příslušným popisem získaným z elementu typid získaný pomocí funkce key... <xsl:key name = "key_typ" match = "/video/typids/typid" use = "@id"/>... a definování tohoto klíče na začátku souboru <xsl:variable name="posun"> <xsl:value-of select="sum(preceding-sibling::film/delka[@lp=1])"/> </xsl:variable> <xsl:value-of select="floor(number(zacatek+$posun) div 60)"/> : <xsl:value-of select="format-number(number(zacatek+$posun) mod 60,'00')"/> Výpočet času začátku a jeho převedení na hodiny a minuty <xsl:value-of select="floor(number(delka*(delka/@lp+1)) div 60)"/> : <xsl:value-of select="format-number(number(delka*(delka/@lp+1)) mod 60,'00')"/> Výpočet délky filmu a její převedení na hodiny a minuty Šablony volno a abc_filmy V těchto šablonách už není mnoho nového, obě většinou využívají výše zmíněných konstrukcí a obratů. Starají se, jak je z názvu patrné, o vygenerování souborů se seznamem volného místa a abecedním seznamem filmů. Obě opět nejprve vypíší společné záhlaví včetně lišty odkazů. Potom následuje vypsání tabulek příslušnými údaji. V závěru se vypíše společné zápatí. U seznamu volného místa se vypíše každé volné místo (film typu t0), které má minimálně tolik minut, jako je nastaveno v parametru minvolno. Kromě délky se vypisuje také to, kde na kazetě začíná (podobně jako začátek u filmů) a na které kazetě se nachází (včetně odkazu na ni). Volné místo je seřazeno vzestupně podle délky. V abecedním seznamu filmů se kromě názvu filmu (případně jazyka a titulků) vypisuje také jeho začátek na kazetě a číslo kazety s odkazem na ni. V příkladu 3.6 jsou opět některá zajímavá místa z těchto šablon. Příklad 3.6. Kousky kódu ze šablon abc_filmy a volno <xsl:for-each select="/video/kazety/kazeta/film[@typ='t0' and delka >= $minvolno]"> <xsl:sort select="delka" data-type="number"/> <xsl:sort select="parent::kazeta/cislo" data-type="number"/> Výběr odpovídajícího volného místa a jeho seřazení podle délky (a potom podle čísla kazety) <a href="{format-number((floor((number(parent::kazeta/cislo)-1) div $stranka) +1),'000')}.html#kazeta{parent::kazeta/cislo}"> 13

20 Kapitola 3. Převod do XHTML Odkaz na kazetu, na které se dané volné místo nachází <xsl:for-each <xsl:sort select="nazev"/> Výběr neprázdných filmů a jejich seřazení podle abecedy 14

21 Kapitola 4. Převod do XSL-FO Použití Na rozdíl od stylu pro XHTML není styl pro XSL-FO svázán s žádným XSLT procesorem. Pro převod tedy můžete použít libovolný XSLT procesor, ale pro práci s výsledným dokumentem budete potřebovat nějaký FO procesor. Můžete použít například XSL Formatter [ který umožňuje FO dokumenty zobrazovat na obrazovce, převádět například do PDF (ve verzi 2.3 už dokonce standardně i s kompletními českými fonty a českým dělením slov) a nebo přímo vytisknout na tiskárně. Při použití jeho řádkového rozhraní může přímý tisk na tiskárnu vypadat třeba takto: axfocmd -d video.xml -s video-fo.xsl [-param "parametr1=hodnota1" "parametr2=hodnota2"...] a vygenerování PDF takto: axfocmd -d video.xml -s video-fo.xsl -o vystup.pdf Stejně jako u stylu pro XHTML je i u stylu pro XSL-FO k dispozici několik parametrů, které ovlivňují jeho chování. Jejich přehled je uveden v tabulce 4.1. Tabulka 4.1. Parametry stylu pro převod do XSL-FO Parametr Význam Výchozí hodnota kazety vygenerovat seznam videokazet a filmů na nich 1 filmy vygenerovat abecední seznam filmů 1 volno vygenerovat seznam volného místa řazený vzestupně podle délky 1 minvolno vybarvit Popis stylu minimální délka volného místa v minutách pro zařazení do výše zmiňovaného seznamu vybarvit šedivě všechny tabulky kazet a použít v seznamech filmů a volného místa pruhovaný design Tento styl je mnohem jednodušší než XTML styl, proto i jeho popis bude znatelně kratší. Na začátku jsou opět definovány parametry a dvě rozvržení stránek (simple-page-master). Jedno (běžné) je použito pro seznam videokazet, druhé (se dvěma sloupci na stránce) se používá jak pro seznam volného místa, tak pro abecední seznam filmů. Postupně jsou vytvořena příslušná záhlaví a zápatí a zavolány šablony zpracovávající vlastní obsah stránek (kazety, filmy, volno). Všechna záhlaví mají jednotný ráz a je na nich kromě jména majitele uvedeno i datum platnosti seznamu a v levém rohu také aktuální sekce ( Seznam kazet, Abecední seznam filmů, Volné místo ). V záhlaví stránek se seznamem videokazet je navíc ještě rozmezí čísel kazet, které jsou na dané stránce zobrazeny. Toho je dosaženo použitím elementů marker s atributem marker-class-name u každé kazety a retrieve-marker s atributy retrieve-class-name a retrieve-position v záhlaví. Pro jednotlivé kazety jsou v šabloně kazety vytvořeny tabulky. Aby se zabránilo lámání stránek uvnitř tabulky mezi jednotlivými filmy (aby jedna kazeta byla celá zobrazena na jediné stránce), je použito hodnoty avoid atributu page-break-inside. Pro filmy je v zápětí zavolána šablona film. Ta pracuje téměř shodně jako její větší setřička z XHTML stylu. Nevytváří však žádné ikonky a ani odkaz do IMDb, který by na tištěném médiu neměl valný smysl. Abecední seznam filmů funguje téměř stejně jako v XHTML stylu. Snad jedinými (a pochopitelnými) rozdíly jsou absence odkazů do seznamu videokazet a to, že je celý seznam proveden ve dvou sloupcích na stránku

22 Kapitola 4. Převod do XSL-FO Navíc je možné pomocí parametru vybarvit sdělit stylu, že si přejete seznam pruhovaný (liché řádky budou šedivé). Vše co bylo napsáno o abecedním seznamu filmů platí i o seznamu volného místa. Ten má navíc ještě jednu změnu oproti XHTML stylu zaškrtávací políčko. Aby se šetřily lesy, můžete po přehrání konkrétního prázdného místa toto políčko zaškrtnout a používat stejný výtisk seznamu dál s tím, že víte, že tohle volné místo už není volné :). Poznámka Jako zaškrtávací políčko je vkládán obrázek box.png z adresáře ico/. Jestliže přesunete styl jinam, přesuňte s ním i tento obrázek. Pokud chcete vytvořit obrázek vlastní, je ve formátu PNG o velikosti 13x14 pixelů. Protože se vkládá (při použití pruhovaného seznamu) střídavě na šedivou a bílou barvu, je vhodné u něho nastavit určitý stupeň průhlednosti. Několik zajímavých fragmentů z kódu XSL-FO stylu najdete v příkladu 4.1 Příklad 4.1. Kousky kódu ze stylu pro XSL-FO <fo:layout-master-set> <fo:simple-page-master master-name="normal" page-height="297mm" page-width="210mm" margin-top="10mm" margin-bottom="5mm" margin-left="10mm" margin-right="10mm"> <fo:region-body margin-top="5mm" margin-bottom="15mm" margin-left="0mm" margin-right="0mm"/> <fo:region-before extent="10mm"/> <fo:region-after extent="10mm"/> </fo:simple-page-master> <fo:simple-page-master master-name="sloupce" page-height="297mm" page-width="210mm" margin-top="10mm" margin-bottom="5mm" margin-left="10mm" margin-right="10mm"> <fo:region-body margin-top="5mm" margin-bottom="15mm" margin-left="0mm" margin-right="0mm" column-count="2" column-gap="5px"/> <fo:region-before extent="10mm"/> <fo:region-after extent="10mm"/> </fo:simple-page-master> </fo:layout-master-set> Nastavení dvojího rozložení stránky normálního a se sloupci kazety od <fo:retrieve-marker retrieve-class-name="cislo_kazety" retrieve-position="first-starting-within-page"/> do <fo:retrieve-marker retrieve-class-name="cislo_kazety" retrieve-position="last-starting-within-page"/> Vypsání čísla první a poslední kazety na stránce v záhlaví... <fo:marker marker-class-name="cislo_kazety"> <xsl:value-of select="cislo"/> </fo:marker>... a marker, který to umožňuje a který je u každé tabulky s kazetou <xsl:if test="$vybarvit=1 and position() mod 2 = 1"> <xsl:attribute name="background-color">#dddddd</xsl:attribute> </xsl:if> Šedivé pruhování seznamů, pokud je povoleno parametrem vybarvit 16