Jak funguje Validátor RSS kanálu
Tento online nástroj umožňuje vložit XML obsah kanálu RSS 2.0 nebo Atom 1.0 do textové oblasti a provést jeho okamžitou analýzu. Nástroj identifikuje formát vloženého obsahu, analyzuje jednotlivé položky a nahlásí případné problémy se strukturou kanálu, povinnými poli a odkazy.
Výstupem kontroly je podrobná zpráva o chybách a varováních, která u každého nalezeného problému uvádí přesné číslo řádku, sloupce a XML cestu. Nástroj dokáže zpracovat vstup o maximální délce 500 000 znaků na jednu kontrolu. Pro usnadnění práce jsou k dispozici funkce Použít příklad RSS a Použít příklad Atom, které načtou vzorové kanály, zatímco tlačítko Vymazat slouží k odstranění vstupu i výsledků.
Během zpracování se mohou zobrazit následující stavové zprávy a výsledky:
- Kanál se kontroluje…
- Připraveno pro RSS nebo Atom XML.
- Příklad RSS byl načten.
- Příklad Atom byl načten.
- Vstup a výsledky byly vymazány.
- Nebyly nalezeny žádné strukturální problémy.
- Nalezeno
‹errors›chyb a‹warnings›varování.
Pokud je v kanálu příliš mnoho dat, nástroj zobrazí maximálně 200 problémů a 100 položek s upozorněním na zkrácení výpisu: Zobrazuje se prvních ‹shown› z celkem ‹total› problémů. a Zobrazuje se prvních ‹shown› z celkem ‹total› položek.. Pokud je pole bez názvu, zobrazí se jako Kanál bez názvu nebo Položka bez názvu. V případě neznámého formátu nástroj vypíše Neznámý formát kanálu.
Pro koho je tento nástroj určen
Validátor je navržen pro širokou škálu uživatelů, kteří pracují s syndikačním obsahem. Mezi ně patří:
- Provozovatelé webových stránek
- Vydavatelé obsahu
- Vývojáři
- Týmy migrující RSS/Atom kanály
- Kdokoli, kdo potřebuje zkontrolovat formát kanálu RSS 2.0 nebo Atom 1.0
- Kdokoli, kdo potřebuje v kanálu identifikovat chybně utvořený zápis, chybějící pole kanálu či položek a neanalyzovatelné odkazy
Struktura a požadavky na kanály RSS 2.0
Při validaci formátu RSS 2.0 nástroj uplatňuje specifická pravidla pro strukturu dokumentu a jeho položky. RSS kanál musí obsahovat přesně jeden přímý prvek channel, jinak se zobrazí chyba: RSS musí obsahovat právě jeden přímý prvek <channel>; nalezeno ‹count›..
U jednotlivých položek RSS (prvků item) validátor kontroluje a načítá tyto parametry:
- Přítomnost názvu nebo popisu (pravidlo
title-or-description). - Unikátní identifikátor
GUID. - Odkaz (
link). - Datum zveřejnění (
publication date).
Pokud v dokumentu chybí povinné součásti, validátor vrátí chybu Přidejte povinné pole ‹field›. nebo Ponechte právě jedno pole ‹field›; nalezeno ‹count›.. Datum musí odpovídat standardu, jinak se zobrazí zpráva: Použijte skutečné datum ve formátu, který tento kanál vyžaduje..
Struktura a požadavky na kanály Atom 1.0
Formát Atom 1.0 podléhá odlišným a často přísnějším pravidlům než RSS. U položek Atom (prvků entry) validátor kontroluje:
- Jedinečné ID.
- Název (
title). - Čas poslední aktualizace (
updated). - Pravidla pro dědění autora.
- Alternativní odkazy.
- Pravidla pro obsah (
content) nebo shrnutí (summary).
S formátem Atom se pojí specifické chybové zprávy validátoru:
- Použijte absolutní IRI pro
‹field›; relativní identifikátory nejsou platná ID Atom. - Přidejte <author> ke kanálu nebo přímý <author> ke každé položce.
- Přidejte <author> k této položce, jejímu <source> nebo ke kanálu.
- Pokud položka Atom nemá vložený <content>, přidejte alternativní <link>.
- Pokud <content> používá src, odstraňte jeho vložený text a podřízené prvky.
- Pokud je obsah Atom externí nebo jej nelze číst jako text, přidejte <summary>.
Zpracování odkazů a role xml:base
Validátor analyzuje pole obsahující odkazy a pokouší se je zpracovat jako URL nebo URI reference. V rámci formátu Atom 1.0 nástroj podporuje řešení relativních odkazů pomocí atributu xml:base.
Pokud odkaz nelze správně analyzovat, nebo pokud je použit relativní odkaz bez definovaného základu, validátor zobrazí tyto chyby:
- Opravte
‹field›; tento odkaz nelze analyzovat jako URL nebo URI referenci. - Pro
‹field›použijte absolutní adresu; relativní mohou být pouze odkazy Atom s použitelným xml:base.
Nástroj však nikdy neotevírá samotné URL adresy obsažené v kanálu. To znamená, že dostupnost odkazů, přesměrování, platnost SSL certifikátů ani samotný obsah cílových stránek nejsou testovány.
Běžné chyby v XML a omezení validace
Při kontrole se můžete setkat s chybami, které brání úspěšnému dokončení analýzy. Mezi tyto strukturální a formátové chyby patří:
- Před kontrolou tohoto kanálu odstraňte deklaraci DOCTYPE. (Nástroj nepovoluje deklarace DOCTYPE).
- Opravte chybně utvořené XML a ověřte je znovu. (Zobrazí se při neplatné syntaxi XML).
- Použijte dokument RSS 2.0 s prvkem <rss> nebo dokument Atom 1.0 s prvkem <feed>. (Zobrazí se při nepodporovaném formátu).
- Tento validátor podporuje
‹format›‹expected›; zjištěna byla verze‹actual›. (Zobrazí se při detekci nepodporované verze). - Toto ID opakuje hodnotu, která se poprvé objevila na řádku
‹first›. (Duplicitní identifikátory).
Nástroj má také provozní limity. Pokud dojde k překročení limitu znaků, zobrazí se zpráva: Tento nástroj přijímá nejvýše ‹max› znaků na jednu kontrolu.. Pokud proces selže nebo trvá příliš dlouho, zobrazí se chyby Ověření trvalo příliš dlouho. Zkuste menší kanál. nebo Ověření se nepodařilo dokončit.. Podrobnosti o chybě analyzátoru jsou vypsány ve formátu: Podrobnosti analyzátoru: ‹detail›.
Je důležité mít na paměti, že tato zpráva kontroluje pouze strukturu a běžná pravidla formátu. Nedokládá, že je obsah přesný, bezpečný, přijímaný všemi čtečkami nebo připravený ke zveřejnění.
Ochrana osobních údajů
Při používání tohoto nástroje jsou vaše data v bezpečí. Kanál se kontroluje přímo ve vašem prohlížeči. Služba BroBroGo nic nenahrává na své servery ani neukládá.
Často kladené otázky (FAQ)
Které formáty kanálů tento validátor podporuje?
Ověřuje současné dokumenty RSS 2.0 a Atom 1.0. Starší RSS, RDF/RSS 1.0 a Atom 0.3 rozpozná, ale nekontroluje je podle nesprávných pravidel.
Otevírá nebo testuje odkazy v kanálu?
Analyzuje pole s odkazy a pomocí xml:base řeší relativní odkazy Atom. URL nikdy neotevírá, takže netestuje dostupnost, přesměrování, certifikáty ani obsah cíle.
Která pole položek se kontrolují?
U RSS item kontroluje přítomnost názvu nebo popisu a čte GUID, odkaz a datum zveřejnění. U Atom entry kontroluje ID, název, updated, dědění autora, alternativní odkazy a pravidla pro content nebo summary.