Validator för RSS-flöden

Introduktion till validering av RSS- och Atom-flöden

En fungerande syndikering kräver att XML-strukturen i dina flöden följer strikta tekniska specifikationer. Verktyget Validator för RSS-flöden är utformat för att hjälpa webbplatsoperatörer, innehållsutgivare, utvecklare och team som migrerar RSS- eller Atom-flöden att kontrollera sina flödesformat. Genom att klistra in XML-innehållet i verktyget kan du snabbt identifiera felaktig märkning, saknade flödes- eller postfält samt länkar som inte kan tolkas.

Verktyget analyserar det inklistrade innehållet för att identifiera dess format, tolka dess poster och rapportera eventuella problem med flödets struktur, obligatoriska fält och länkreferenser. Resultatet presenteras i en detaljerad flödesrapport som visar fel och varningar med exakt rad- och kolumnnummer samt XML-sökväg för varje identifierat problem.

Så används verktyget

För att kontrollera ett flöde klistrar du in XML-källkoden för ett RSS 2.0- eller Atom 1.0-flöde i textområdet. Inmatningen måste innehålla ett fullständigt flöde med dess tillhörande rotelement.

Följande funktioner och begränsningar gäller vid inmatning och bearbetning:

• Inmatningsgräns: Verktyget tar emot högst 500 000 tecken per kontroll. Om denna gräns överskrids visas felmeddelandet "Verktyget tar emot högst ‹max› tecken per kontroll.".
• Exempel: Du kan använda knapparna "Använd RSS-exempel" eller "Använd Atom-exempel" för att snabbt ladda förberedda exempelflöden. När dessa används visas meddelandet "RSS-exemplet har lästs in." respektive "Atom-exemplet har lästs in.".
• Rensa: Med knappen "Rensa" töms inmatningsfältet och resultatet, vilket bekräftas med meddelandet "Inmatning och resultat har rensats.".
• Validering: När du klickar på "Validera flöde" påbörjas analysen och statusen "Kontrollerar flödet..." visas. Om inmatningsfältet är tomt visas felmeddelandet "Klistra in RSS- eller Atom-XML innan du validerar.".

Tolkning av flödesrapporten och resultat

När analysen är klar genereras en Flödesrapport. Om flödet är helt korrekt visas meddelandet "Inga strukturfel hittades.". Om problem upptäcks visas meddelandet "‹errors› fel och ‹warnings› varningar hittades.".

Rapporten innehåller följande information och strukturer:

• Sammanställning: Antal fel, varningar, poster och kontrollerade länkar visas i formatet "‹count› fel", "‹count› varningar", "‹count› poster" och "‹count› länkar kontrollerade".
• Problemidentifiering: Varje fel eller varning märks med exakt position, till exempel "Rad ‹line›, kolumn ‹column›".
• Sökväg och navigering: Verktyget anger sökvägen för felet via "Rätta: ‹path›" samt en direktlänk för att navigera i koden: "Gå till ‹path› på rad ‹line›".
• Begränsningar i visningen: Verktyget visar maximalt 200 problem och 100 poster. Om flödet överskrider dessa gränser visas meddelandena "Visar de första ‹shown› av ‹total› problem." respektive "Visar de första ‹shown› av ‹total› poster." under avsnittet Tolkade poster. Om en post eller ett flöde saknar titel visas de som "Post utan titel" eller "Flöde utan titel".

Regler och validering för RSS 2.0

När verktyget validerar ett RSS 2.0-flöde tillämpas specifika regler för formatets struktur och dess poster:

• Kanaler: Ett RSS-flöde måste innehålla exakt en direkt kanal. Om antalet avviker visas felmeddelandet "RSS måste innehålla exakt ett direkt <channel>; ‹count› hittades.".
• Obligatoriska fält: Verktyget kontrollerar att nödvändiga fält finns på plats. Om ett fält saknas visas "Lägg till det obligatoriska fältet ‹field›.". Om det finns för många av ett fält som ska vara unikt visas "Behåll exakt ett ‹field›; ‹count› hittades.".
• RSS-poster (items): För varje enskild post kontrollerar verktyget regeln för titel eller beskrivning (title-or-description) samt läser av GUID, link och publiceringsdatum. Datum måste följa rätt format, annars visas felmeddelandet "Använd ett verkligt datum i det format som flödet kräver.".

Regler och validering för Atom 1.0

För Atom 1.0-flöden tillämpas ett annat regelverk som kontrollerar unika egenskaper för detta format:

• Poster (entries): Verktyget kontrollerar reglerna för ID, title, updated, ärvt författarskap (author inheritance), alternativa länkar (alternate links) samt regler för innehåll eller sammanfattning (content or summary).
• Författarskap: Om författaruppgifter saknas kan verktyget ge felmeddelandet "Lägg till <author> i flödet eller en direkt <author> i varje post." eller "Lägg till <author> i posten, dess <source> eller flödet.".
• Innehåll och sammanfattning: Om en Atom-post saknar ett infogat innehållsfält måste en alternativ länk finnas, annars visas "Lägg till en alternativ <link> när en Atom-post saknar infogat <content>.". Om innehållet använder en extern källa via src får det inte finnas infogad text eller underordnade element, vilket annars utlöser felmeddelandet "När <content> använder src ska infogad text och underordnade element tas bort.". Om Atom-innehållet är externt eller inte kan läsas som text krävs en sammanfattning, annars visas "Lägg till <summary> när Atom-innehållet är externt eller inte kan läsas som text.".
• Atom-ID: Relativa identifierare är inte tillåtna som ID:n. Verktyget kräver en absolut IRI och visar annars felmeddelandet "Använd en absolut IRI för ‹field›; relativa identifierare är inte giltiga Atom-ID:n.".

Hantering av länkar och xml:base

Länkar i flöden måste kunna tolkas korrekt för att fungera i flödesläsare. Verktyget kontrollerar fält som innehåller länkar och analyserar deras struktur.

• Länkvalidering: Om en länk inte kan tolkas som en URL- eller URI-referens visas felmeddelandet "Rätta ‹field›; länken kan inte tolkas som en URL- eller URI-referens.".
• Relativa referenser och xml:base: Verktyget kan lösa relativa Atom-referenser med hjälp av attributet xml:base. Om en relativ länk saknar en sådan bas visas felmeddelandet "Använd en absolut adress för ‹field›; endast Atom-referenser med en användbar xml:base får vara relativa.".
• Ingen extern anslutning: Det är viktigt att notera att verktyget aldrig öppnar URL-erna. Det innebär att länkarnas faktiska tillgänglighet, eventuella omdirigeringar, SSL-certifikat och målinnehåll inte testas.

XML-strukturfel och formatbegränsningar

Innan de specifika flödesreglerna kontrolleras måste XML-dokumentet vara välformat och fritt från deklarationer som kan störa tolkningen:

• DOCTYPE-deklarationer: Verktyget tillåter inte DOCTYPE-deklarationer. Om en sådan upptäcks visas felmeddelandet "Ta bort DOCTYPE-deklarationen innan flödet kontrolleras.".
• Felaktig XML: Om själva XML-koden är trasig avbryts kontrollen med meddelandet "Rätta felaktig XML och validera sedan igen.".
• Formatstöd: Verktyget validerar aktuella RSS 2.0- och Atom 1.0-dokument. Om du försöker validera ett helt okänt format visas "Okänt flödesformat" eller felmeddelandet "Använd ett RSS 2.0-<rss>-dokument eller ett Atom 1.0-<feed>-dokument.". Äldre format som äldre RSS, RDF/RSS 1.0 och Atom 0.3 identifieras av verktyget, men de kontrolleras inte mot felaktiga regler. Om en felaktig version av ett format upptäcks visas "Validatorn stöder ‹format› ‹expected›; ‹actual› identifierades.".
• Prestandabegränsningar: Om valideringen tar för lång tid avbryts processen med meddelandet "Valideringen tog för lång tid. Prova ett mindre flöde.". Om processen avbryts av andra skäl visas "Valideringen kunde inte slutföras.". Detaljer från den bakomliggande tolkaren kan visas via "Detalj från tolkaren: ‹detail›".

Integritet och begränsningar

När du använder denna validator kan du vara trygg med att din data hanteras lokalt. Ditt flöde kontrolleras direkt i din webbläsare, och ingenting laddas upp eller sparas av BroBroGo.

Det är samtidigt viktigt att förstå vad valideringen faktiskt innebär. Rapporten kontrollerar endast struktur och vanliga formatregler. Den bevisar inte att innehållet i ditt flöde är korrekt, säkert, godkänt av alla läsare eller klart att publicera.

Vanliga frågor (FAQ)

Vilka flödesformat stöder validatorn?

Den validerar aktuella RSS 2.0- och Atom 1.0-dokument. Äldre RSS, RDF/RSS 1.0 och Atom 0.3 identifieras, men kontrolleras inte med regler för fel format.

Öppnar eller testar den länkar i flödet?

Den tolkar fält som innehåller länkar och löser relativa Atom-referenser med xml:base. URL:erna öppnas aldrig, så tillgänglighet, omdirigeringar, certifikat och målinnehåll testas inte.

Vilka postfält kontrolleras?

För RSS-poster kontrolleras titel eller beskrivning samt GUID, länk och publiceringsdatum. För Atom-poster kontrolleras ID, titel, uppdatering, ärvt författarskap, alternativa länkar och regler för innehåll eller sammanfattning.