Moram vam priznati nešto, već par dana razmišljam kako da počnem sa pisanjem svog prvog uputstva, koje će imati hronološki i edukativno smisla a da ne budem dosadan. Trema ili šta god me je blokirala, i nisam u stanju da počnem nekim redosledom; pa sam rešio da počnem, pa će se vremenom pokazati kojim redosledom da poslažem priloge. Ako ništa drugo menjanje sadržaja na webu mi bar nije problem.
"Ručno" napravljen RSS 2.0 feed
Od "alata" vam je potreban samo text editor ( notepad ili Vim - ako koristite Linux ) minut za čitanje i dva minuta pisanja.
Primer minimalnog RSS 2.0 feeda:
| <?xml version="1.0"?> <rss version="2.0"> <channel> <title>Ime feeda</title> <link>http://primer.com/</link> <description>Opis feeda</description> <item> <title>Naslov priloga</title> <link>http://primer.com/link-ka-prilogu</link> <description>opis priloga ili ceo prilog</description> </item> </channel> </rss> |
Snimite gornji kod kao rss.xml i imate svoj prvi lično vaš RSS 2.0 feed. Obratite pažnju da pri snimanju odaberete kodni raspored UTF-8 u vašem text editoru ako koristite č, ć, š, đ, ž ili ћирилична слова u <title> ili <description> !
Sledeće šta je potrebno da uradite je da ovaj fajl stavite na vaš web server i ono najvažnije:
"otvorite" dokument na koji se vaš feed odnosi ( bilo da je to .html ili .php ) i u headeru ( heder je područje u dokumentu koje se nalazi između tagova <head> i </head> i upišite tamo
| <link rel="alternate" type="application/rss+xml" title="Ime RSS feeda " href="putanja-do-fajla-rss.xml" /> |
Na ovaj način će "brovzeri" i botovi "samo"-otkriti vaš RSS 2.0 feed.
Ovako svaki vaš pojedinačni fajl-dokument može imati "svoj" RSS 2.0 feed.
Ako želita da imate jedan fajl za ceo vaš sajt, to izgleda ovako:
<?xml version="1.0"?> |
Ili ako vas "mrzi" da pišete kod sami, ispunite polja, stisnite "submit" i iskočiće vam novi prozor, sa kojeg možete copy-paste u fajl koji ćete onda snimiti kao rss.xml ( ako imate neki plugin u vašem browser-u koji prikazuje .xml pogledajte "source") ili jednostavno snimite prozor koji je iskočio kao rss.xml :
Generator Minimalnog RSS 2.0
To bi konkretno za ovaj moj prilog izgledalo ovako:
<?xml version="1.0"?> |
Kad posetilac poseti ovu stranu u "adressbar"-u će mu se pojaviti ikonica
Da li je vaš RSS feed validan možete proveriti na "online" Feed Validatoru, pogledajte ovaj "naš ručni" RSS 2.0 feed kao što vidite dobili smo validan RSS feed. Mada Validator sugeriše da bi bilo dobro da se dodaju još neke informacije :
This feed is valid, but interoperability with the widest range of feed readers could be improved by implementing the following recommendations.
line 14, column 0: item should contain a guid element
</item>
line 15, column 0: Missing atom:link with rel="self"
</channel>
Da bi ovaj RSS feed bio kompatibilan sa većinom RSS čitača, treba mu "dodati" guid element i Atom link.
Posle dodavanja GUID "naš" RSS 2.0 brand new feed izgleda ovako:
<?xml version="1.0"?> |
U validni RSS 2.0 možete još opciono staviti elemente
u odeljak "kanal" <channel> pre liste <item>
<copyright> - ko ima autorska prava
<language> - jezik RSS feeda, spisak "podržanih" jezika možete naći ovde.
<managingEditor> - editor "kanala"
<webMaster> - kaže samo
<pubDate> - datum objavljivanja
<lastBuildDate> - datum zadnje izmene
<category> - kategorije u koje spada "kanal"
<generator> - ime programa koji je generisao RSS "kanal"
<docs> - link ka dokumentaciji o specifikacijama RSS feeda
<cloud> - rssCloud interfejs
<ttl> - time to live, sugeriše koliko minuta "kanal" može biti keširan, pre no što se osveži sa "izvora"
<image> - URL do .jpg .gif ili .png slike koja služi za predstavljanje "kanala"; ALT opis iz HTML-a
<rating> - PICS oznaka; prvobitno zamišljena kao pomoć roditeljima šta deca smeju da vide
<textInput> - obavezno mora sadržavati pod elemente <title>, <description>, <name> i <link>
<skipHours> - brojčana vrednost od 0 do 24 koja označava vreme (GMT) kad čitači-agregatori ne treba da čitaju RSS feed
<skipDays> - sa pod elementom npr. <day>Monday</day> koji označava kad čitači-agregatori ne treba da čitaju RSS feed
u odeljku <item> opciono mogu biti još elementi
<author> - email autora priloga
<comments> - link ka dokumentu na kojem ima komentara na prilog
<category> - označava kategorije u koje spada prilog
<enclosure> - opisuje medija fajl koji je "zakačen" za prilog
<source> - ako je "izvor" priloga drugi RSS kanal, link ka njemu
<pubDate> - datum objavljivanja
<guid> - jedinstveni identifikacioni "string" za prilog, greškom većina upisuje URL ka prilogu!
Svi ovi gore nabrojani element RSS feeda se ređe upotrebljavaju, a neki čitači-agregatori ih potpuno ignorišu, te se njima nećemo baviti.
I na kraju ( ako ste još tu i niste pobegli glavom bez obzira ) umesto primera, možete se oprobati
u generisanju validnog RSS feeda ako ispunite polja ispod i kliknete "submit", u novom prozoru će biti validni RSS feed po vašim specifikacijama. Možete ga sačuvati i "uploadovati" na vaš web server :
Validni RSS 2.0 Generator