Structuur en vereisten van RSS 2.0-feeds
Een RSS 2.0-feed is opgebouwd rond een XML-structuur met specifieke regels voor elementen en hiërarchie. De validator controleert of het document voldoet aan deze standaarden. Een van de belangrijkste structurele regels is dat een RSS-feed precies één direct onderliggend <channel>-element moet bevatten. Indien dit niet het geval is, toont de tool de foutmelding "RSS moet precies één direct onderliggend <channel>-element bevatten; ‹count› gevonden.".
Binnen het <channel>-element bevinden zich de afzonderlijke RSS-items. Voor deze items gelden specifieke regels voor verplichte velden. De validator controleert of elk item voldoet aan de title-or-description-regel, wat betekent dat een item minimaal een titel of een beschrijving moet bevatten. Daarnaast leest en valideert de parser de volgende velden binnen een item:
- De unieke identificatie (
GUID) - De directe link (
link) - De publicatiedatum (
publication date)
Wanneer een verplicht veld ontbreekt of wanneer er te veel instanties van een veld aanwezig zijn, genereert de tool specifieke foutmeldingen zoals "Voeg het vereiste veld ‹field› toe." of "Behoud precies één ‹field›; ‹count› gevonden.".
Structuur en vereisten van Atom 1.0-feeds
Atom 1.0-feeds hanteren een andere XML-structuur en strengere regels voor metadata en auteurschap dan RSS 2.0. Bij de controle van een Atom-feed valideert de tool de aanwezigheid en correctheid van de volgende elementen:
- De unieke identificatie (
ID) - De titel (
title) - De datum van laatste bijwerking (
updated) - De regels voor auteurschap en overerving (
author inheritance) - Alternatieve links (
alternate links) - De regels voor inhoud of samenvatting (
content or summary)
Auteurschap is binnen Atom 1.0 aan strikte regels gebonden. Als er geen auteur op feedniveau is gedefinieerd, moet elk afzonderlijk item een auteur hebben. De validator controleert deze overerving en geeft de foutmelding "Voeg een <author> toe aan de feed, of een directe <author> aan elk item." of "Voeg een <author> toe aan dit item, de <source> ervan of de feed." wanneer deze gegevens ontbreken.
Daarnaast moeten Atom-items met externe inhoud of inhoud die niet als tekst leesbaar is, voorzien zijn van een samenvatting. Dit resulteert bij ontbreken in de foutmelding "Voeg <summary> toe wanneer Atom-inhoud extern of niet als tekst leesbaar is.". Indien een content-element een src-attribuut gebruikt, mag dit element geen inline tekst of onderliggende elementen bevatten. De validator controleert dit via de regel "Wanneer <content> src gebruikt, verwijder je de inline tekst en onderliggende elementen.".
De rol van xml:base en linkverwerking
Links en unieke identificaties binnen feeds moeten aan strikte standaarden voldoen om door externe lezers correct verwerkt te worden. De validator controleert of links correct kunnen worden ontleed als een URL of URI-verwijzing. Als dit mislukt, verschijnt de foutmelding "Herstel ‹field›; deze link kan niet als URL- of URI-verwijzing worden verwerkt.".
In Atom 1.0-feeds kunnen relatieve links worden gebruikt, mits er een bruikbaar xml:base-attribuut aanwezig is om de basis-URL te definiëren. De tool gebruikt xml:base om deze relatieve verwijzingen op te lossen naar absolute adressen. Als een link relatief is en er is geen bruikbare xml:base gedefinieerd, geeft de validator de foutmelding "Gebruik een absoluut adres voor ‹field›; alleen Atom-verwijzingen met een bruikbare xml:base mogen relatief zijn.".
Voor identificatievelden (IDs) gelden nog strengere regels. Een Atom-ID moet altijd een absolute IRI zijn; relatieve identifiers zijn niet toegestaan. Dit wordt gecontroleerd met de foutmelding "Gebruik een absolute IRI voor ‹field›; relatieve identifiers zijn geen geldige Atom-ID's.". Bovendien moeten alle IDs uniek zijn binnen de feed. Dubbele IDs worden gedetecteerd en gerapporteerd met de melding "Deze ID herhaalt de waarde die voor het eerst op regel ‹first› stond.".
De validator verwerkt de links en controleert de syntaxis, maar opent de URL's zelf nooit. Dit betekent dat de beschikbaarheid van de server, eventuele HTTP-omleidingen, SSL-certificaten en de daadwerkelijke inhoud op de bestemming niet worden getest.
Datumformaten en algemene XML-fouten
Zowel RSS 2.0 als Atom 1.0 vereisen specifieke datumnotaties voor hun publicatie- en bijwerkingsvelden. RSS maakt gebruik van de RFC 822-datumnotatie, terwijl Atom de RFC 3339-notatie vereist. De validator controleert of de ingevoerde datums voldoen aan de syntaxis die bij het gedetecteerde feedformaat hoort. Bij een ongeldige datum toont de tool de foutmelding "Gebruik een echte datum in het formaat dat deze feed vereist.".
Naast feedspecifieke regels controleert de tool ook de algemene XML-structuur. Voordat de feedinhoud geanalyseerd kan worden, moet de XML-syntaxis correct zijn. Als de XML beschadigd is of niet-gesloten tags bevat, stopt de controle met de foutmelding "Herstel de verkeerd opgemaakte XML en valideer opnieuw.". Ook het gebruik van een DOCTYPE-declaratie is niet toegestaan bij de controle; de validator vereist dat deze vooraf wordt verwijderd en toont indien nodig de melding "Verwijder de DOCTYPE-declaratie voordat je deze feed controleert.".
Structurele versus inhoudelijke validatie
Het is belangrijk om het onderscheid te begrijpen tussen wat deze validator controleert en wat buiten het bereik van de controle valt. De tool voert een structurele en syntactische controle uit op basis van de specificaties van RSS 2.0 en Atom 1.0.
| Wat de validator controleert | Wat de validator NIET controleert |
|---|---|
| XML-syntaxis en opmaakfouten | Nauwkeurigheid of waarheid van de inhoud |
| Aanwezigheid van verplichte feed- en itemvelden | Veiligheid van de links of scripts in de feed |
| Correctheid van URI/URL-syntaxis en absolute IDs | Bereikbaarheid of status van de gelinkte websites |
| Correcte datumnotaties volgens de standaarden | Geschiktheid of gereedheid voor publicatie |
De melding "Dit rapport controleert alleen de structuur en algemene formaatregels. Het bewijst niet dat inhoud correct, veilig, door elke lezer geaccepteerd of klaar voor publicatie is." herinnert de gebruiker aan deze afbakening.
Privacy en lokale verwerking
De verwerking van de ingevoerde XML-data vindt volledig plaats binnen de webbrowser van de gebruiker. Er worden geen gegevens geüpload naar externe servers of opgeslagen door BroBroGo. Dit maakt de tool bruikbaar voor het controleren van feeds die nog niet openbaar zijn gepubliceerd. De invoerlimiet voor een enkele controle is vastgesteld op 500.000 tekens. Als deze limiet wordt overschreden, toont de interface de foutmelding "Deze tool accepteert maximaal ‹max› tekens per controle.".
Veelgestelde vragen
Welke feedformaten ondersteunt deze validator?
De validator controleert actuele RSS 2.0- en Atom 1.0-documenten. Oudere RSS-, RDF/RSS 1.0- en Atom 0.3-feeds worden herkend, maar niet met de verkeerde regels gecontroleerd.
Worden links in de feed geopend of getest?
Velden met links worden verwerkt en relatieve Atom-verwijzingen worden met xml:base opgelost. URL's worden nooit geopend, dus bereikbaarheid, omleidingen, certificaten en doelinhoud worden niet getest.
Welke invoervelden worden gecontroleerd?
Voor RSS-items worden titel of beschrijving gecontroleerd en GUID, link en publicatiedatum gelezen. Voor Atom-items worden ID, titel, updated, overerving van auteur, alternatieve links en regels voor content of samenvatting gecontroleerd.
Waarom krijg ik een foutmelding over een DOCTYPE-declaratie?
De validator staat geen DOCTYPE-declaraties toe in de geplakte XML-code. U dient de regel met de DOCTYPE-declaratie handmatig uit de XML-tekst te verwijderen voordat u de feed opnieuw valideert.