Preverjevalnik RSS za podkaste

Kako deluje preverjanje vira RSS za podkaste

Preverjevalnik RSS za podkaste je specializirano orodje, ki analizira celoten XML-vir vašega podkasta in odkrije morebitne strukturne ali vsebinske napake. Orodje preveri skladnost s standardom RSS 2.0 in specifičnimi zahtevami platforme Apple Podcasts. Analiza poteka neposredno v uporabnikovem spletnem brskalniku, kar pomeni, da se vir podkasta preveri v vašem brskalniku in BroBroGo ničesar ne naloži ali shrani.

Orodje sprejme vnos v formatu XML do dolžine 500.000 znakov. Če vnos vsebuje več znakov, se izpiše opozorilo To orodje sprejme do ‹max› znakov na ček. V primeru predolgega izvajanja se prikaže sporočilo Preverjanje je trajalo predolgo. Poskusite z manjšim virom, če pa se postopek nepričakovano prekine, se izpiše Preverjanja ni bilo mogoče dokončati. Če poskusite zagnati preverjanje brez vnosa, vas orodje opozori s sporočilom Pred preverjanjem prilepite podcast RSS XML.

Zahteve za strukturo XML in korenski element

Da bi bil vir RSS prepoznan kot veljaven, mora strogo slediti pravilom oblikovanja XML. Če je koda XML napačno oblikovana, se izpiše napaka Popravite napačno oblikovano XML, nato znova preverite, podrobnejše informacije o napaki pa podaja vrstica Podrobnosti razčlenjevalnika: ‹detail›.

Pri preverjanju strukture veljajo naslednja pravila:

• Deklaracija DOCTYPE: V viru ne sme biti deklaracije DOCTYPE. Če jo orodje zazna, vrne napako Odstranite deklaracijo DOCTYPE, preden preverite ta feed.
• Korenski element: Koren dokumenta mora biti <rss>. Če temu ni tako, se izpiše napaka Koren dokumenta mora biti <rss>.
• Različica RSS: Atribut version elementa <rss> mora biti nastavljen točno na "2.0". V nasprotnem primeru se sproži napaka Atribut <rss> version nastavite na 2.0.
• Imenski prostor Apple Podcasts: Na korenskem elementu <rss> mora biti deklariran ustrezen imenski prostor za Apple Podcasts. Če ta manjka, se izpiše napaka Razglasite imenski prostor Apple Podcasts na <rss>: ‹namespace›.
• Element channel: RSS mora vsebovati točno en neposredni <channel>. Če je zaznano drugačno število teh elementov, se izpiše napaka RSS mora vsebovati točno en neposredni <channel>; našel ‹count›.

Obvezna polja kanala in nastavitve epizod

Vsak kanal podkasta zahteva določene metapodatke, ki omogočajo pravilno indeksiranje v imenikih. Če katero od obveznih polj manjka, orodje javi napako Dodajte zahtevani ‹field›.

Za elemente znotraj kanala veljajo naslednja pravila preverjanja:

• Spletne povezave: Vsa polja, ki predstavljajo povezave, morajo vsebovati popoln URL. Če povezava ni pravilna, se izpiše napaka ‹field› mora biti celoten URL HTTP ali HTTPS.
• Slike: Atribut href pri slikah mora biti pravilno oblikovan. Če ni, se prikaže napaka itunes:image href nastavite na celoten URL HTTP ali HTTPS.
• Kategorije: Element <itunes:category> ne sme biti prazen. Če je prazen, se sproži napaka V itunes:category dodajte neprazen atribut text.
• Eksplicitna vsebina: Oznaka <itunes:explicit> mora biti nastavljena na "true" ali "false". Vsaka druga vrednost sproži napako itunes:explicit nastavite na true ali false.
• Prisotnost epizod: Kanal mora vsebovati vsaj eno epizodo <item>. Če epizod ni, se izpiše napaka V kanal dodajte vsaj eno epizodo <item>.
• Serijske oddaje: Če gre za serijski tip podkasta, je zahtevano, da ima vsaka epizoda določeno zaporedno številko. Če ta manjka ali ni pravilna, se izpiše opozorilo Serijske oddaje potrebujejo pozitivno celo število itunes:episode za vsako epizodo.

Preverjanje zvočnih datotek in elementa enclosure

Element <enclosure> povezuje vašo epizodo z dejansko medijsko datoteko. Vsaka epizoda mora vsebovati natanko en element <enclosure>. Če jih je zaznanih več, se izpiše napaka V tej epizodi obdržite natanko en <enclosure>; našel ‹count›.

Orodje preverja naslednje atribute elementa <enclosure>:

• Manjkajoči atributi: Če v elementu manjka kateri od obveznih atributov, se izpiše napaka Dodajte zahtevani atribut ‹attribute› v <enclosure>.
• URL naslov: Atribut url mora biti popoln in veljaven spletni naslov. Če ni, se sproži napaka Atribut url elementa <enclosure> nastavite na celoten URL HTTP ali HTTPS.
• Dolžina datoteke: Atribut length mora vsebovati celo število, ki predstavlja velikost datoteke v bajtih. Če je vrednost neveljavna, se izpiše napaka Atribut length elementa <enclosure> nastavite na celo število bajtov. Če je dolžina nastavljena na 0, se prikaže opozorilo Atribut length elementa <enclosure> je 0. Pred objavo preverite dejansko število bajtov.
• Vrsta MIME: Atribut type mora vsebovati veljaven tip MIME. Če je neveljaven, se izpiše napaka Uporabite veljaven tip MIME, kot je audio/mpeg. Če medijski tip ne ustreza zvočnemu zapisu, se prikaže opozorilo Ta <enclosure> ni označen kot zvok. Preverite, ali je epizoda namenoma videoposnetek ali dokument.
• Ujemanje končnice in tipa: Orodje primerja končnico datoteke v URL-ju z navedenim tipom MIME. Če se ne ujemata, se izpiše opozorilo Ime medijske dateke in vrsta MIME se ne ujemata (‹extension› proti ‹mime›).
• Podvojeni URL-ji: Vsaka epizoda mora imeti edinstven URL medijske datoteke. Če se URL ponovi, orodje javi napako Ta enclosure URL ponavlja vrednost v vrstici ‹first›.

Orodje ne prenese in ne dekodira same zvočne datoteke, temveč zgolj statično preveri zapisane podatke v XML-ju.

Datumi objave, enolični identifikatorji in omejitve

Pravilno upravljanje časovnih podatkov in identifikatorjev preprečuje težave pri razvrščanju epizod v aplikacijah za poddaje.

Datumi objave (RFC 2822)

Vsaka epizoda mora imeti določen datum objave <pubDate>. Če ta manjka, se prikaže opozorilo Dodajte <pubDate>, da bodo lahko aplikacije za poddaje zanesljivo naročile in objavile to epizodo. Datumi morajo strogo slediti standardu RFC 2822 z realnim koledarskim datumom in časovnim pasom. Primer pravilno oblikovanega datuma je: Sat, 01 Apr 2023 19:00:00 +0000. Če je datum neveljaven, se izpiše napaka Uporabite datum RFC 2822 s pravim koledarskim datumom in časovnim pasom, na primer: Sat, 01 Apr 2023 19:00:00 +0000. Uporaba poimenovanih časovnih pasov (npr. GMT, CET) namesto številčnih odmikov sproži opozorilo Ta imenovani časovni pas je sprejet, vendar manj prenosljiv; raje številčni odmik, kot je +0000.

Enolični identifikatorji (GUID)

Vsaka epizoda mora imeti edinstven element <guid>. Če se vrednost GUID ponovi v več epizodah, se sproži napaka Ta GUID ponavlja vrednost v vrstici ‹first›.

Število epizod v viru

Čeprav lahko vir vsebuje poljubno število epizod, imajo platforme svoje omejitve pri prikazu. Če vir vsebuje več kot 2.000 epizod, se izpiše opozorilo Ta vir ima ‹count› epizod; Apple Podcasts prikaže samo 2.000 najnovejših.

Interpretacija rezultatov in odpravljanje težav

Po končanem preverjanju se pod naslovom Feed diagnoza izpiše povzetek stanja. Če vir nima napak, se prikaže sporočilo Ni najdenih strukturnih težav. Če so težave odkrite, se izpiše povzetek Najdene so napake ‹errors› in opozorila ‹warnings›. Posamezni rezultati so prikazani s številom napak (Napake ‹count›), opozoril (‹count› opozorila) in prepoznanih epizod (‹count› epizode).

Za lažje odpravljanje napak orodje natančno locira vsako težavo v kodi XML:

• Lokacija je določena z vrstico in stolpcem: Vrstica ‹line›, stolpec ‹column›.
• Prikazana je XPath pot do elementa: Popravek: ‹path›.
• Na voljo je neposredna povezava za skok na mesto napake: Pojdite na ‹path› v vrstici ‹line›.

Če je v viru preveliko število napak, se seznam skrajša, na kar opozori vrstica Prikazujem prve ‹shown› od ‹total› izdaj.

Upoštevajte, da uspešno opravljeno statično preverjanje ne zagotavlja, da bo zunanji imenik vaš vir brez težav sprejel. To je statično preverjanje zgradbe. URL-ji vira, naslovnice in predstavnosti se ne odprejo; razpoložljivost, število bajtov, dekodiranje zvoka in sprejem v imenik preverite ločeno.

Pogosta vprašanja (FAQ)

Kaj preverja ta Podcast RSS Validator?

Preverja zgradbo RSS 2.0 XML, obvezna polja RSS in pogosta polja Apple Podcasts, atribute <enclosure>, podvojene vrednosti in datume RFC 2822.

Ali testira zvočno datoteko?

Preveri URL v <enclosure>, število bajtov, vrsto MIME, enoličnost URL-ja in ujemanje imena datoteke z vrsto. Zvočne datoteke ne prenese ali dekodira.

Bo feed, ki prepusti, sprejet povsod?

Ne. Aplikacije za poddaje lahko dodajajo pravila in oddaljena preverjanja. Uspešno pomeni, da je prilepljeni XML opravil statična preverjanja, prikazana tukaj, ne pa, da ga bo imenik sprejel ali objavil.

Kje se obdelujejo moji podatki in ali so varni?

Vir podkasta se preveri v vašem brskalniku. BroBroGo ničesar ne naloži ali shrani.