Walidator kanałów RSS

Walidacja kanałów RSS 2.0 oraz Atom 1.0

Narzędzie służy do analizy i weryfikacji poprawności strukturalnej dokumentów XML reprezentujących kanały informacyjne w formatach RSS 2.0 oraz Atom 1.0. Proces walidacji pozwala wydawcom treści, programistom oraz administratorom witryn na szybkie wykrycie błędów składniowych, brakujących pól wymaganych oraz nieprawidłowych odwołań URI/URL przed udostępnieniem kanału użytkownikom końcowym.

Działanie narzędzia opiera się na analizie wklejonego kodu XML o maksymalnej długości do 500 000 znaków. Walidator identyfikuje format dokumentu, przetwarza jego strukturę, a następnie generuje szczegółowy raport zawierający liczbę wykrytych błędów, ostrzeżeń, odczytanych wpisów oraz zweryfikowanych odnośników. Każdy zidentyfikowany problem jest precyzyjnie lokalizowany poprzez wskazanie numeru wiersza, kolumny oraz ścieżki XML.

Struktura i wymagania techniczne kanałów RSS 2.0

Format RSS 2.0 nakłada określone reguły strukturalne na dokument XML. Narzędzie weryfikuje zgodność z tą specyfikacją, zwracając uwagę na następujące aspekty:

• Główny element kanału: Dokument RSS musi zawierać dokładnie jeden bezpośredni element <channel>. W przypadku wykrycia innej liczby tych elementów, walidator zgłasza błąd: "RSS musi zawierać dokładnie jeden bezpośredni element <channel>; znaleziono ‹count›.".
• Wymagane pola: Każdy kanał oraz jego elementy składowe muszą posiadać określone tagi strukturalne. Brak wymaganych elementów skutkuje komunikatem: "Dodaj wymagane pole ‹field›.".
• Reguła title-or-description: Dla każdego elementu <item> w kanale RSS 2.0 wymagane jest zachowanie przynajmniej jednego z pól: tytułu (title) lub opisu (description).
• Identyfikacja wpisów: Podczas przetwarzania elementów <item> walidator odczytuje unikalne identyfikatory GUID, bezpośrednie linki link oraz daty publikacji publication date.
• Formatowanie dat: Daty w kanale RSS 2.0 muszą być zapisane zgodnie z określoną specyfikacją formatu. Wprowadzenie nieprawidłowej lub nieistniejącej daty wywołuje błąd: "Użyj prawdziwej daty w formacie wymaganym przez ten kanał.".

Struktura i wymagania techniczne kanałów Atom 1.0

Format Atom 1.0 charakteryzuje się bardziej rygorystycznymi regułami dotyczącymi unikalności identyfikatorów oraz obsługi autorstwa. Walidator sprawdza dokumenty Atom pod kątem następujących reguł:

• Identyfikatory ID: Każdy wpis oraz kanał Atom musi posiadać unikalny identyfikator. Narzędzie sprawdza, czy identyfikatory nie powtarzają się w obrębie dokumentu. W przypadku duplikacji wyświetlany jest komunikat: "Ten identyfikator ID powtarza wartość widoczną po raz pierwszy w wierszu ‹first›.". Ponadto identyfikator musi być bezwzględnym identyfikatorem IRI. Użycie ścieżki względnej generuje błąd: "Użyj bezwzględnego IRI dla pola ‹field›; identyfikatory względne nie są prawidłowymi ID Atom.".
• Dziedziczenie i obecność autorów: Specyfikacja Atom wymaga zdefiniowania autora. Jeśli kanał nie posiada globalnego autora, każdy wpis musi go definiować samodzielnie. Narzędzie weryfikuje te zależności, zgłaszając błędy: "Dodaj <author> do kanału albo bezpośredni <author> do każdego wpisu." lub "Dodaj <author> do tego wpisu, jego <source> lub kanału.".
• Powiązania treści i linków alternatywnych: Wpisy Atom muszą zawierać treść lub wskazywać na jej źródło. Jeśli wpis nie posiada wbudowanej treści, wymagany jest link alternatywny. Brak takiego elementu skutkuje błędem: "Dodaj alternatywny <link>, gdy wpis Atom nie zawiera treści <content> wbudowanej w dokument.".
• Konflikty źródła treści: Jeśli element treści używa zewnętrznego źródła poprzez atrybut src, nie może jednocześnie zawierać tekstu wbudowanego ani elementów podrzędnych. Narzędzie zgłasza wtedy błąd: "Gdy <content> używa src, usuń z niego tekst wbudowany i elementy podrzędne.". W sytuacjach, gdy treść jest zewnętrzna lub nieczytelna jako tekst, wymagane jest podsumowanie: "Dodaj <summary>, gdy treść Atom jest zewnętrzna lub nie można jej odczytać jako tekstu.".

Rola xml:base i weryfikacja odnośników

W kanałach Atom 1.0 dopuszczalne jest stosowanie względnych odwołań URI. Narzędzie potrafi przetwarzać takie odnośniki i rozwiązywać je, pod warunkiem zdefiniowania kontekstu bazowego za pomocą atrybutu xml:base.

Wszystkie wykryte pola zawierające linki są analizowane pod kątem poprawności zapisu. Jeśli odnośnik nie może zostać zinterpretowany jako prawidłowy adres URL lub URI, walidator wyświetla komunikat: "Popraw ‹field›; tego linku nie można odczytać jako adresu URL ani odwołania URI.". W przypadku braku możliwości rozwiązania linku względnego (np. z powodu braku lub nieprawidłowości atrybutu xml:base), system zgłasza błąd: "Użyj adresu bezwzględnego dla pola ‹field›; względne mogą być tylko odwołania Atom z użytecznym xml:base.".

Należy pamiętać, że walidator analizuje wyłącznie strukturę zapisanych odnośników. Narzędzie nigdy nie nawiązuje połączeń sieciowych z adresami URL podanymi w kanale. W związku z tym dostępność serwerów docelowych, poprawność certyfikatów SSL/TLS, występowanie przekierowań HTTP oraz faktyczna zawartość stron docelowych nie podlegają testom.

Ograniczenia przetwarzania i obsługa błędów XML

Walidator nakłada limity techniczne w celu zapewnienia stabilności działania w przeglądarce użytkownika:

• Limit znaków: Maksymalny rozmiar wklejanego tekstu XML wynosi 500 000 znaków. Przekroczenie tej wartości uniemożliwia uruchomienie testu i skutkuje komunikatem: "To narzędzie przyjmuje maksymalnie ‹max› znaków na jedno sprawdzenie.".
• Limity prezentacji danych: Aby zachować czytelność raportu, na ekranie wyświetlanych jest maksymalnie 200 problemów oraz 100 odczytanych wpisów. W przypadku większych dokumentów stosowane jest obcięcie listy z informacją: "Wyświetlono pierwsze ‹shown› z ‹total› problemów." oraz "Wyświetlono pierwsze ‹shown› z ‹total› wpisów.".
• Błędy składni XML: Dokumenty zawierające nieprawidłowo zamknięte znaczniki lub inne błędy składniowe parsera XML nie zostaną przetworzone. Wyświetlany jest wtedy komunikat: "Napraw błędnie sformatowany kod XML i sprawdź go ponownie.".
• Deklaracje DOCTYPE: Ze względów bezpieczeństwa i zgodności z parserem, dokumenty zawierające deklaracje typu dokumentu muszą zostać zmodyfikowane przed analizą. W takim przypadku pojawia się błąd: "Usuń deklarację DOCTYPE przed sprawdzeniem tego kanału.".
• Wydajność: Jeśli analiza trwa zbyt długo, proces zostaje przerwany z komunikatem: "Sprawdzanie trwało zbyt długo. Spróbuj użyć mniejszego kanału.". W przypadku innych krytycznych błędów przetwarzania pojawia się informacja: "Nie udało się ukończyć sprawdzania.".

Prywatność i bezpieczeństwo danych

Wszystkie operacje związane z przetwarzaniem, parsowaniem oraz walidacją kodu XML są wykonywane bezpośrednio w przeglądarce internetowej użytkownika. Żadne dane wprowadzane do pola tekstowego nie są przesyłane na serwery zewnętrzne ani zapisywane przez BroBroGo.

Często zadawane pytania (FAQ)

Jakie formaty kanałów obsługuje ten walidator? Sprawdza aktualne dokumenty RSS 2.0 i Atom 1.0. Starsze kanały RSS, RDF/RSS 1.0 i Atom 0.3 są rozpoznawane, ale nie są sprawdzane według niewłaściwych reguł.

Czy otwiera lub testuje linki w kanale? Odczytuje pola zawierające linki i rozwiązuje względne odwołania Atom za pomocą xml:base. Adresy URL nie są otwierane, więc dostępność, przekierowania, certyfikaty i treść docelowa nie są testowane.

Które pola wpisów są sprawdzane? W elementach RSS sprawdzany jest tytuł lub opis oraz odczytywane są GUID, link i data publikacji. We wpisach Atom sprawdzane są ID, tytuł, updated, dziedziczenie autora, linki alternatywne i reguły treści lub podsumowania.

Czy pomyślna walidacja gwarantuje, że kanał jest gotowy do publikacji? Nie. Wygenerowany raport sprawdza tylko strukturę i typowe reguły formatu. Nie dowodzi on, że treść jest poprawna pod względem merytorycznym, bezpieczna, akceptowana przez każdy zewnętrzny czytnik lub gotowa do publikacji.