Validácia XML kanálov RSS 2.0 a Atom 1.0
Validátor kanálov RSS je špecializovaný nástroj určený na analýzu a kontrolu štruktúry syndikačných kanálov vo formátoch RSS 2.0 a Atom 1.0. Používateľ vloží kompletný XML kód priamo do textového poľa, pričom nástroj následne identifikuje formát, spracuje jednotlivé záznamy a preverí súlad s technickými pravidlami.
Nástroj je navrhnutý pre potreby prevádzkovateľov webových stránok, vydavateľov obsahu, vývojárov a tímov, ktoré migrujú syndikačné kanály. Pomáha odhaliť nesprávne vytvorený XML zápis, chýbajúce povinné polia kanála či záznamu a odkazy, ktoré nie je možné správne spracovať.
Spracovanie údajov prebieha lokálne. Kanál sa kontroluje vo vašom prehliadači a BroBroGo nič neodosiela ani neukladá.
Pravidlá a požiadavky pre formát RSS 2.0
Formát RSS 2.0 podlieha špecifickým štrukturálnym pravidlám, ktoré validátor systematicky overuje:
- Koreňový prvok a kanál: Dokument musí obsahovať správny koreňový prvok. RSS musí obsahovať presne jeden priamy prvok
<channel>. Ak validátor nájde iný počet, zobrazí chybu: RSS musí obsahovať presne jeden priamy prvok <channel>; nájdené: ‹count›. - Povinné polia: Pre každú položku (item) v RSS kanáli sa vyžaduje prítomnosť minimálneho súboru údajov. Validátor kontroluje pravidlo
title-or-description(názov alebo opis). Ak chýba povinné pole, zobrazí sa hlásenie: Pridajte povinné pole‹field›. - Spracovanie položiek: Pri každej položke nástroj číta identifikátor
GUID, odkaz (link) a dátum zverejnenia (publication date). - Dátumové formáty: Dátumy musia zodpovedať špecifikácii formátu RSS 2.0. V prípade nesprávneho zápisu nástroj vygeneruje chybu: Použite skutočný dátum vo formáte, ktorý tento kanál vyžaduje.
Pravidlá a požiadavky pre formát Atom 1.0
Formát Atom 1.0 má prísnejšie pravidlá na identifikáciu, autorstvo a prepojenia. Validátor pri tomto formáte kontroluje nasledovné oblasti:
- Identifikátory a odkazy: Každý záznam musí mať jedinečné ID. Pre pole
‹field›sa vyžaduje absolútny IRI, keďže relatívne identifikátory nie sú platné ID Atom. Ak sa zistí duplicita, zobrazí sa chyba: Toto ID opakuje hodnotu, ktorá sa prvýkrát objavila v riadku‹first›. - Autorstvo: Atom vyžaduje striktné dedenie autorstva. Ak chýba autor na úrovni kanála aj záznamu, validátor vyžaduje nápravu prostredníctvom chýb: Pridajte <author> do kanála alebo priamy <author> do každého záznamu. alebo Pridajte <author> do tohto záznamu, jeho <source> alebo kanála.
- Alternatívne odkazy a obsah: Ak záznam Atom nemá vložený
<content>, vyžaduje sa pridanie alternatívneho odkazu (link). Ak<content>používa atribútsrcpre externý zdroj, musí sa odstrániť vložený text a podradené prvky. Ak je obsah Atom externý alebo sa nedá čítať ako text, je nutné pridať<summary>.
Úloha xml:base a overovanie odkazov
Odkazy v syndikačných kanáloch musia byť jednoznačne interpretovateľné. Validátor analyzuje polia s odkazmi a overuje ich štruktúru:
- Absolútne adresy: Všetky prepojenia a identifikátory by mali prednostne používať absolútny formát. Ak odkaz nemožno spracovať ako URL alebo URI, zobrazí sa chyba: Opravte
‹field›; tento odkaz nemožno spracovať ako URL ani referenciu URI. - Relatívne odkazy v Atom: Formát Atom 1.0 umožňuje použitie relatívnych odkazov iba v prípade, že je definovaný atribút
xml:base. Validátor pomocouxml:basevyrieši relatívne odkazy Atom. Bez použiteľnéhoxml:basevyvolá relatívny odkaz chybu: Pre pole‹field›použite absolútnu adresu; relatívne môžu byť iba odkazy Atom s použiteľným xml:base. - Rozsah kontroly: Validátor iba analyzuje textovú štruktúru odkazov. URL adresy fyzicky neotvára, takže dostupnosť, presmerovania, certifikáty ani cieľový obsah netestuje.
Limity spracovania a chybové stavy XML
Pri analýze dokumentov platia technické obmedzenia a pravidlá pre spracovanie chýb parsera:
- Veľkosť vstupu: Maximálny limit na jednu kontrolu je 500 000 znakov. Pri prekročení sa zobrazí chyba: Tento nástroj prijíma najviac
‹max›znakov na jednu kontrolu. - Časový limit: Ak spracovanie trvá príliš dlho, systém vypíše: Overenie trvalo príliš dlho. Skúste menší kanál.
- Chyby XML štruktúry: Ak dokument obsahuje deklaráciu DOCTYPE, validátor vypíše: Pred kontrolou tohto kanála odstráňte deklaráciu DOCTYPE. Pri poškodenom XML kóde sa zobrazí: Opravte nesprávne vytvorený XML a overte ho znova.
- Rozsah výstupu: Nástroj zobrazuje maximálne 200 problémov a 100 záznamov. Ak kanál obsahuje viac položiek, výstup sa skráti s upozornením: Zobrazuje sa prvých
‹shown›z‹total›problémov. alebo Zobrazuje sa prvých‹shown›z‹total›záznamov.
Rozdiel medzi štrukturálnou a obsahovou validáciou
Tento nástroj slúži výhradne na technickú kontrolu syntaxe a štruktúry XML dokumentu. Je dôležité rozlišovať medzi bezchybným formátovaním a faktickou správnosťou obsahu.
Táto správa kontroluje iba štruktúru a bežné pravidlá formátu. Nedokazuje, že obsah je presný, bezpečný, akceptovaný každou čítačkou alebo pripravený na zverejnenie. Nástroj negarantuje, že po úspešnom overení budú externé čítačky správne interpretovať sémantický význam publikovaných článkov alebo médií, overuje iba súlad s technickými špecifikáciami RSS 2.0 a Atom 1.0.
Často kladené otázky (FAQ)
Ktoré formáty kanálov tento validátor podporuje?
Overuje aktuálne dokumenty RSS 2.0 a Atom 1.0. Staršie kanály RSS, RDF/RSS 1.0 a Atom 0.3 rozpozná, ale nekontroluje ich podľa nesprávnych pravidiel.
Otvára alebo testuje odkazy v kanáli?
Spracuje polia s odkazmi a pomocou xml:base vyrieši relatívne odkazy Atom. URL adresy neotvára, takže dostupnosť, presmerovania, certifikáty ani cieľový obsah netestuje.
Ktoré polia záznamov sa kontrolujú?
Pri položkách RSS kontroluje názov alebo opis a číta GUID, odkaz a dátum zverejnenia. Pri záznamoch Atom kontroluje ID, názov, aktualizáciu, dedenie autora, alternatívne odkazy a pravidlá obsahu alebo súhrnu.
Prečo sa zobrazuje chyba o deklarácii DOCTYPE?
Z bezpečnostných a technických dôvodov validátor nepovoľuje externé definície typov dokumentov. Pred spustením kontroly musíte riadok s deklaráciou DOCTYPE z XML kódu odstrániť.