RSS / Sdileni weblogu

Co je to RSS?
RSS a Serendipity
- Soubor rss.php
RSS import

Co je to RSS?

RSS je zkratka bud pro "RDF Site Summary" ( = souhrn stranky v RDF, pricemz RDF = rich data format = "bohaty" datovy format), nebo "Really Simple Syndication" ( = Opravdu Jednoducha Syndikace). V cestine ne zcela zrejmy pojem "syndikace" pochazi z anglictiny a znamena rychle sdileni velkych objemu dat po internetu, viz. tez napriklad http://en.wikipedia.org/wiki/Web_syndication [1] (anglicky odkaz).

Specifikace RSS 1.0 [2] (anglicky odkaz) definuje:

RDF Site Summary (RSS) je jednoduchy viceucelovy rozsiritelny format pro popis dat a sdileni obsahu (syndikace). RSS je XML aplikace kompatibilni s RDF specifikaci konsorcia W3C a je rozsiritelna pomoci XML-jmennych prostoru a/nebo pomoci RDF modularizace.

RSS je format, ktery se sklada z nekolika protichudnych verzi a odnozi. Nejbeznejsi jsou verze 0.91, 1.0 a 2.0. Muzete se podivat na historie RSS [3] (anglicky odkaz), kde se dozvite pozadi a vyvoj, ktery vedl k soucasne situace. Od noveho formatu Atom se ocekava, ze bude pokracovatelem teto technologie a ze ji rozsiri.

Nicmene zakladni princip kazdeho formatu pro syndikaci obsahu je stejny: Je tu proto, aby udelal Vase cenna data (obsah Vasich clanku) nezavisla na Vasi strance. Aby bylo mozne sdilet Vase clanky s jinymi strankami (jine webove stranky zobrazuji Vase clanky) a agregatory zprav. Ale predevsim, umozni cist Vase clanky pomoci specialniho softwaru - RSS ctecek.

Tyto nastroje jsou schopne precist mnoho kanalu (= blogu) najednou, a jednoduse oznami uzivateli vsechny novinky na Vasich strankach.

RSS a Serendipity

S9y podporuje vsechny zdokumentovane verze RSS a predbeznou specifikaci 0.3 formatu Atom.

Pokud povolite postranni plugin Sdileni weblogu, muzete vybrat, ktere verze chcete zpristupnit Vasim ctenarum. Odkaz na tyto RDF/XML soubory je rozsifrovatelny vetsinou RSS ctecek a obsahuje dodatecne informace o Vasich clancich jako jsou: pocet kometnaru, odkaz na komentare, male logo Vaseho kanalu, kontaktni mailova adresa a dokonce i licencni informace.

RSS funkce PHP take podporuji (Technical Documentation|Conditional Get for RSS Feeds).

Soubor rss.php

Soubor rss.php je zodpovedny za tvorbu polozek Vaseho RSS kanalu. Muze obdrzet nasledujici HTTP GET promenne (a podle toho pak poskytuje prislusny vysledek):

version: Verze = jedna moznost z "0.91", "1.0", "2.0", "atom0.3". Povinny parametr.

type: Typ. Muze byt bud "comments" (komentare) nebo "content" (obsah = prednastaveno). Pouziti hodnoty "comments" pripoji k clankum i vsechny komentare, zatimco "content" vepise do kanalu pouze text prispevku. Nicmene i v prispevich s9y pouziva CommentAPI [4] (a XML jmenne prostory) k zobrazeni komentaru k jednotlivych prispevkum. Voliteny parametr.

category: Kategorie. Je mozne omezit kanal pouze na urcitou kategorii. Timto zpusobem muzete ctenarum povolit sdilet pouze nektere kategorie Vaseho blogu. Volitelny parametr.

cid: Vklada do kanalu pouze jediny komentare podle jeho specifickeho ID (identifikacni cislo). Tento parametr je vyzadovan wfw: CommentAPI [4]. Volitelny parametr.

nocache: Pokud je tento parametr nastaven (na jakoukoliv hodnotu), pretezuje jakoukoliv prednastavenou cachovaci logiku.

all: Pokud je tento parametr nastaven na jakoukoliv hodnotu, RSS kanal bude obsahovat VSECHNY prispevky Vaseho blogu (oproti standarnimu omezeni na 15).

Nasledujicim zpusobem muzete zkombinovat vyse vyjmenovane parametry a vytvorit si osobni RSS kanal:

http://yourblog/serendipity/rss.php?version=1.0&category=2
-- Zobrazi RSS 1.0 kanal pro kategorii c.2

http://yourblog/serendipity/rss.php?version=2.0&type=comments
-- Zobrazi RSS 2.0 kanal se vsemi komentari

http://yourblog/serendipity/rss.php?version=1.0&category=3&type=comments
-- Zobrazi RSS 1.0 kanal se vsemi komentari v kategorii c.3

RSS import

Protoze vetsina blogovacich aplikaci sdili sva data pomoci RSS formatu, je tento format idealni pro import a export dat. Pokud napriklad zmenite blogovaci aplikaci z MoveableType na Serendipity a chcete pretahnout vsechny Vase prispevky, jednoduse se prihlaste do Administrativniho rozhrani a kliknete na Import dat. Tam bud zadejte URL adresu Vaseho RSS kanalu v MoveableType a kliknete na Importovat.

Dalsi informace nalezenete v manualove strance venovane migraci dat - Migrace z jinych blogu / RSS Import [5].

Take muzete zmigrovat data ze Serendipity na jiny blog tim, ze zadate adresu RSSkanalu s9y.

Pamatujte, ze RSS kanal obvykle poskytuje pouze poslednich 15 prispevku, takze nejspis nebudete schopni importovat celou databazi blogu. Serendipity umoznuje export vsech prispevku pomoci parametru "all", takze je mozne, ze i jine pokrocile blogovaci systemy umoznuji podobnou akci. Pokud se vyznate v SQL, asi Vam nebude cinit problemy napsat skript z prikazu insert into ... select pro import. Tedy pokud je struktura databaze puvodni blogovaci aplikace alespon trochu podobna strukture databaze v Serendipity.

Preklad - Vlada Ajgl, 2009/02/08, pro verzi Serendipity 1.4.1

Revize - Vlada Ajgl, 2008/02/24, pro verzi Serendipity 1.4.1

URL of this document:
http://www.s9y.org/244.html

Links:
   [1] http://en.wikipedia.org/wiki/Web_syndication
   [2] http://www.purl.org/rss/1.0/
   [3] http://goatee.net/2003/rss-history.html
   [4] http://www.s9y.org/240.html
   [5] http://www.s9y.org/251.html

Driven by coWiki 0.3.4 web collaboration tool.