2020. július 28., kedd

RSS 2.0 specifikáció röviden

Tartalomjegyzék:



<?
xml version="1.0">
<rss version="2.0">
<channel>
<link>....</link>
      
<title>
....</title> <description>....</description> <language>....</language> <rating>....</rating> <copyright>....</copyright> <pubDate>....</pubDate> <lastBuildDate>....</lastBuildDate> <category>....</category> <generator>....</generator> <docs>....</docs> <cloud>....</cloud> <ttl>....</ttl> <managingEditor>....</managingEditor> <webMaster>....</webMaster> <skipHours> <hour>....</hour> </skipHours> <skipDays> <day>....</day> </skipDays> <image> <title>....</title> <url>....</url> <link>....</link> <width>....</width> <height>....</height> <description>....</description> </image> <item> <title>....</title> <link>....</link> <description>....</description> <author>....</author> <category>....</category> <comments>....</comments> <enclosure ..../> <guid>....</guid> <pubDate>....</pubDate> <source>....</source> </item> ......More item tags..... <textInput> <title>...</title> <description>...</description> <name>...</name> <link>...</link> </textInput> </channel> </rss>

Az alábbiakban az RSS 2.0-hoz kapcsolódó összes választható és kötelező cimke bemutatásra kerül. (megjegyzés: Az összes cimke kis és nagybetű érzékeny)


XML verzió azonosítás  

Kötelező! a kódolás attributum elhagyható (default UTF-8).


Az RSS dokumentumnak - mivel egy XML file - kötelezően az XML verzió azonosító címkével kell kezdődnie. Ez adja meg az értelmező programnak hogy milyen  típusú dokumentummal van dolga.

Szintaxis:

  • <?xml version="1.0"?> vagy
  • <?xml version="1.0" encoding="[ encoding code here ]"?>
Az RSS v2.0 támogatott kódolásai itt.

Kötelező!

Az értelmező program ennek az értéke alapján fogja tudni szétválogatni a tartalom elemeit.

Szintaxis:
  • <rss version="2.0">

Ezek után kezdődik igazából a tartalomhoz szánt közös adatok kifejtése a <channel> tagban, itt találhatóak meg a feedre vonatkozó alap- valamint extra adatok.

<channel> tag 

Kötelező! Maximum 1 db lehet egy feedben!

A csatornára vonatkozó összes adat ezen belül fog szerepelni.

Szintaxis:
  • <channel>

Kötelező


HTML formázás esetén ezt a stringet érdemes a fejléc <head><title> eleménél feldolgozni. Ez a csatorna neve, így utalnak az emberek a szolgáltatásra.

Szintaxis:
  • <title>TutorialsPoint</title>

Kötelező!

A csatorna leírása. HTML értelmezésben ezt a <html><head><<

Szintaxis:
  • <description>Tutorialok, segédletek gyűjtőhelye</description>
Kötelező

A csatorna url címe.

Szintaxis:
  • <link>http://www.tutorialspoint.com</link


Opcionális

Az adat HTML formázásakor ezt érdemes a <html><head><meta http-equiv="Content-Language" content="[string]"> elemeként feldolgozni.


Szintaxis:
  • <language>[string]</language>    //példa: en-us
használható jelölések itt.


Opcionális

HTML formázáskor érdemes a <html><head><meta http-equiv="pics-label" content='(PICS-1.1 entries)' /> elemeként feldolgozni.
Az eredeti weboldal PICS rendszerben történő értékelésével használható.
bővebb információ (külső, angol nyelvű oldalak):
Szintaxis:
  • <rating>[ string ]</rating>

HTML formátumban a  <html><head><meta NAME="copyright" CONTENT=[ string]> elem értékeként dolgozhatjuk fel. Általában ez a csatorna tartalmára vonatkozó szerzői jogi megjegyzés.

Szintaxis:
  • <copyright>Copyright 2007, TutorialsPoint</copyright

Opcionális

A .csatornatartalom közzétételének az időbélyege. Az időformátumnak meg kell felenie az  RFC 822 ajánlásnak.


Szintaxis:
  • <pubDate>Thu, 19 Jul 2007 16:20:26 GMT</pubDate

Opcionális

A .csatornatartalom utolsó változásának az időbélyege. Az időformátumnak meg kell felenie az  RFC 822 ajánlásnak.


Szintaxis:
  • <lastBuildDate>Thu, 19 Jul 2007 16:20:26 GMT</lastBuildDate

Opcionális

Megadható egy vagy több kategória a.csatornatartalomhoz.


Szintaxis:
  • <category>[string]</category>

Opcionális

Megadható, hogy milyen rendszer készítette az RSS csatornát


Szintaxis:
  • <generator>MightyInHouse Content System v2.3</generator>


<docs> tag (a <channel>  alelemeként) 

Opcionális

Az URL, amely az RSS fájlban használt formátum dokumentációjára mutat.Azok számára készült, akik 25 év múlva esetleg beleakadnak egy RSS-fájlba egy webszerveren, és azon gondolkodnak, hogy mi az...


Szintaxis:
  • <docs>https://cyber.harvard.edu/rss/rss.html</docs
Opcionális

Lehetővé teszi a folyamatok regisztrálását egy felhőszolgáltatáson, hogy értesítést kapjanak a csatorna frissítéseiről, könnyű közzétételi és előfizetési protokollt valósítva meg az RSS csatornák számára.


Szintaxis:
  • <cloud>
  • domain="rpc.sys.com" port="80" path="/RPC2" 
  • registerProcedure="myCloud.rssPleaseNotify" protocol="xml-rpc"
  • </cloud
Ebben a példában, ha értesítést szeretne kérni a csatornán, amelyben megjelenik, akkor küldjön egy XML-RPC üzenetet az rpc.sys.com címre a 80-as porton, az / RPC2 elérési úttal.

<ttl> tag (a <channel>  alelemeként) 

Opcionális

A numerikus érték jelzi, hogy mennyi ideig tárolható a csatorna a forrástól való frissítés előtt.

Szintaxis:
  • <ttl>60</ttl

<managingEditor> tag (a <channel>  alelemeként) 

Opcionális

A közzétett anyagok szerkesztéséért felelős személy email címe.

Szintaxis:
  • <managingEditor>[email]</managingEditor>


<webMaster> tag (a <channel>  alelemeként) 

Opcionális

A weboldallal kapcsolatos technikai problémákért felelős személy email címe.

Szintaxis:
  • <webMaster>[email]</webMaster>


<skipHours> tag (a <channel>  alelemeként) 

Opcionális

Megadható,hogy az olvasó ne frissüljön bizonyos órákban.

Szintaxis:
  • <skipHours>...</skipHours>
elemei:


<hour> tag (a <skipHours>  alelemeként) 

Kötelező

A kezdő ideje 24 órás időintervallumban annak ,amikor az olvasó nem fog frissülni. Ha ez a tag nincs használatban akkor alapesetben óránként frissül.

Szintaxis:
  • <hour>[num]</hour>
A [num] értéke 0-23 közötti egész szám lehet (0 = éjfél)

Több <hour> tag is megadható a <skipHours> tagon belül


<skipDays> tag (a <channel>  alelemeként) 

Opcionális

Megadható,hogy az olvasó ne frissüljön bizonyos napokon.

Szintaxis:
  • <skipDays>...</skipDays>
elemei:

<day> tag (a <skipDay>  alelemeként) 

Kötelező, ha a <skipDay> elem használatban van!

A kezdő ideje 24 órás időintervallumban annak ,amikor az olvasó nem fog frissülni. Ha ez a tag nincs használatban akkor alapesetben óránként frissül. Az időt 0-23-ig terjedő egész számok jelezhetik.

Szintaxis:
  • <day>[string]</day>
A string értéke a következőket veheti fel:
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday
  • Sunday.
Több <day> tag is megadható a <skipDays> tagon belül


AZ <image> ELEMEI (a <channel> alelemeként) 

<image> tag (a <channel>  alelemeként) 

Opcionális

Megadható egy GIF, JPEG vagy PNG kép, amely megjeleníthető a csatornán. Ha megadásra kerül akkor 3 kötelező elemet kell tartalmaznia és rendelkezhet 3 választható elemmel.

Szintaxis:
  • <image>...</image>
elemei:
  • <url>    Kötelező, ha az <image> elem használatban van!
  • <title>    Kötelező, ha az <image> elem használatban van!
  • <link>    Kötelező, ha az <image> elem használatban van!
  • <width>    Opcionális
  • <height>    Opcionális
  • <description>    Opcionális

<url> tag (az <image>  alelemeként) 

Kötelező, ha az <image> elem használatban van!

Amikor a csatorna HTML formátumban jelenik meg akkor ezt az értéket fogja tartalmazni az <img> elem "src=" attributuma, azaz ez lesz a kép elérési útvonala.

Szintaxis:
  • <url>http://www.tutorialspoint.com/images/to-logo.gif</url>

<title> tag (az <image>  alelemeként) 

Kötelező, ha az <image> elem használatban van!

Amikor a csatorna HTML formátumban jelenik meg akkor ezt az értéket fogja tartalmazni az <img> elem "alt=" attributuma, azaz ez lesz a kép címe.

Szintaxis:
  • <title>Tutorial logó</title>

<link> tag (az <image>  alelemeként)

Kötelező, ha az <image> elem használatban van!

A weboldal címe, ahol a kép található. Megegyezik a <channel> elem <link> értékével

Szintaxis:
  • <link>http://www.tutorialspoint.com</link>

<width> tag (az <image>  alelemeként) 

Opcionális

Amikor a csatorna HTML formátumban jelenik meg akkor ezt fogja tartalmazni az <img> elem "style=" attributum width: értéke.

Szintaxis:
  • <width>[ numerikus érték ]</width>
megjegyzés:
  • a [ numerikus érték ]: 1-144 közötti szám lehet, alapesetben 88 az értéke.

<height> tag (az <image>  alelemeként) 

Opcionális

Amikor a csatorna HTML formátumban jelenik meg akkor ezt fogja tartalmazni az <img> elem "style=" attributum height: értéke.

Szintaxis:
  • <height>[numerikus érték]</height>
megjegyzés:
  • a [ numerikus érték ]: 1-400 közötti szám lehet, alapesetben 31 az értéke.

<description> tag (az <image>  alelemeként) 

Opcionális

Amikor a csatorna HTML formátumban jelenik meg akkor ezt a stringet fogja tartalmazni a kép linkjének, azaz <a > elemének "title=" attributuma

Szintaxis:
  • <description>...</description>


















  • ANSI_X3.4-1968 or US-ASCII
  • ISO_8859-1:1987 or ISO-8859-1
  • ISO_8859-2:1987 or ISO-8859-2
  • ISO_8859-5:1988 or ISO-8859-5
  • ISO_8859-7:1987 or ISO-8859-7
  • ISO_8859-9:1989 or ISO-8859-9
  • Shift_JIS
  • EUC-JP
  • GB2312
  • EUC-KR
  • Big5
  • windows-1250
  • windows-1251
  • UTF-8
  • x-mac-roman

RSS 2.0 <language>...</language> tag értékei a következők lehetnek 

Nyelv kód
Afrikaans af
Albanian sq
Basque eu
Belarusian be
Bulgarian bg
Catalan ca
Chinese (Simplified) zh-cn
Chinese (Traditional) zh-tw
Croatian hr
Czech cs
Danish da
Dutch nl
Dutch (Belgium) nl-be
Dutch (Netherlands) nl-nl
English en
English (Australia) en-au
English (Belize) en-bz
English (Canada) en-ca
English (Ireland) en-ie
English (Jamaica) en-jm
English (New Zealand) en-nz
English (Phillipines) en-ph
English (South Africa) en-za
English (Trinidad) en-tt
English (United Kingdom) en-gb
English (United States) en-us
English (Zimbabwe) en-zw
Faeroese fo
Finnish fi
French fr
French (Belgium) fr-be
French (Canada) fr-ca
French (France) fr-fr
French (Luxembourg) fr-lu
French (Monaco) fr-mc
French (Switzerland) fr-ch
Galician gl
Gaelic gd
German de
German (Austria) de-at
German (Germany) de-de
German (Liechtenstein) de-li
German (Luxembourg) de-lu
German (Switzerland) de-ch
Greek el
Hungarian hu
Icelandic is
Indonesian in
Irish ga
Italian it
Italian (Italy) it-it
Italian (Switzerland) it-ch
Japanese ja
Korean ko
Macedonian mk
Norwegian no
Polish pl
Portuguese pt
Portuguese (Brazil) pt-br
Portuguese (Portugal) pt-pt
Romanian ro
Romanian (Moldova) ro-mo
Romanian (Romania) ro-ro
Russian ru
Russian (Moldova) ru-mo
Russian (Russia) ru-ru
Serbian sr
Slovak sk
Slovenian sl
Spanish es
Spanish (Argentina) es-ar
Spanish (Bolivia) es-bo
Spanish (Chile) es-cl
Spanish (Colombia) es-co
Spanish (Costa Rica) es-cr
Spanish (Dominican Republic) es-do
Spanish (Ecuador) es-ec
Spanish (El Salvador) es-sv
Spanish (Guatemala) es-gt
Spanish (Honduras) es-hn
Spanish (Mexico) es-mx
Spanish (Nicaragua) es-ni
Spanish (Panama) es-pa
Spanish (Paraguay) es-py
Spanish (Peru) es-pe
Spanish (Puerto Rico) es-pr
Spanish (Spain) es-es
Spanish (Uruguay) es-uy
Spanish (Venezuela) es-ve
Swedish sv
Swedish (Finland) sv-fi
Swedish (Sweden) sv-se
Turkish tr
Ukranianuk

források:  

RSS 2.0 specifikáció röviden

Tartalomjegyzék: rss dokumentum struktúra XML verzió azonosítás RSS verzió azonosítás A <channel> elemei Az <image> elemei Az &...