RSS a ich sila - 2. časť

V minulom dieli sme si ukázali, ako sa pristupuje k základným elementom RSS dokumentu, dnes sa pozrieme na štruktúru elementu item.

Vrátim sa späť k minulému príkladu, ten sme zanechali v tejto fáze:

<?xml version="1.0" encoding="UTF-8" ?> 
<rss version="2.0">
    <channel>
         <title>Názov zdroja</title> 
         <link>http://www.programujte.com</link> 
         <description>Náš prvý zdroj</description> 
         <language>sk</language> 
         <copyright>2008 Janko Hruška</copyright> 
         <category>Správy</category> 
         <pubDate>Wed, 15 Oct 2008 18:01:20 +0100</pubDate> 
         <lastBuildDate>Wed, 15 Oct 2008 18:01:20 +0100</lastBuildDate> 
   </channel>
</rss>

Všetky články RSS dokumentu sa ukladajú do elementu item. Počet položiek (item = položka, článok) nie je v nami vybranej špecifikácii (RSS 2.0) nijak obmedzený. Neodporúčam vám však, aby váš zdroj obsahoval priveľa položiek. Väčšina užívateľov nemá veľkú radosť, keď si po dlhšej neprítomnosti zapnú svoj RSS Reader a nájdu v ňom množstvo nových položiek. Ďalším dôvodom je aj to, že mnoho tých správ už môže byť neaktuálnych, teda nie je dôvod ich ďalej nechávať. Zdroj obsahujúci neaktuálne informácie nie je príliš dôveryhodný.

No poďme sa konečne pozrieť na štruktúru elementu item. Tento element obsahuje dva povinné a niekoľko nepovinných argumentov. Povinné sú <title> a <link>, nepovinný zase <description>, <author>, <category>, <comments>, <enclosure>, <guid>, <pubDate>, <source>. Elementy <title>,<link> a <description>, majú rovnakú funkciu ako ich predchodcovia v elemente <channel>, takže teraz môže náš dokument vyzerať takto:

<?xml version="1.0" encoding="UTF-8" ?> 
<rss version="2.0">
    <channel>
         <title>Názov zdroja</title> 
         <link>http://www.programujte.com</link> 
         <description>Náš prvý zdroj</description> 
         <language>sk</language> 
         <copyright>2008 Janko Hruška</copyright> 
         <category>Správy</category> 
         <pubDate>Wed, 15 Oct 2008 18:01:20 +0100</pubDate> 
         <lastBuildDate>Wed, 15 Oct 2008 18:01:20 +0100</lastBuildDate> 
         <item>
               <title>Naša prvá položka</title> 
               <link>http://www.kurzrss.com/prva_polozka</link> 
               <description>Toto je prvá položka nového zdroja!!!</description> 
         </item>
   </channel>
</rss>

Keď vytvoríme RSS zdroj cez nejaký editor, môže sa stať, že text bude umiestnení v CDATA (<description><![CDATA[Náš prvý zdroj]]!></description>). Netreba sa báť. Nejde o chybu, iba niektoré editory majú potrebu uzatvárať text do týchto značiek.

Ďalšími užitočnými prvkami sú elementy <author> a <category>. Prvý odkazuje na autora tejto správy (mimoriadne užitočné, ak sa o udržiavanie dokumentu stará viac ako jeden človek) a druhý na kategóriu. Vo výbere kategórii sa nemusíte obmedzovať na jednu. Je povolených viac položiek, každá však musí mať vlastnú štruktúru (<category></category>). Rozšírme teda element <item> o ďalšie dva prvky:

<item>
	<title>Naša prvá položka</title>
	<link>http://www.kurzrss.com/prva_polozka</link>
	<author>ja@ja.com</author>
	<category>News</category>
	<description>Toto je prvá položka nového zdroja!!!</description>
</item>

Pri zadávaní kategórie nemusíte používať anglické názvy, stretol som sa už aj zo slovenskými (resp. českými) pri domácich stránkach. No pri zdrojoch pre celý svet by som ich asi predsa len uviedol v angličtine (aspoň preklady).

Takisto, veľmi užitočným argumentom je aj <enclosure>. Tento element obsahuje odkaz na niejakú prílohu zdroja. Môže ísť o video, audio, či o obrázok. Štruktúra je nasledovná: <enclosure url=“http://www.kurzrss.com/hudba.mp3“ lenght=“48254“ type=“audio/mpeg“> Značka url odkazuje na súbor, ktorý chcete pridať ako prílohu, lenght na jeho veľkosť v bajtoch a type na typ súboru. Zoznam typov súborov môžete nájsť napr. na wikipedii).

Ďalším veľmi užitočným prvkom pri spolupráci dvoch autorov na jednom zdroji je <guid>. Tento element nám ponúka možnosť vložiť do každého prvku globálny identifikátor. Predstavte si, že dvaja autori náhodou napíšu 2 rôzne články z rovnakým názvom. RSS čítačka pravdepodobne zaindexuje jeden a druhý nenačíta, pretože si bude myslieť, že ho už načítala. S toho celého vyplýva pre nás jedna vec: užívateľ dostane iba jeden článok namiesto dvoch. Tomuto sa dá predísť tým, že použijeme <guid>. Vložiť doňho môžete hocičo (číslo, odkaz na stránku), musí to byť však byť text jedinečný. Preto je najlepšie použiť, nejaké veľké počítačom generované náhodné číslo, alebo odkaz na stránku článku. http://www.kurzrss.com/clanok1.html

Posledným elementom, ktorým sa ja budem zaoberať je <comments>. Tento element obsahuje url adresu na stránku s komentármi pre daný článok.

Teraz to môžeme všetko spojiť do celého RSS dokumentu:

<?xml version="1.0" encoding="UTF-8" ?> 
<rss version="2.0">
    <channel>
         <title>Názov zdroja</title> 
         <link>http://www.programujte.com</link> 
         <description>Náš prvý zdroj</description> 
         <language>sk</language> 
         <copyright>2008 Janko Hruška</copyright> 
         <category>Správy</category> 
         <pubDate>Wed, 15 Oct 2008 18:01:20 +0100</pubDate> 
         <lastBuildDate>Wed, 15 Oct 2008 18:01:20 +0100</lastBuildDate> 
         <item>
               <title>Naša prvá položka</title>
	       <link>http://www.kurzrss.com/prva_polozka</link>
	       <author>ja@ja.com</author>
	       <category>News</category>
	       <description>Toto je prvá položka nového zdroja!!!</description>
               <enclosure url=“http://www.kurzrss.com/hudba.mp3“ lenght=“48254“  type=“audio/mpeg“>
	       <guid>http://www.kurzrss.com/clanok1.html</guid>
	       <comments>http://www.kurzrss.com/clanok1/komentare.html</comments>
          </item>
    </channel>
</rss>

Prešli sme najzákladnejšími elementmi pri tvorbe rss dokumentu. Nie sú však všetky, lebo tento článok nemá byť referenčnou príručkou. Keď si chcete prezrieť všetky tagy odporúčam dokumentáciu

V najbližšom dieli sa pozrieme na to, ako umiestňovať rss-ká na vaše stránky a ako ich vytvárať pomocou editorov.