Tworzenie RSS - poradnik





Tworzenie RSS - poradnik

Definicja kanału RSS to plik XML o niezbyt zagmatwanej konstrukcji. Dzięki temu nawet mało zaawansowany webmaster jest w stanie zbudować w pełni funkcjonalny kanał. Przyjrzyj się poniższemu przykładowi:


<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0">
<channel>
<title>Wiadomości</title>
<link>http://www.firma.pl</link>
<description><![CDATA[Informacje o nowościach naszej firmy]]></description>
<item>
<title>Nowa myszka w sprzedaży!</title>
<link>http://www.firma.pl/rss/info001.html</link>
<description><![CDATA[Nowa myszka optyczna firmy Mouse Ltd. trafi już jutro na rynek.
W ramach promocji przewidziana jest bardzo atrakcyjna cena.]]></description>
</item>
</channel>
</rss>


Aż trudno uwierzyć, ale ta garść kodu zostanie bez problemu wyświetlona w czytniku kanałów RSS - o niektórych programach piszemy na stronie Kanały RSS.

A oto wynik działania kodu w czytniku FeedDemon (kliknij na miniaturze):



To bardzo prosty przykład, zawierający tylko obowiązkowe znaczniki, a więc takie, dzięki którym kanał może być w ogóle wyświetlony.

Jak łatwo zauważyć, znacznik
<title>Wiadomości</title>
nadaje nazwę naszemu kanałowi, znacznik
<title>Nowa myszka w sprzedaży!</title>
jest tytułem konkretnej wiadomości, natomiast znacznik
<description><![CDATA[Nowa myszka optyczna firmy Mouse Ltd. trafi już jutro na rynek. W ramach promocji przewidziana jest bardzo atrakcyjna cena.]]></description>
jest krótkim opisem wiadomości, zachęcającym do kliknięcia na odsyłaczu i wczytania pełnej wiadomości.


Kanał RSS jest więc tekstowym plikiem o rozszerzeniu .xml. Plik taki posyłamy na serwer, a następnie informujemy o nim czytelników serwisu, podając dokładny adres, np. http://webmaster.helion.pl/kurshtml/rss/przyklad.xml. Adres ten zostanie wykorzystany przez czytelników, gdy będą włączać kanał do swojego czytnika RSS.

Istnieją różne specyfikacje RSS, a co ciekawe, każda jest rozwijana przez oddzielny zespół programistów. Najnowsza (koniec 2003 roku) nosi numer 2.01, ale w Sieci spotyka się jeszcze wiele kanałów zbudowanych na bazie specyfikacji 0.91. Ponieważ jednak najnowsza wersja powoli się zadomowia, skupimy się na niej. Obszerny opis wersji 0.91 znajdzie Czytelnik na stronach zamkniętego już Webmastera - http://www.pckurier.pl/webmaster/1999/grudzien/jagodzinski/www.html. Z kolei specyfikację 2.0, w języku angielskim, można znaleźć na stronie http://blogs.law.harvard.edu/tech/rss.

Ogólna struktura pliku

Definicja kanału składa się z dwóch części. Pierwszą jest deklaracja pliku XML, czyli

<?xml version="1.0" encoding="UTF-8" ?>

Drugą jest właściwy kanał, zawarty w znaczniku informującym o użytej specyfikacji.


<rss version="2.0">
<channel>
...
</channel>
</rss>


Deklaracja pliku XML nie musi zawierać parametru informujacego o użytej stronie kodowej (np. encoding="UTF-8"), ale zaleca się stosowanie tego parametru, aby nie było problemu z wyświetlaniem polskich znaków. Najbardziej typową stroną kodową XML jest UTF-8, chociaż można też z powodzeniem zastosować inne strony kodowe języka polskiego, np. windows-1250 czy iso-8859-2. I tutaj docieramy do istotnego problemu, jakim są narzędzia.

Skoro plik XML jest plikiem tekstowym, możemy go pisać nawet w zwykłym Notatniku, dając jedynie rozszerzenie .xml. W Windows XP Notatnik zapisuje pliki nie tylko w środowiskowym windows-1250, ale i w standardzie kodowania UTF-8. Strony kodowe obsługuje także Word, WordPad, Pajączek, a wszystkim można polecić darmowy, unikodowy edytor UniRed, Jurija Finkela - http://www.esperanto.mv.ru/UniRed/ENG/.

Oczywiście, powstają też dedykowane narzędzia do tworzenia kanałów RSS. Zaawansowanym produktem jest Broadcast Builder (http://www.lionhardt.com/bb/), dostępny w wersjach Personal, Professional i Enterprise. Niestety, wszystkie są płatne (od 30 USD za wersję Personal). Broadcast Builder, w przygotowywanej wersji 1.48, wprowadził już konwersję polskich znaków. W opracowaniu jest też tłumaczenie programu na język polski. Na pewno warto pobawić się wersją testową i przećwiczyć technikę, śledząc jednocześnie efekty w postaci plików wynikowych w standardzie XML.

Właściwy kanał

Rozszerzmy teraz nieco podaną wyżej minimalną definicję. Przykładowy kanał został przygotowany za pomocą Broadcast Buildera, stąd informacje o tym właśnie narzędziu w kodzie przykładu.



<?xml version="1.0" encoding="UTF-8" ?>
<!-- RSS generated with Broadcast Builder 1.48 Personal (C) Lionhard Technologies 2003,
www.lionhardt.com/bb -->
<rss version="2.0">
<channel>
<generator>Broadcast Builder 1.48 Enterprise (C) Lionhardt Technologies 2003,
www.lionhardt.com/bb</generator>
<lastBuildDate>Sat, 20 Dec 2003 21:00:00 GMT</lastBuildDate>
<title>Serwis Fathers&Sons Ltd.</title>
<link>http://www.fs.pl</link>
<description><![CDATA[Najświeższe informacje z rynku akcesoriów komputerowych]]></description>
<language>pl</language>
<copyright>Fathers&Sons Ltd., Warszawa 2003</copyright>
<managingEditor>[e-mail] (Paweł Wimmer)</managingEditor>
<webMaster>Paweł Wimmer</webMaster>
<ttl>60</ttl>
<pubDate>Sat, 20 Dec 2003 20:00:00 GMT</pubDate>
<item>
<title>Nowa myszka w sprzedaży!</title>
<link>http://www.fs.pl/news01.html</link>
<pubDate>Sat, 20 Dec 2003 21:00:00 GMT</pubDate>
<description><![CDATA[Nowa myszka optyczna firmy Mouse Ltd. trafi już jutro na rynek.
W ramach promocji przewidziana jest bardzo atrakcyjna cena.]]></description>
<category>Myszki</category>
<author>Paweł Wimmer</author>
</item>
<item>
<title>Klawiatura głosowa wchodzi na rynek</title>
<link>http://www.fs.pl/news02.html</link>
<pubDate>Sat, 20 Dec 2003 20:50:00 GMT</pubDate>
<description><![CDATA[Wprowadzamy na polski rynek klawiaturę reagującą na głos,
zaprojektowaną przez Keyboard Ltd.]]></description>
<category>Klawiatury</category>
<author>Paweł Wimmer</author>
</item>
</channel>
</rss>



Wyjaśnienie znaczników

W języku XML znaczniki są parzyste, a więc każdy znacznik otwierający ma swój odpowiednik w postaci znacznika zamykającego. Pamiętaj też, że ważna jest wielkość liter, a więc znacznik <item> nie może mieć odpowiednika </Item>

<rss version="2.0">

Znacznik określa użytą specyfikację języka RSS.

<channel>

Znacznik <channel> otwiera definicję kanału.

Ogólne informacje o kanale

<generator>Broadcast Builder 1.48 Enterprise (C) Lionhardt Technologies 2003, www.lionhardt.com/bb</generator>

Opcjonalny znacznik <generator> określa użyte narzędzie, w podanym przykładzie Broadcast Builder.

<lastBuildDate>Sat, 20 Dec 2003 21:00:00 GMT</lastBuildDate>

Opcjonalny znacznik <lastBuildDate> określa datę i godzinę ostatniej zmiany w zawartości kanału - w tym przykładzie Sobota, 20 grudnia 2003, godz. 21:00:00 czasu GMT. W polskich warunkach zaleca się uzwględnienie przesunięcia czasowego, a więc zamiast GMT można napisać +0100.

<title>Serwis Fathers&Sons Ltd.</title>

Obowiązkowy znacznik <title> zawiera tytuł serwisu, który będzie widniał na liście zaabonowanych serwisów w czytniku RSS.

<link>http://www.fs.pl</link>

Obowiązkowy znacznik <link> podaje adres serwisu zawierającego kanał RSS.

<description><![CDATA[Najświeższe informacje z rynku akcesoriów komputerowych]]></description>

Obowiązkowy znacznik <description> opisuje krótko zawartość kanału.

<language>pl</language>

Opcjonalny znacznik <language> informuje o języku kanału. Wartości to en-us, en, fr, de, pl itd.

<copyright>Fathers&Sons Ltd., Warszawa 2003</copyright>

Opcjonalny znacznik <copyright> informuje o prawach autorskich do kanału.

<managingEditor>[e-mail] (Paweł Wimmer)</managingEditor>

Opcjonalny znacznik <managingEditor> podaje informację o osobie odpowiedzialnej za redagowanie kanału, np. [e-mail] (Paweł Wimmer).

<webMaster>[e-mail] (Paweł Wimmer)</webMaster>

Opcjonalny znacznik <webMaster> podaje informację o osobie odpowiedzialnej za techniczną stronę kanału, np. [e-mail] (Paweł Wimmer).

<pubDate>Sat, 20 Dec 2003 20:00:00 GMT</pubDate>

Opcjonalny znacznik <pubDate> informuje o dacie publikacji kanału.

<ttl>60</ttl>

Opcjonalny znacznik <ttl>, czyli Time To Live, podaje w minutach, jak długo wiadomość ma tkwić w cache'u czytnika RSS przed ewentualnym odświeżeniem z serwera.

Informacje o punktach kanału

Za znacznikami ogólnymi informującymi o kanale wstawiane są znaczniki opisujące poszczególne wiadomości.

<item>

Obowiązkowy znacznik <item> obejmuje całość informacji dotyczącej jednej wiadomości. Wszystkie znaczniki w ramach <item> są opcjonalne, ale w definicji wiadomości musi się pojawić przynajmniej tytuł lub opis wiadomości.

<title>Nowa myszka w sprzedaży!</title>

Znacznik <title> jest tytułem wiadomości, który pojawi się na liście tytułów pobranych z serwera "zajawek".

<link>http://www.fs.pl/news01.html</link>

Znacznik <link> jest odsyłaczem do właściwej wiadomości na serwerze.

<pubDate>Sat, 20 Dec 2003 21:00:00 GMT</pubDate>

Znacznik <pubDate> jest datą publikacji konkretnego punktu kanału.

<description><![CDATA[Nowa myszka optyczna firmy Mouse Ltd. trafi już jutro na rynek.
W ramach promocji przewidziana jest bardzo atrakcyjna cena.]]></description>

Znacznik <description> jest opisem wiadomości, który rozwija informacje w tytule i pozwala czytelnikowi zorientować się, czy warto wczytać pełną wiadomość z serwera.

<category>Myszki</category>

Znacznik <category> zalicza wiadomość do wskazanej kategorii.

<author>Paweł Wimmer</author>

Znacznik <author> wymienia autora wiadomości.

Istotna uwaga techniczna: Jeśli w części nagłówkowej Head serwisu internetowego umieścimy informację o kanale, np.:

<link rel="alternate" type="application/rss+xml" title="RSS" href="http://www.fs.pl/kanal.xml" />

niektóre czytniki RSS automatycznie zlokalizują obecność kanału i zaproponują jego zaabonowanie, gdy użytkownik wczyta stronę bezpośrednio w interfejsie programu. Funkcją taką dysponuje FeedDemon.