Delovanje preverjevalnika virov RSS in Atom
Orodje omogoča lepljenje vsebine XML virov RSS 2.0 ali Atom 1.0 v besedilno polje. Po vnosu analizira prilepljeno vsebino, prepozna njeno obliko, razčleni posamezne vnose ter poroča o morebitnih težavah s strukturo vira, zahtevanimi polji in sklici povezav. Rezultat analize je podrobno poročilo o napakah in opozorilih, ki natančno navaja številko vrstice, stolpca in pot XML, kjer se težava nahaja.
Orodje sprejme do 500.000 znakov na posamezno preverjanje. Če postopek traja preveč časa, se izpiše opozorilo "Preverjanje je trajalo predolgo. Poskusite z manjšim virom.". V primeru, da se postopek ne more uspešno zaključiti, sistem prikaže sporočilo "Preverjanja ni bilo mogoče dokončati.".
Struktura in zahteve za vire RSS 2.0
Viri RSS 2.0 morajo slediti strogim strukturnim pravilom, da jih bralniki lahko pravilno razčlenijo. Vsak dokument RSS mora vsebovati natanko en neposredni kanal. Če validator zazna nepravilno število teh elementov, vrne napako "RSS mora vsebovati natanko en neposredni <channel>; najdenih: ‹count›.".
Za posamezne elemente znotraj postavk RSS (items) veljajo naslednja pravila preverjanja:
- Naslov ali opis: Validator preveri prisotnost pravila
title-or-description. Vsaka postavka mora vsebovati vsaj naslov ali opis. - Identifikatorji in povezave: Orodje prebere in preveri elemente
GUID,linkin datum objave (publication date). - Pravilnost povezav: Vse povezave morajo biti pravilno oblikovane. Če povezave ni mogoče razčleniti, se izpiše napaka "Popravite
‹field›; te povezave ni mogoče razčleniti kot URL os sklic URI.".
Struktura in zahteve za vire Atom 1.0
Viri Atom 1.0 imajo drugačna pravila za preverjanje strukture in obveznih polj kot RSS 2.0. Pri preverjanju vnosov Atom validator nadzoruje naslednje elemente:
- ID in posodobitev: Vsak vnos mora imeti enolični
IDin podatek o zadnji posodobitvi (updated). - Avtorstvo: Validator preverja pravilo dedovanja avtorja (
author inheritance). Če avtor ni določen, se sproži napaka "Dodajte <author> temu vnosu, njegovemu <source> ali viru." ali "Dodajte <author> viru ali neposredni <author> vsakemu vnosu.". - Nadomestne povezave in vsebina: Preverjajo se nadomestne povezave (
alternate links) ter pravila za vsebino ali povzetek (content or summary). Če vnos Atom nima vdelane vsebine, se zahteva nadomestna povezava, sicer se izpiše "Dodajte nadomestni <link>, ko vnos Atom nima vdelane <content>.". - Zunanja vsebina: Če se uporablja zunanja vsebina prek atributa
src, velja pravilo "Ko <content> uporablja src, odstranite njegovo vdelano besedilo in podrejene elemente.". Če je vsebina zunanja ali ni berljiva kot besedilo, se sproži napaka "Dodajte <summary>, ko je vsebina Atom zunanja ali je ni mogoče prebrati kot besedilo.".
Upravljanje povezav, ID-jev in atributa xml:base
Povezave in identifikatorji v virih morajo biti natančni, saj določajo edinstvenost vsebine in usmerjajo bralnike do dejanskih virov.
Absolutni in relativni sklici
Vsi identifikatorji v virih Atom morajo biti absolutni IRI. Uporaba relativnih identifikatorjev ni dovoljena, kar validator označi z napako "Za ‹field› uporabite absolutni IRI; relativni identifikatorji niso veljavni ID-ji Atom.". Podvojeni identifikatorji prav tako niso dovoljeni; če validator zazna enak ID na več mestih, izpiše opozorilo "Ta ID ponavlja vrednost, ki se je prvič pojavila v vrstici ‹first›.".
Vloga atributa xml:base
Pri razreševanju relativnih povezav v virih Atom ima ključno vlogo atribut xml:base. Validator razčleni polja s povezavami in z xml:base razreši relativne sklice Atom. Če atribut xml:base ni na voljo ali ni uporaben, relativne povezave niso dovoljene, kar sproži napako "Za ‹field› uporabite absolutni naslov; relativni so lahko samo sklici Atom z uporabnim xml:base.".
Pogoste napake v XML strukturi in oblikah virov
Pri preverjanju virov se pogosto pojavljajo splošne napake v samem zapisu XML ali različici formata.
Napačno oblikovan XML in deklaracije
Če dokument vsebuje neveljaven XML zapis, validator javi napako "Popravite napačno oblikovani XML in ga znova preverite.". Prav tako je pred preverjanjem potrebno odstraniti morebitne deklaracije DOCTYPE, sicer sistem vrne opozorilo "Pred preverjanjem tega vira odstranite deklaracijo DOCTYPE.".
Nepodprte različice in formati
Orodje je namenjeno izključno preverjanju formatov RSS 2.0 in Atom 1.0. Če zazna starejše različice, izpiše opozorilo o nepodprti različici: "Ta preverjevalnik podpira ‹format› ‹expected›; zaznano: ‹actual›.". Če format sploh ni prepoznan, se izpiše napaka "Uporabite dokument RSS 2.0 <rss> ali dokument Atom 1.0 <feed>.".
Nepravilni datumi
Datumi v virih morajo slediti natančnim specifikacijam posameznega formata. V primeru neveljavnega zapisa datuma validator opozori z napako "Uporabite pravi datum v obliki, ki jo zahteva ta vir.".
Zasebnost podatkov in omejitve preverjanja
Vir se preveri v vašem brskalniku. BroBroGo ničesar ne naloži ali shrani, kar zagotavlja lokalno obdelavo podatkov neposredno na vaši napravi.
Orodje deluje kot strukturni validator in ne odpira dejanskih URL-jev, ki so navedeni v viru. To pomeni, da se dosegljivost povezav, morebitne preusmeritve, veljavnost varnostnih potrdil (SSL/TLS) in dejanska vsebina na ciljnih straneh ne preizkušajo. To poročilo preverja samo zgradbo in običajna pravila oblike. Ne dokazuje, da je vsebina točna, varna, sprejeta v vseh bralnikih ali pripravljena za objavo.
Zaradi preglednosti in zmogljivosti brskalnika je prikaz rezultatov omejen. Orodje prikaže največ 200 težav in 100 vnosov. Če vir presega te omejitve, se izpišeta obvestili "Prikazanih je prvih ‹shown› od ‹total› težav." ter "Prikazanih je prvih ‹shown› od ‹total› vnosov.".
Pogosta vprašanja
Katere oblike virov podpira ta preverjevalnik?
Preverja trenutne dokumente RSS 2.0 in Atom 1.0. Starejše vire RSS, RDF/RSS 1.0 in Atom 0.3 prepozna, vendar jih ne preverja po napačnih pravilih.
Ali odpira ali preizkuša povezave v viru?
Razčleni polja s povezavami in z xml:base razreši relativne sklice Atom. URL-jev ne odpira, zato ne preverja dosegljivosti, preusmeritev, potrdil in ciljne vsebine.
Katera polja vnosov se preverjajo?
Pri elementih RSS preveri naslov ali opis ter prebere GUID, povezavo in datum objave. Pri vnosih Atom preveri ID, naslov, posodobitev, dedovanje avtorja, nadomestne povezave in pravila vsebine ali povzetka.
Kako orodje obravnava zasebnost mojih podatkov?
Vir se preveri v vašem brskalniku. BroBroGo ničesar ne naloži ali shrani.