Aplāžu RSS pārbaudītājs

RSS 2.0 struktūras un Apple Podcasts prasības aplāžu plūsmām

Aplāžu izplatīšanas pamatā ir RSS 2.0 specifikācija, kas papildināta ar specifiskiem metadatu laukiem, lai nodrošinātu saderību ar tādām platformām kā Apple Podcasts. Lai plūsma būtu derīga, dokumenta saknei ir jābūt <rss> ar atribūtu version, kura vērtība ir precīzi "2.0". Tāpat uz <rss> elementa ir jābūt deklarētai Apple Podcasts nosaukumvietai.

RSS struktūrā ir jābūt ietvertam tieši vienam tiešajam <channel> elementam. Ja šis nosacījums netiek izpildīts, rīks uzrāda kļūdu. Kanālam ir jāsatur vismaz viena sērija, un katrai sērijai ir jābūt aprakstītai ar atsevišķu <item> elementu. Seriālu pārraidēm (serial shows) katrai sērijai ir nepieciešams pozitīvs vesels skaitlis <itunes:episode> elementā.

Papildus tam tiek pārbaudīti arī citi specifiski kanāla un sēriju lauki:

• Obligāto lauku esamība. Ja kāds no tiem trūkst, tiek parādīts paziņojums: "Pievienojiet nepieciešamo ‹field›.".
• Saites un attēli. Tādiem laukiem kā kanāla saite vai attēla avots ir jābūt pilnīgiem URL. Ja tie ir kļūdaini, rīks izvada kļūdu: "‹field› ir jābūt pilnīgam vietrādim URL HTTP vai HTTPS." vai "Iestatiet itunes:image href uz pilnu URL HTTP vai HTTPS.".
• Kategorijas. Atribūtam <itunes:category> ir jābūt pareizi aizpildītam: "Pievienojiet atribūtu text, kas nav tukšs, atribūtam itunes:category.".
• Satura ierobežojumu norāde. Elementam <itunes:explicit> ir jābūt iestatītam kā "true" vai "false".

Audio failu un enclosure atribūtu validācija

Katrā aplādes sērijas <item> elementā drīkst būt tieši viens <enclosure> elements, kas norāda uz sērijas audio failu. Ja tiek atrasti vairāki šādi elementi, rīks ziņo par kļūdu: "Saglabājiet tieši vienu <enclosure> šajā epizodē; atrasts ‹count›.".

Validācijas laikā tiek rūpīgi pārbaudīti visi <enclosure> atribūti:

• URL adrese: Tam ir jābūt pilnīgam un pareizam tīmekļa vietrādim. Pretējā gadījumā tiek parādīta kļūda: "Iestatiet <enclosure> atribūtam url pilnu HTTP vai HTTPS URL.".
• Faila izmērs (length): Atribūtam length ir jāatspoguļo faila izmērs baitos. Ja vērtība nav derīga, parādās kļūda: "Iestatiet <enclosure> atribūtam length veselu baitu skaitu.". Ja norādītais izmērs ir 0, rīks izvada brīdinājumu: "<enclosure> atribūta length vērtība ir 0. Pirms publicēšanas pārbaudiet faktisko baitu skaitu.".
• MIME tips: Ir jāizmanto derīgs multivides tips, piemēram, audio/mpeg. Ja tips nav derīgs, tiek parādīta kļūda: "Izmantojiet derīgu MIME tipu, piemēram, audio/mpeg.". Ja fails nav reģistrēts kā audio, tiek parādīts brīdinājums: "Šis enclosure nav atzīmēts kā audio. Pārbaudiet, vai epizode apzināti publicēta kā video vai dokuments.".
• Faila paplašinājuma saderība: Ja faila nosaukuma paplašinājums nesakrīt ar norādīto MIME tipu, rīks brīdina: "Multivides faila nosaukums un MIME tips nesakrīt (‹extension› vs ‹mime›).".

Rīks arī pārbauda, vai plūsmā nav dublētu audio failu URL, kas var izraisīt kļūdainu sēriju attēlošanu lietotnēs: "Šis enclosure URL atkārto vērtību rindā ‹first›.".

Datumu formāts un dublikātu novēršana

Pareizs datuma formāts ir būtisks, lai aplāžu atskaņotāji spētu hronoloģiski sakārtot sērijas. Katrai sērijai ir ieteicams norādīt publicēšanas datumu <pubDate>. Ja tas trūkst, tiek parādīts brīdinājums: "Pievienojiet <pubDate>, lai aplādes lietotnes varētu droši pasūtīt un publicēt šo sēriju.".

Datumiem ir jāatbilst RFC 2822 standartam. Ja datums ir kļūdains vai neeksistējošs, rīks uzrāda kļūdu: "Izmantojiet RFC 2822 datumu ar reālu kalendāra datumu un laika joslu, piemēram: Sat, 01 Apr 2023 19:00:00 +0000.". Lai gan laika joslu nosaukumi (piemēram, EST vai GMT) dažreiz tiek pieņemti, tie ir mazāk saderīgi, tādēļ rīks izvada brīdinājumu: "Šī nosauktā laika josla ir pieņemta, bet mazāk pārnēsājama; dod priekšroku skaitļu nobīdei, piemēram, +0000.".

Vēl viena bieža problēma ir unikālo identifikatoru jeb <guid> dublēšanās starp sērijām. Ja divām sērijām ir vienāds GUID, rīks ziņo: "Šis GUID atkārto vērtību rindā ‹first›.". Tāpat tiek pārbaudīts kopējais sēriju skaits plūsmā. Ja to skaits pārsniedz 2000, tiek parādīts brīdinājums: "Šajā plūsmā ir ‹count› epizodes; Apple Podcasts rāda tikai 2 000 jaunākās.".

XML kļūdu labošana un diagnostikas rīki

Ja augšupielādētais XML kods ir nepareizi noformēts vai satur neatļautus elementus, rīks palīdz ātri identificēt problēmas vietu. Ja plūsmā ir iekļauta DOCTYPE deklarācija, validācija tiek apturēta ar kļūdu: "Pirms šī feed pārbaudes noņemiet deklarāciju DOCTYPE.". Ja XML struktūra ir bojāta (piemēram, nav aizvērti tagi), tiek parādīts paziņojums: "Izlabojiet nepareizi veidoto XML un pēc tam vēlreiz apstipriniet.".

Rīks nodrošina precīzu norādi uz kļūdas vietu, izmantojot šādus elementus:

• Atrašanās vieta: "Līnija ‹line›, kolonna ‹column›".
• XML ceļš: "Labojums: ‹path›".
• Tiešā saite: "Dodieties uz ‹path› līniju ‹line›".

Ja XML parsētājs saskaras ar specifisku sistēmas kļūdu, tā tiek attēlota kā "Parsētāja informācija: ‹detail›". Ja rīks atrod pārāk daudz kļūdu, saraksts var tikt saīsināts, parādot paziņojumu: "Tiek rādītas pirmās ‹shown› no ‹total› problēmām.".

Privātums un tehniskie ierobežojumi

Aplāžu RSS pārbaudītājs nodrošina pilnīgu datu apstrādi lokāli. Aplādes plūsma tiek pārbaudīta jūsu pārlūkprogrammā. BroBroGo neko neaugšupielādē un nesaglabā.

Rīkam ir noteikti tehniski ierobežojumi un darbības nosacījumi:

• Maksimālais ievades apjoms ir 500 000 rakstzīmju. Ja šis limits tiek pārsniegts, parādās paziņojums: "Šis rīks vienā čekā pieņem līdz pat ‹max› rakstzīmēm.".
• Ja validācijas process aizņem pārāk daudz laika, sistēma pārtrauc darbu ar paziņojumu: "Pārbaude aizņēma pārāk ilgu laiku. Izmēģiniet mazāku plūsmu.".
• Ja rodas neparedzēta kļūda, tiek parādīts uzraksts: "Validāciju nevarēja pabeigt.".
• Ja mēģināt veikt pārbaudi bez ievadīta teksta, rīks atgādina: "Pirms apstiprināšanas ielīmējiet Podcast RSS XML.".

Jāņem vērā, ka šī ir statiska struktūras pārbaude. Plūsmas, vāka un multivides URL netiek atvērti; atsevišķi jāpārbauda pieejamība, baitu skaits, audio dekodēšanu un pieņemšanu katalogā. Rīks nelejupielādē un nedekodē pašu audio failu.

Biežāk uzdotie jautājumi (FAQ)

Ko pārbauda šis Podcast RSS Validator? Tas pārbauda RSS 2.0 XML struktūru, obligātos RSS un ierastos Apple Podcasts laukus, <enclosure> atribūtus, dublikātus un RFC 2822 datumus.

Vai tas pārbauda audio failu? Tas pārbauda <enclosure> URL, baitu skaitu, MIME tipu, URL unikalitāti un faila nosaukuma atbilstību tipam. Audio fails netiek lejupielādēts vai dekodēts.

Vai feed, kas nokārtos, tiks pieņemts visur? Nē. Aplāžu lietotnes un katalogi var piemērot papildu noteikumus un attālās pārbaudes. Sekmīgs rezultāts nozīmē tikai to, ka ielīmētais XML izturēja šeit parādītās statiskās pārbaudes.