Структура и захтеви RSS 2.0 стандарда за подкасте
Да би подкаст апликације исправно препознале и дистрибуирале ваш садржај, RSS XML мора бити усклађен са техничким спецификацијама RSS 2.0 стандарда. Овај алат врши статичку проверу како би осигурао да је структура датотеке потпуно исправна пре него што је пошаљете директоријумима.
Основни захтев је да корен документа мора бити <rss>. Уколико корен није исправно постављен, алат ће приказати грешку: "Корен документа мора бити <rss>.". Такође, атрибут version унутар ознаке <rss> мора имати вредност "2.0". Ако ова вредност одступа, појављује се грешка: "Поставите атрибут <rss> version на 2.0.".
Сваки валидан RSS канал мора да садржи тачно један директни <channel>. Уколико се унутар структуре детектује више ових елемената или ниједан, систем пријављује грешку: "RSS мора да садржи тачно један директни <channel>; пронађено ‹count›.". Додатно, уколико XML садржи DOCTYPE декларацију, она се мора уклонити пре валидације. У супротном, алат исписује поруку: "Уклоните DOCTYPE декларацију пре провере овог feed.".
Специфични захтеви за Apple Podcasts платформу
Поред општих RSS 2.0 правила, већина модерних апликација за подкасте ослања се на метаподатке које је дефинисала платформа Apple Podcasts. Први корак у омогућавању ових напредних поља је исправна декларација простора имена (namespace) на <rss> ознаци. Ако овај простор имена недостаје или је неисправан, алат јавља грешку: "Објавите простор имена Apple Podcasts на <rss>: ‹namespace›".
Посебна пажња се посвећује следећим елементима канала и епизода:
- Категорије: Свака категорија мора бити исправно дефинисана. Ако ознака нема вредност, појављује се грешка: "Додајте непразан атрибут text у itunes:category.".
- Експлицитан садржај: Ознака
<itunes:explicit>мора бити стриктно дефинисана. Уколико вредност одступа, алат приказује грешку: "Поставите itunes:explicit на true или false.". - Серијски подкасти: Ако је формат емисије подешен као серијски (serial), свака појединачна епизода мора имати јасно дефинисан редослед. Ако то није случај, јавља се грешка: "Серијским емисијама је потребан позитиван цео број itunes:episode за сваку епизоду.".
Такође, постоји ограничење у броју епизода које велики директоријуми могу да процесирају. Ако ваш канал премаши овај број, алат ће издати упозорење: "Овај канал има ‹count› епизода; Apple Podcasts приказује само 2.000 најновијих.".
Валидација аудио датотека и enclosure атрибута
Елемент <enclosure> је кључни део сваке епизоде јер садржи директну везу до аудио датотеке. Свака епизода мора имати тачно један <enclosure> елемент. Ако се детектује више ових елемената, алат јавља грешку: "Задржите тачно један <enclosure> у овој епизоди; пронађено ‹count›.".
Алат детаљно анализира следеће атрибуте унутар <enclosure> ознаке:
| Атрибут | Захтев за исправност | Грешка / Упозорење у случају неисправности |
|---|---|---|
url |
Мора бити потпуна HTTP или HTTPS адреса | "Поставите атрибут url елемента <enclosure> на потпуну HTTP или HTTPS URL адресу." |
length |
Мора бити цео број који представља величину у бајтовима | "Поставите атрибут length елемента <enclosure> на цео број бајтова." |
type |
Мора бити важећи MIME тип (нпр. audio/mpeg) | "Користите важећи тип MIME као што је audio/mpeg." |
Ако је вредност атрибута length постављена на 0, систем ће издати упозорење: "Атрибут length елемента <enclosure> је 0. Пре објављивања проверите стварни број бајтова.". Уколико MIME тип не указује на аудио формат, појављује се упозорење: "Овај <enclosure> није означен као аудио. Проверите да ли је епизода намерно видео или документ.". Такође, ако се екстензија датотеке у URL-у не поклапа са дефинисаним MIME типом, алат приказује упозорење: "Име медијске датотеке и тип MIME се не слажу (‹extension› вс ‹mime›).".
Форматирање датума према RFC 2822 стандарду
Исправно форматирање датума објављивања унутар <pubDate> ознаке је неопходно како би апликације могле хронолошки да поређају епизоде. Ако овај елемент уопште недостаје, алат приказује упозорење: "Додајте <pubDate> тако да апликације за подкаст могу поуздано наручити и објавити ову епизоду.".
Датум мора бити написан строго у складу са RFC 2822 стандардом, користећи валидне календарске вредности и временске зоне. Пример исправног формата је: Sat, 01 Apr 2023 19:00:00 +0000. Ако датум одступа од овог шаблона, систем генерише грешку: "Користите датум RFC 2822 са стварним календарским датумом и временском зоном, на пример: Sat, 01 Apr 2023 19:00:00 +0000.".
Употреба текстуалних назива за временске зоне (нпр. GMT, EST) уместо нумеричких помака је дозвољена, али се не препоручује због компатибилности. У том случају, алат ће издати упозорење: "Ова именована временска зона је прихваћена, али мање преносива; преферирају нумерички помак као што је +0000.".
Како тумачити резултате дијагнозе и исправљати грешке
Након што унесете свој XML и покренете проверу, алат приказује одељак "Feed дијагноза". На врху овог одељка видећете сумарни приказ стања канала, као што су "‹count› грешке", "‹count› упозорења" и "‹count› епизоде". Ако је све у реду, приказаће се порука: "Нису пронађени структурни проблеми.". У супротном, видећете поруку: "Пронађене су ‹errors› грешке и ‹warnings› упозорења.".
Сваки пронађени проблем садржи тачне координате унутар вашег документа како бисте га лакше пронашли и исправили:
- Локација: Ознака "Ред
‹line›, колона‹column›" упућује на тачно место у коду где је проблем настао. - Путања: Ознака "Поправка:
‹path›" приказује XPath путању до неисправног елемента. - Брзи прелаз: Линк "Идите на
‹path›на линији‹line›" омогућава вам да тренутно скочите на део кода који захтева измену.
Уколико је број грешака превелики, листа може бити скраћена ради прегледности, уз напомену: "Приказ првих ‹shown› издања ‹total›.". Ако дође до озбиљне грешке у самој структури XML-а због које парсер не може да настави рад, алат ће приказати поруку: "Поправите неисправан XML, а затим поново потврдите." уз пратећу информацију "Детаљ парсера: ‹detail›".
Приватност података и техничка ограничења
Овај алат је дизајниран тако да се комплетна провера вашег подкаст канала обавља директно у вашем веб прегледачу. Садржај који налепите се не шаље на спољне сервере, што значи да се RSS канал подкаста проверава у вашем прегледачу и BroBroGo ништа не отпрема нити чува.
Приликом коришћења алата треба имати на уму следећа техничка ограничења и правила:
- Максимална величина: Алат прихвата унос до највише 500.000 знакова по једној провери. Ако прекорачите овај лимит, приказаће се порука: "Овај алат прихвата до
‹max›знакова по провери.". - Време извршавања: Уколико је датотека превелика или превише комплексна, може доћи до прекорачења времена за анализу, при чему се исписује порука: "Провера је трајала предуго. Пробајте мањи канал.". Ако процес уопште не успе да се заврши, видећете поруку: "Валидација није могла да се заврши.".
- Статичка природа провере: Ово је искључиво статичка провера структуре. Алат не преузима нити декодира аудио датотеке, нити отвара URL адресе канала, насловне слике и медије. Због тога је потребно да самостално и посебно проверите доступност линкова, стварни број бајтова, исправност декодирања звука и услове за прихватање у конкретним директоријумима.
Често постављана питања (FAQ)
Шта проверава овај Подцаст RSS Валидатор?
Проверава структуру RSS 2.0 XML-а, обавезна RSS и уобичајена Apple Podcasts поља, атрибуте елемента <enclosure>, дупликате и RFC 2822 датуме.
Да ли тестира аудио датотеку?
Проверава URL у елементу <enclosure>, број бајтова, MIME тип, јединственост URL-а и подударање имена са типом датотеке. Аудио се не преузима нити декодира.
Да ли ће feed који пролази бити прихваћен свуда?
Не. Подцаст апликације могу да додају правила и даљинске провере. Пролазак значи да је налепљени XML испунио статичке провере приказане овде, а не да ће га директоријум прихватити или објавити.
Шта значи упозорење о дуплираним GUID вредностима?
Свака епизода мора имати јединствени идентификатор (GUID). Ако алат пронађе исти GUID на више места, приказаће грешку: "Овај ГУИД понавља вредност у реду ‹first›." како бисте спречили преклапање епизода у апликацијама.