Uppbygging og kröfur RSS 2.0 fyrir hlaðvörp
RSS 2.0 staðallinn er grunnurinn að dreifingu hlaðvarpa á netinu. Til þess að straumurinn teljist gildur þarf XML-skjalið að fylgja ströngum reglum um uppbyggingu. Þegar þú notar tól eins og Podcast RSS staðfestir er fyrst athugað hvort XML-kóðinn sé rétt myndaður.
Rót skjalsins verður að vera <rss> og version eigindið á <rss> verður að vera stillt á "2.0". Ef þessi gildi vantar eða eru röng, gefur tólið út villurnar „Rót skjalsins verður að vera <rss>.“ eða „Stilla <rss> útgáfuatribút til 2.0.“. Straumurinn má ekki innihalda DOCTYPE yfirlýsingu; ef hún er til staðar birtist villan „Fjarlægðu DOCTYPE yfirlýsinguna áður en þú athugar þennan straum.“. Ef XML-kóðinn er á einhvern hátt skemmdur eða ólesanlegur fyrir XML-þáttara, stöðvast greiningin með villunni „Lagfærðu röskuðu XML-inu, síðan staðfestu aftur.“.
Innan <rss> rótarinnar verður að vera nákvæmlega eitt beint <channel> stak. Ef fjöldi þeirra er annar en einn, til dæmis ef mörg rásarstök finnast, kemur fram villuboðið „RSS verður að innihalda nákvæmlega eitt bein <channel>; fundið ‹count›.“.
Sértækar kröfur fyrir Apple Podcasts
Apple Podcasts setur strangari kröfur en almenni RSS 2.0 staðallinn og krefst þess að sérstakt nafnarými sé skilgreint á <rss> stakinu. Ef þetta nafnarými vantar, mun tólið krefjast þess að þú skilgreinir það með villunni „Yfirlýsa Apple Podcasts nafnarými á <rss>: ‹namespace›“.
Auk nafnarýmisins eru ákveðnir reitir nauðsynlegir fyrir bæði rásina og einstaka þætti. Ef nauðsynlega reiti vantar, birtir tólið villuna „Bæta við nauðsynlegum ‹field›.“. Fyrir tengla og myndir gilda eftirfarandi reglur:
- Vefslóðir í almennum reitum verða að vera gildar: „
‹field›verður að vera fullkomið HTTP eða HTTPS vefslóð.“. - Myndatenglar í
<itunes:image>verða að vera réttir: „Stilla itunes:image href á fullkomna HTTP eða HTTPS vefslóð.“. - Flokkar verða að innihalda texta: „Bæta við textaatribúti sem ekki er autt á
<itunes:category>.“. - Skilgreining á því hvort efni sé viðkvæmt verður að vera skýr: „Stilla
<itunes:explicit>á true eða false.“.
Fyrir þætti í röð (e. serial shows) gildir sú regla að allir þættir verða að vera númeraðir á skipulegan hátt, annars birtist villan „Röðuleikhúsþættir þurfa jákvæða heiltölu itunes:episode fyrir hvern þátt.“. Rásin sjálf verður einnig að innihalda að minnsta kosti einn þátt, annars kemur fram villan „Bæta við að minnsta kosti einni <item> þætti á rásinni.“.
Greining á hljóðskrám og umbúðum (Enclosures)
Hver hlaðvarpsþáttur verður að innihalda nákvæmlega eitt <enclosure> stak sem vísar í hljóðskrána. Ef fleiri en eitt slíkt stak finnst í sama þættinum, gefur tólið villuna „Haltu nákvæmlega einni <enclosure> í þessum þætti; fundinn ‹count›.“.
Tólið greinir eiginleika <enclosure> staksins ítarlega án þess þó að hlaða niður eða afkóða sjálfa hljóðskrána. Eftirfarandi villur og viðvaranir geta komið fram við greiningu á umbúðum:
| Eiginleiki | Krafa / Prófun | Villa eða viðvörun í viðmóti |
|---|---|---|
| Vantar eigindi | Öll nauðsynleg eigindi verða að vera til staðar | „Bæta við nauðsynlegu ‹attribute› atributi til <enclosure>.“ |
| Vefslóð (url) | Verður að vera gild HTTP eða HTTPS slóð | „Stilltu url-eigindi á fulla HTTP- eða HTTPS-vefslóð.“ |
| Stærð (length) | Verður að vera heiltala í bætum | „Skráðu heiltölufjölda bæta í length-eigindi <enclosure>.“ |
| Stærð 0 | Lengd má ekki vera núll | „length-eigindi er 0. Staðfestu raunverulegan bætafjölda fyrir birtingu.“ |
| MIME-gerð | Verður að vera gilt snið, t.d. audio/mpeg |
„Nota gilt MIME-týpu eins og audio/mpeg.“ |
| Skráarsnið | Skráarending verður að passa við MIME-gerð | „Nafn miðils og MIME-týpa eru ósamræmanleg (‹extension› gegn ‹mime›).“ |
Ef MIME-gerðin vísar ekki til hljóðskrár, birtir tólið viðvörunina „Þetta <enclosure> er ekki merkt sem hljóð. Staðfestu að myndbands- eða skjalþáttur sé viljandi.“. Ef sama vefslóðin fyrir hljóðskrá er notuð oftar en einu sinni í straumnum, kemur fram villan „Þessi <enclosure> slóð endurtekur gildið á línu ‹first›.“.
Dagsetningar og auðkenni þátta
Dagsetningar í hlaðvarpsstraumum verða að fylgja RFC 2822 staðlinum til þess að hlaðvarpsforrit geti raðað þáttum rétt. Ef útgáfudag vantar alveg, birtir tólið viðvörunina „Bættu við <pubDate> svo hlaðvarpsforrit geti raðað og birt þennan þátt áreiðanlega.“.
Ef dagsetningin fylgir ekki staðlinum eða inniheldur óraunhæfar upplýsingar, birtist villan „Notaðu RFC 2822 dagsetningu með raunverulegum dagatalsdegi og tímabelti, til dæmis: Sat, 01 Apr 2023 19:00:00 +0000.“. Ef notað er nafngreint tímabelti (eins og GMT eða EST) í stað tölulegs fráviks, gefur tólið viðvörunina „Þetta nafngreinda tímabelti er viðurkennt en minna flytjanlegt; kýs tölulega hliðrun eins og +0000.“.
Hver þáttur verður einnig að hafa einstakt auðkenni (GUID). Ef sama GUID-gildið er notað á fleiri en einum stað, birtist villan „Þessi GUID endurtekur gildið á línu ‹first›.“.
Takmarkanir á stærð og fjölda þátta
Þótt tólið sé öflugt til að finna villur í uppbyggingu, þá hefur það ákveðin tæknileg takmörk. Tólið vinnur úr allt að 500.000 stöfum í einu. Ef textinn sem límdur er inn fer yfir þau mörk, birtast skilaboðin „Þetta tól tekur allt að ‹max› stafi á hverja athugun.“. Ef enginn texti er sleginn inn áður en smellt er á staðfestingu, birtast skilaboðin „Límdu Podcast RSS XML áður en þú staðfestir.“.
Ef vinnslan tekur of langan tíma eða stöðvast, sýnir tólið skilaboðin „Staðfestingin tók of langan tíma. Reyndu minni straum.“ eða „Staðfestingu gat ekki lokið.“. Ef XML-þáttarinn lendir í villu sem stöðvar greininguna, birtast upplýsingar undir „Sundurgreiningarupplýsingar: ‹detail›“.
Apple Podcasts og aðrar efnisveitur hafa einnig takmörk á því hversu marga þætti þau sýna í einu. Ef straumurinn þinn inniheldur mjög marga þætti, mun tólið gefa viðvörunina „Þessi straumur hefur ‹count› þætti; Apple Podcasts sýnir aðeins nýjustu 2.000.“. Ef villulistinn er mjög langur gæti tólið takmarkað birtinguna og sýnt skilaboðin „Sýnir fyrstu ‹shown› ‹total› vandamála.“.
Öryggi og vinnsla gagna
Þegar þú notar þetta tól fer öll greining fram beint í vafranum þínum. Hlaðvarpsstraumurinn þinn er athugaður í vafranum þínum. Ekkert er hlaðið upp né vistað af BroBroGo. Þetta tryggir að engin gögn eða óbirtar upplýsingar úr straumnum þínum berist til ytri netþjóna við prófunina.
Algengar spurningar
Hvað athugar þessi Podcast RSS Validator?
Hún athugar vel myndað RSS 2.0 XML, nauðsynlegt RSS og algeng Apple Podcasts rásar- og þáttasvæði, eiginleika í umbúðum, tvítekningar og dagsetningar RFC 2822.
Prófar það hljóðskrána?
Það athugar slóð hulstrsins, bætilengdargildi, MIME-gerð, sérstöðu og samræmi í skráarnafni/gerð. Það hleður ekki niður né afkóðar hljóðið.
Verður straumur sem stenst samþykktur alls staðar?
Nei. Hlaðvarpsforrit geta bætt við reglum og fjarprófunum. Samþykkt niðurstaða þýðir aðeins að límda XML-skjalið stóðst stöðuprófin sem sýnd eru hér, ekki að efnisveita muni samþykkja eða birta það.