Podcasti RSS-validaator

Podcasti RSS-voo struktuur ja nõuded

Podcasti RSS-voog põhineb RSS 2.0 spetsifikatsioonil, mis määrab kindlaks XML-dokumendi ülesehituse ja kohustuslikud andmeväljad. Selleks, et taskuhäälingusaated jõuaksid kuulajateni ja erinevatesse platvormidesse, peab XML-fail olema tehniliselt korrektne ja järgima kindlaid reegleid.

Validaator kontrollib sisestatud XML-koodi vastavust standarditele. Dokumendi juurelement peab olema <rss> ning selle atribuut version peab olema seatud väärtusele "2.0". Kui need tingimused ei ole täidetud, kuvatakse veateated "Dokumendi juur peab olema <rss>." või "Sea <rss> atribuut version väärtusele 2.0.". Samuti peab <rss> elemendil olema deklareeritud Apple Podcastsi nimeruum. Vastasel juhul kuvatakse teade "Kuuluta Apple Podcastsi nimeruum <rss>: ‹namespace›".

RSS-voog peab sisaldama täpselt ühte vahetut <channel>-elementi. Kui elementide arv erineb nõutust, kuvatakse viga "RSS peab sisaldama täpselt ühte vahetut <channel>-elementi; leiti ‹count›.". Kanali tasemel kontrollitakse kohustuslike väljade olemasolu. Kui mõni nõutud väli on puudu, kuvatakse teade "Lisa vajalik ‹field›.". Linkide ja piltide puhul kontrollitakse nende vormingut. Vigaste linkide korral kuvatakse veateade "‹field› peab olema täielik HTTP või HTTPS URL." ning piltide puhul "Määra itunes:image href täielikuks HTTP või HTTPS URL-iks.".

Kategooriate määramisel peab <itunes:category> sisaldama korrektset väärtust, vastasel juhul kuvatakse viga "Lisa itunes:category-le mittetühi atribuut text.". Sisu sobivuse märgis <itunes:explicit> peab olema täpselt määratletud, vastasel juhul kuvatakse teade "Sea itunes:explicit väärtusele true või false.".

Episoodide ja meediafailide valideerimine

Iga toimiv podcasti kanal peab sisaldama vähemalt ühte episoodi. Kui episoode ei leita, kuvatakse viga "Lisa kanalile vähemalt üks <item> episood.". Seriaalsete saadete puhul on nõutud, et igal episoodil oleks määratud järjekorranumber, vastasel juhul kuvatakse teade "Seriaalsarjad vajavad iga episoodi jaoks positiivset täisarvulist itunes:episode.".

Meediafailide edastamiseks kasutatakse <enclosure> elementi. Igas episoodis peab olema täpselt üks <enclosure> element. Kui neid on rohkem või puudub see üldse, kuvatakse viga "Jäta sellesse episoodi täpselt üks <enclosure>; leiti ‹count›.".

Validaator kontrollib põhjalikult <enclosure> elemendi atribuute:

• Atribuutide olemasolu: Kui mõni vajalik atribuut puudub, kuvatakse teade "Lisa <enclosure> vajalik ‹attribute› atribuut.".
• URL-i korrektsus: Atribuut url peab viitama korrektsele aadressile, vastasel juhul kuvatakse viga "Määra <enclosure>’i atribuudile url täielik HTTP- või HTTPS-URL.".
• Faili suurus: Atribuut length peab väljendama faili suurust baitides täisarvuna. Vigase väärtuse korral kuvatakse teade "Sisesta <enclosure>’i atribuudile length baitide täisarvuline arv.". Kui pikkuseks on märgitud 0, kuvatakse hoiatus "<enclosure>’i atribuut length on 0. Kontrolli enne avaldamist tegelikku baitide arvu.".
• MIME-tüüp: Faili tüüp peab olema korrektne. Vigase tüübi puhul kuvatakse teade "Kasuta kehtivat MIME-tüüpi, näiteks audio/mpeg.". Kui fail ei ole märgitud helifailiks, kuvatakse hoiatus "See <enclosure> ei ole märgitud heliks. Veendu, et video- või dokumendiepisood on tahtlik.".
• Failinime ja tüübi vastavus: Kui faililaiend ja MIME-tüüp ei kattu, kuvatakse hoiatus "Meedia failinimi ja MIME tüüp ei ühti (‹extension› vs ‹mime›).".

Duplikaatide vältimiseks kontrollitakse, et meediafailide URL-id ja episoodide unikaalsed tunnused (GUID) ei korduks. Duplikaatide leidmisel kuvatakse veateated "See manuse URL kordab väärtust real ‹first›." või "See GUID kordab väärtust real ‹first›.".

Kuupäevade vormindamine ja episoodide piirangud

Episoodide avaldamise kuupäevad peavad vastama RFC 2822 standardile, mis tagab, et podcasti rakendused suudavad episoode õigesti järjestada. Kui avaldamiskuupäev <pubDate> puudub, kuvatakse hoiatus "Lisa <pubDate>, et taskuhäälingu rakendused saaksid selle episoodi usaldusväärselt järjestada ja avaldada.".

Vale kuupäeva vormingu puhul kuvatakse veateade "Kasuta RFC 2822 kuupäeva koos tegeliku kalendripäeva ja ajavööndiga, näiteks: Sat, 01 Apr 2023 19:00:00 +0000.". Kui kuupäevas kasutatakse tekstilist ajavööndit numbrilise nihke asemel, kuvatakse hoiatus "Seda nimetatud ajavööndit aktsepteeritakse, kuid see on vähem ülekantav; eelistatud on numbriline nihkeväärtus, näiteks +0000.".

Suurte voogude puhul tuleb arvestada platvormide piirangutega. Kui voog sisaldab üle 2000 episoodi, kuvatakse hoiatus "Selles voos on ‹count› episoodi; Apple Podcasts kuvab ainult viimased 2000.".

Vigade tuvastamine ja parandamine

Tööriist võimaldab tuvastada XML-i struktuurivigu ja muid tehnilisi puudusi. Kui sisestatud XML on vigane, kuvatakse teade "Paranda moonutatud XML ja valideeri uuesti.". Kui voos on DOCTYPE deklaratsioon, kuvatakse viga "Eemalda DOCTYPE deklaratsioon enne selle voo kontrollimist.".

Valideerimise tulemused kuvatakse jaotises "Voo diagnostika". Tulemustes näidatakse leitud vigade, hoiatuste ja episoodide arv. Kui probleeme ei leita, kuvatakse teade "Struktuurseid probleeme ei leitud.". Vigade esinemisel kuvatakse kokkuvõte "Leiti ‹errors› viga ja ‹warnings› hoiatust.".

Iga tuvastatud probleemi juures näidatakse selle täpne asukoht reas ja veerus vormingus "Rida ‹line›, veerg ‹column›" ning XPath-stiilis tee elemendini vormingus "Paranda: ‹path›". Kasutaja saab kasutada linki "Mine ‹path› juurde real ‹line›", et liikuda otse vigase elemendi juurde. Kui probleeme on väga palju, võidakse nimekiri lühendada, kuvades teate "Kuvatakse esimesed ‹shown› probleemid koguarvust ‹total›.". Kui XML-i parsimisel tekkis tõrge, kuvatakse lisateave kujul "Parseri detail: ‹detail›".

Privaatsus ja tehnilised piirangud

Sinu podcasti voogu kontrollitakse sinu brauseris. BroBroGo ei lae midagi üles ega salvesta. Tööriist teostab staatilist struktuurikontrolli. Voo, kaanepildi ega meedia URL-e ei avata, mis tähendab, et meediafaile ei laadita alla ega dekodeerita. Kasutaja peab eraldi kontrollima failide kättesaadavust, tegelikku baitide arvu, heli dekodeerimist ja podcastikataloogide heakskiitu.

Tööriistal on järgmised tehnilised piirangud ja erijuhtumid:

• Maksimaalne lubatud sisendi suurus on 500 000 märki ühe kontrolli kohta. Kui limiit on ületatud, kuvatakse teade "See tööriist aktsepteerib kuni ‹max› märki ühe kontrolli kohta.".
• Kui valideerimine võtab liiga kaua aega, kuvatakse teade "Kontroll võttis liiga kaua aega. Proovi väiksemat voogu.".
• Kui kontrolli ei õnnestu lõpule viia, kuvatakse teade "Kontrolli ei saanud lõpetada.".
• Kui kasutaja üritab valideerida tühi sisendvälja, kuvatakse teade "Kleebi Podcast RSS XML enne valideerimist.".

Korduma kippuvad küsimused

Mida see Podcast RSS Validaator kontrollib?

See kontrollib, kas RSS 2.0 XML on korrektselt vormistatud, kas kohustuslikud RSS-i ning levinud Apple Podcastsi kanali- ja episoodiväljad on olemas, samuti <enclosure>-i atribuute, duplikaate ja RFC 2822 kuupäevi.

Kas see testib helifaili?

See kontrollib <enclosure>-i URL-i ja pikkust baitides, MIME-tüüpi, duplikaate ning failinime ja tüübi vastavust. Heli ei laadita alla ega dekodeerita.

Kas voog, mis läbib kontrolli, aktsepteeritakse kõikjal?

Ei. Podcasti rakendused võivad lisada reegleid ja kaugkontrolle. Läbimine tähendab, et kleebitud XML vastas siin kuvatud staatilistele kontrollidele, mitte et kataloog selle aktsepteerib või avaldab.