Validátor podcastov RSS

Ako funguje Validátor podcastov RSS

Tento online nástroj slúži na kontrolu chýb v RSS kanáli vášho podcastu. Po vložení kompletného XML kódu systém vykoná statickú analýzu a identifikuje bežné problémy, ktoré by mohli brániť správnemu fungovaniu v podcastových aplikáciách.

Validátor sa zameriava na kontrolu štruktúry XML, overenie prítomnosti povinných polí pre kanál aj jednotlivé epizódy, podrobnosti o zvukových súboroch (enclosure) a správnosť formátovania dátumov. Po dokončení analýzy sa zobrazí sekcia Diagnóza Feed. Ak sa nájdu nedostatky, nástroj vypíše presné umiestnenie problému v tvare Riadok ‹line›, stĺpec ‹column› spolu s cestou k prvku vo formáte XPath, označenou ako Oprava: ‹path›. Pre rýchlu navigáciu môžete použiť odkaz Prejdite na ‹path› na riadku ‹line›, ktorý vás presmeruje priamo na problematické miesto v kóde. Ak je zoznam chýb príliš dlhý, nástroj zobrazí upozornenie Zobrazujú sa prvé problémy ‹shown› zo ‹total›..

Vstupné parametre a limity analýzy

Aby mohla kontrola prebehnúť úspešne, je potrebné do poľa Podcast RSS XML vložiť úplný feed vrátane deklarácie XML a koreňa.

Pri používaní nástroja platia nasledujúce technické pravidlá a obmedzenia:

• Formát a veľkosť: Nástroj prijíma výhradne formát XML. Maximálny limit pre jeden test je 500 000 znakov. Ak tento limit prekročíte, zobrazí sa chybové hlásenie o tom, že nástroj akceptuje iba povolené množstvo znakov.
• Časový limit: Ak spracovanie XML trvá príliš dlho, systém proces preruší a zobrazí správu: „Kontrola trvala príliš dlho. Skúste menší kanál.“.
• Zlyhanie analýzy: V prípade, že proces overenia nie je možné dokončiť z iných technických dôvodov, systém vypíše: „Overenie nebolo možné dokončiť.“.
• Prázdny vstup: Ak sa pokúsite spustiť test bez vloženia kódu, nástroj vás upozorní správou: „Pred overením prilepte podcast RSS XML.“.

Pravidlá pre štruktúru XML a koreňový adresár

Validátor dôsledne kontroluje, či je štruktúra RSS 2.0 XML správne sformovaná. Pri analýze koreňa a základnej štruktúry dokumentu platia tieto pravidlá:

• Deklarácia DOCTYPE: V kóde sa nesmie nachádzať deklarácia DOCTYPE. Ak ju nástroj deteguje, zobrazí chybu: „Pred kontrolou tohto feed odstráňte vyhlásenie DOCTYPE.“.
• Poškodený kód: Ak je samotný XML kód neplatný alebo zle štruktúrovaný, analýza sa zastaví s chybou: „Opravte poškodený XML a potom znova overte.“. Podrobnejšie informácie z XML parsera sa zobrazia v poli Detail analyzátora: ‹detail›.
• Koreňový prvok: Koreň dokumentu musí byť striktne <rss>. V opačnom prípade sa zobrazí chyba: „Koreň dokumentu musí byť <rss>.“.
• Verzia RSS: Atribút version prvku <rss> musí mať hodnotu "2.0". Ak má inú hodnotu, nástroj vráti chybu: „Nastavte atribút version na 2.0.“.
• Menný priestor Apple Podcasts: Na koreňovom prvku <rss> musí byť deklarovaný oficiálny menný priestor pre Apple Podcasts. Ak chýba, zobrazí sa chyba: „Deklarujte menný priestor Apple Podcasts na <rss>: ‹namespace›“.
• Prvok kanála: RSS feed musí obsahovať presne jeden priamy prvok <channel>. Ak ich obsahuje viac alebo žiadny, systém vráti chybu: „RSS musí obsahovať presne jeden priamy <channel>; nájdené ‹count›.“.

Požiadavky na kanál a epizódy podcastu

Validátor overuje prítomnosť a správnosť povinných polí pre samotný kanál (channel) aj pre jednotlivé epizódy (item).

Kontrola polí kanála a epizód

Ak v kóde chýba akékoľvek povinné pole pre RSS alebo Apple Podcasts, nástroj vygeneruje chybu: „Pridajte požadované ‹field›.“. Medzi ďalšie špecifické pravidlá patria:

• Adresy URL: Všetky odkazy definované v povinných poliach musia byť úplné a platné. Ak odkaz nie je správny, zobrazí sa chyba: „‹field› musí byť úplná adresa URL HTTP alebo HTTPS.“.
• Obrázky: Pre odkazy na obrázky platí rovnaké pravidlo. Ak je adresa neplatná, systém vráti chybu: „Nastavte itunes:image href na úplnú adresu URL HTTP alebo HTTPS.“.
• Kategórie: Prvok <itunes:category> nesmie byť prázdny. Ak chýba textový atribút, zobrazí sa chyba: „Pridajte neprázdny atribút text do itunes:category.“.
• Explicitný obsah: Prvok <itunes:explicit> musí byť nastavený výhradne na hodnotu "true" alebo "false". Akákoľvek iná hodnota vyvolá chybu: „Nastavte itunes:explicit na true alebo false.“.

Pravidlá pre epizódy

• Prítomnosť epizód: Kanál musí obsahovať aspoň jednu epizódu. Ak v kanáli chýba obsah, zobrazí sa chyba: „Pridajte do kanála aspoň jednu epizódu <item>.“.
• Seriálové relácie: Ak ide o seriálový typ relácie (serial), každá epizóda musí mať priradené kladné celé číslo. V opačnom prípade nástroj zobrazí chybu: „Seriálové relácie potrebujú pre každú epizódu kladné celé číslo itunes:episode.“.
• Duplicitné GUID: Každá epizóda musí mať jedinečný identifikátor GUID. Ak sa v kóde nachádza duplicita, systém zobrazí chybu: „Toto GUID opakuje hodnotu na riadku ‹first›.“.
• Počet epizód: Apple Podcasts má limit na počet zobrazovaných epizód. Ak váš feed obsahuje viac ako 2 000 položiek, nástroj vygeneruje varovanie: „Tento kanál má ‹count› epizód; Apple Podcasts zobrazuje iba 2 000 najnovších.“.

Validácia zvukových súborov (Enclosure)

Prvok <enclosure> definuje zvukový súbor danej epizódy. Validátor podrobne kontroluje jeho atribúty, avšak samotný zvukový súbor nesťahuje ani nedekóduje.

Pri kontrole elementu <enclosure> sa uplatňujú tieto pravidlá:

• Počet súborov: Každá epizóda musí obsahovať presne jeden prvok <enclosure>. Ak ich obsahuje viac, zobrazí sa chyba: „V tejto epizóde si ponechajte presne jeden <enclosure>; nájdené ‹count›.“.
• Chýbajúce atribúty: Ak v prvku chýba povinný atribút, systém vypíše chybu: „Pridajte požadovaný atribút ‹attribute› do <enclosure>.“.
• URL adresa média: Adresa URL v atribúte enclosure musí byť úplná a platná. Ak nie je, zobrazí sa chyba: „Nastavte atribút url prvku <enclosure> na úplnú adresu HTTP alebo HTTPS.“.
• Duplicitné URL: Každá adresa URL média musí byť v rámci feedu jedinečná. Ak sa rovnaká adresa zopakuje, nástroj nahlási chybu: „Táto adresa URL enclosure opakuje hodnotu v riadku ‹first›.“.
• Veľkosť súboru (length): Atribút length musí obsahovať celočíselnú hodnotu v bajtoch. Ak je hodnota neplatná, zobrazí sa chyba: „Nastavte atribút length prvku <enclosure> na celé číslo bajtov.“. Ak je veľkosť nastavená na 0, nástroj zobrazí varovanie: „Atribút length prvku <enclosure> je 0. Pred zverejnením overte skutočný počet bajtov.“.
• Typ MIME: Súbor musí mať platný typ MIME (napr. audio/mpeg). Ak je neplatný, zobrazí sa chyba: „Použite platný typ MIME, napríklad audio/mpeg.“. Ak typ MIME nezodpovedá zvukovému formátu, systém zobrazí varovanie: „Tento prvok nie je označený ako zvuk. Overte, či je epizóda zámerne video alebo dokument.“.
• Nezhoda prípony a typu: Ak prípona súboru v URL nezodpovedá deklarovanému typu MIME, nástroj vygeneruje varovanie: „Názov súboru média a typ MIME nesúhlasia (‹extension› vs. ‹mime›).“.

Formátovanie dátumu publikovania

Správne formátovanie dátumu je kľúčové pre chronologické zoradenie epizód v aplikáciách.

• Chýbajúci dátum: Ak epizóda nemá definovaný dátum publikovania, zobrazí sa varovanie: „Pridajte <pubDate>, aby si podcastové aplikácie mohli spoľahlivo objednať a zverejniť túto epizódu.“.
• Formát RFC 2822: Dátum musí striktne zodpovedať štandardu RFC 2822 s reálnym kalendárnym dňom a časovým pásmom. Pri nesprávnom formáte sa zobrazí chyba: „Použite dátum RFC 2822 so skutočným kalendárnym dátumom a časovým pásmom, napríklad: Sat, 01 Apr 2023 19:00:00 +0000.“.
• Pomenované časové pásma: Používanie textových názvov časových pásiem (napr. EST, GMT) je menej prenosné. Ak ich použijete, nástroj zobrazí varovanie: „Toto pomenované časové pásmo je akceptované, ale menej prenosné; uprednostňujte číselný posun, napríklad +0000.“.

Ochrana osobných údajov

Pri používaní tohto nástroja sú vaše dáta v bezpečí. Kanál podcastu sa kontroluje priamo vo vašom prehliadači. Prevádzkovateľ BroBroGo nič neodosiela na svoje servery ani neukladá žiadny obsah z vášho RSS feedu.

Často kladené otázky (FAQ)

Čo kontroluje tento Validátor podcastov RSS?

Kontroluje štruktúru RSS 2.0 XML, povinné polia RSS a bežné polia Apple Podcasts, atribúty <enclosure>, duplikáty a dátumy RFC 2822.

Testuje to zvukový súbor?

Kontroluje URL v <enclosure>, počet bajtov, typ MIME, jedinečnosť URL a zhodu názvu súboru s typom. Zvukový súbor nesťahuje ani nedekóduje.

Bude feed, ktorý prejde, akceptovaný všade?

Nie. Podcastové aplikácie a katalógy môžu uplatniť ďalšie pravidlá a vzdialené kontroly. Úspešný výsledok znamená iba to, že prilepený XML prešiel tu uvedenými statickými kontrolami.