Walidator podcastu RSS

Struktura i wymagania formatu RSS 2.0 dla podcastów

Prawidłowo sformatowany kanał RSS podcastu opiera się na standardzie RSS 2.0, który wymaga ścisłego przestrzegania reguł składniowych języka XML. Narzędzie Walidator podcastu RSS weryfikuje poprawność strukturalną przesłanego kodu XML, sprawdzając, czy dokument jest dobrze sformułowany.

Podstawowym warunkiem poprawności technicznej jest to, aby elementem głównym dokumentu był <rss>. Każdy plik musi posiadać deklarację wersji, co oznacza konieczność ustawienia atrybutu version elementu <rss> na wartość "2.0". Niedopuszczalne jest stosowanie deklaracji typu dokumentu – w przypadku wykrycia takiej deklaracji walidator wyświetli błąd: "Usuń deklarację DOCTYPE przed sprawdzeniem tego feed.". Jeśli sam kod XML jest uszkodzony lub zawiera błędy składniowe, dalsza analiza nie jest możliwa, a użytkownik zobaczy komunikat: "Napraw zniekształcony plik XML, a następnie zatwierdź ponownie.".

W strukturze dokumentu RSS musi znajdować się dokładnie jeden bezpośredni element <channel>. Wewnątrz tego elementu wymagane jest umieszczenie co najmniej jednego odcinka (elementu <item>), aby kanał mógł zostać uznany za prawidłowy podcast. W przypadku braku wymaganych pól strukturalnych, narzędzie wskazuje precyzyjną lokalizację problemu i generuje komunikat: "Dodaj wymagane pole ‹field›.".

Specyficzne wymagania dla platformy Apple Podcasts

Katalog Apple Podcasts oraz aplikacje kompatybilne z jego standardem nakładają dodatkowe ograniczenia na strukturę kanału RSS. Aby te metadane były poprawnie interpretowane, na elemencie <rss> musi zostać zadeklarowana oficjalna przestrzeń nazw Apple Podcasts.

Do kluczowych reguł walidacyjnych powiązanych z tym standardem należą:

• Weryfikacja kategorii: Każda zdefiniowana kategoria musi być poprawnie sformatowana. W przypadku błędów walidator zgłasza błąd: "Dodaj niepusty atrybut text do itunes:category.".
• Oznaczenie treści jawnych: Element <itunes:explicit> musi przyjmować wyłącznie określone wartości logiczne. Nieprawidłowe wartości wywołują błąd: "Ustaw itunes:explicit na true lub false.".
• Numeracja dla seriali: Jeśli podcast jest oznaczony jako serial (serial show), wymagane jest podanie dodatniej liczby całkowitej dla każdego odcinka. W przeciwnym razie system zgłosi błąd: "Seriale wymagają dodatniej liczby całkowitej itunes:episode dla każdego odcinka.".
• Liczba odcinków: Choć technicznie kanał może zawierać dowolną liczbę pozycji, Apple Podcasts nakłada ograniczenie prezentacji. Jeśli kanał zawiera więcej niż 2000 odcinków, walidator wyświetli ostrzeżenie: "Ten kanał ma ‹count› odcinków; Apple Podcasts wyświetla tylko 2000 najnowszych.".

Walidacja plików multimedialnych i elementu enclosure

Element <enclosure> odpowiada za wskazanie fizycznego pliku audio lub wideo powiązanego z danym odcinkiem podcastu. Każdy odcinek (element <item>) musi zawierać dokładnie jeden element <enclosure>. Obecność wielu takich elementów w jednym odcinku jest błędem. Walidator szczegółowo analizuje atrybuty elementu <enclosure> pod kątem następujących kryteriów:

1. Kompletność atrybutów: Brak któregokolwiek z wymaganych parametrów skutkuje błędem: "Dodaj wymagany atrybut ‹attribute› do <enclosure>.".
2. Adres URL: Atrybut url musi wskazywać na pełny, poprawny adres internetowy. Błędny format wywołuje komunikat: "Ustaw atrybut url elementu <enclosure> na pełny adres HTTP lub HTTPS.". Narzędzie sprawdza również unikalność adresów – powtórzenie tego samego pliku w różnych odcinkach wywoła błąd: "Ten adres URL elementu <enclosure> powtarza wartość z wiersza ‹first›.".
3. Rozmiar pliku: Atrybut length musi określać wielkość pliku w bajtach jako liczbę całkowitą. Wpisanie wartości niebędącej liczbą wywoła błąd: "Ustaw atrybut length elementu <enclosure> na całkowitą liczbę bajtów.". Wartość równa 0 jest dopuszczalna, lecz generuje ostrzeżenie: "Atrybut length elementu <enclosure> ma wartość 0. Przed publikacją potwierdź rzeczywistą liczbę bajtów.".
4. Typ MIME: Typ multimediów musi być prawidłowy (np. audio/mpeg). Użycie niepoprawnego typu skutkuje błędem: "Użyj prawidłowego typu MIME, takiego jak audio/mpeg.". Jeśli typ MIME wskazuje na format inny niż audio, narzędzie wyświetli ostrzeżenie: "Ten element <enclosure> nie jest oznaczony jako audio. Potwierdź, że odcinek ma być plikiem wideo lub dokumentem.". Dodatkowo weryfikowana jest spójność rozszerzenia pliku w adresie URL z deklarowanym typem MIME; niezgodność generuje ostrzeżenie: "Nazwa pliku multimedialnego i typ MIME nie są zgodne (‹extension› vs ‹mime›).".

Formatowanie dat publikacji (RFC 2822)

Prawidłowe określenie czasu publikacji odcinka w elemencie `` jest niezbędne do poprawnego sortowania i dystrybucji treści w aplikacjach klienckich. Brak tego elementu wywołuje ostrzeżenie: "Dodaj <pubDate>, aby aplikacje podcastowe mogły prawidłowo sortować i publikować ten odcinek.".

Standard RSS wymaga stosowania formatu daty zgodnego ze specyfikacją RFC 2822. Data musi reprezentować realny dzień w kalendarzu oraz zawierać określenie strefy czasowej. Wszelkie odstępstwa od tego formatu powodują błąd: "Użyj daty RFC 2822 z rzeczywistą datą kalendarzową i strefą czasową, na przykład: Sat, 01 Apr 2023 19:00:00 +0000.".

W kwestii stref czasowych zaleca się stosowanie przesunięć liczbowych (np. +0000) zamiast nazw słownych. Choć nazwane strefy czasowe są technicznie akceptowane przez parser, walidator wyświetli ostrzeżenie o ograniczonej kompatybilności: "Ta nazwana strefa czasowa jest akceptowana, ale ma gorszą zgodność; wybierz przesunięcie liczbowe, np. +0000.".

Identyfikatory GUID i unikanie duplikatów

Unikalny identyfikator odcinka (GUID) pozwala czytnikom podcastów jednoznacznie stwierdzić, czy dany odcinek został już pobrany lub odtworzony przez użytkownika. Każdy odcinek powinien posiadać unikalną wartość w elemencie <guid>. Powielenie identyfikatora GUID użytego w innym miejscu kanału jest poważnym błędem strukturalnym, który walidator sygnalizuje komunikatem: "Ten identyfikator GUID powtarza wartość w wierszu ‹first›.".

Lokalizowanie błędów za pomocą ścieżek XML i linii

W przypadku wykrycia problemów w strukturze kanału, narzędzie ułatwia ich szybkie usunięcie poprzez dokładne wskazanie miejsca wystąpienia błędu. Wyniki walidacji prezentowane są w sekcji "Diagnostyka kanału".

Dla każdego wykrytego problemu narzędzie podaje:

• Dokładną lokalizację w pliku źródłowym w formacie: "Linia ‹line›, kolumna ‹column›".
• Ścieżkę XPath ułatwiającą identyfikację elementu w strukturze dokumentu: "Poprawka: ‹path›".
• Bezpośredni odnośnik nawigacyjny: "Przejdź do ‹path› w linii ‹line›".

W przypadku bardzo obszernych plików zawierających liczne błędy, lista wynikowa może zostać ograniczona, o czym informuje komunikat: "Wyświetlono pierwsze ‹shown› z ‹total› problemów.".

Prywatność i ograniczenia techniczne walidacji

Proces sprawdzania poprawności pliku RSS odbywa się lokalnie. Kanał podcastu jest sprawdzany w Twojej przeglądarce. BroBroGo niczego nie przesyła ani nie zapisuje, co gwarantuje, że przetwarzane dane nie opuszczają urządzenia użytkownika.

Narzędzie posiada określone limity techniczne i ograniczenia funkcjonalne:

• Limit rozmiaru: Maksymalny rozmiar wklejanego kodu XML wynosi 500 000 znaków. Przekroczenie tej wartości uniemożliwi analizę.
• Czas przetwarzania: Jeśli analiza struktury trwa zbyt długo, proces zostanie przerwany komunikatem: "Sprawdzanie trwało zbyt długo. Spróbuj użyć krótszego kanału.". W skrajnych przypadkach awarii parsera wyświetlany jest komunikat: "Nie można zakończyć sprawdzania poprawności.".
• Brak weryfikacji sieciowej: Narzędzie wykonuje wyłącznie statyczną kontrolę struktury. Adresy kanału, okładki i plików multimedialnych nie są otwierane przez serwer. Narzędzie nie pobiera ani nie dekoduje plików audio.

Często zadawane pytania (FAQ)

Co sprawdza ten moduł sprawdzania podcastów RSS?

Sprawdza poprawność składni RSS 2.0 XML, obecność wymaganych pól RSS i typowych pól Apple Podcasts, a także atrybuty <enclosure>, duplikaty i daty RFC 2822.

Czy testuje plik audio?

Sprawdza adres URL elementu <enclosure>, liczbę bajtów, typ MIME, unikalność adresu i zgodność nazwy pliku z typem. Nie pobiera ani nie dekoduje pliku audio.

Czy kanał bez błędów zostanie zaakceptowany wszędzie?

Nie. Aplikacje i katalogi podcastów mogą stosować dodatkowe zasady i kontrole zdalne. Pozytywny wynik oznacza tylko, że wklejony XML przeszedł pokazane tutaj kontrole statyczne.

Co oznacza błąd dotyczący deklaracji DOCTYPE?

Standardy dystrybucji podcastów wymagają czystej struktury XML bez zewnętrznych definicji typów dokumentów. Jeśli Twój plik zawiera taką deklarację, musisz ją usunąć przed uruchomieniem walidacji.