RSS 2.0 plūsmu struktūra un prasības
Lai nodrošinātu pareizu RSS 2.0 plūsmas darbību, XML dokumentam ir jāatbilst stingriem struktūras noteikumiem. RSS 2.0 plūsmā ir jābūt tieši vienam saknes elementam, un tajā ir atļauts tikai viens tiešais kanāla elements. Ja pārbaudes laikā tiek konstatēts cits skaits, rīks uzrāda kļūdu: "RSS jāietver tieši viens tiešais <channel>; atrasts ‹count›."
Katram RSS vienumam (<item>) ir savas satura prasības. Galvenais noteikums nosaka, ka katram vienumam ir jāsatur vismaz virsraksts vai apraksts. Ja abi elementi trūkst, plūsma netiek uzskatīta par pilnīgu. Tāpat rīks nolasa un pārbauda šādus vienuma laukus:
GUID(globālais unikālais identifikators)link(saite uz satura avotu)publication date(publicēšanas datums)
Ja kāds no obligātajiem laukiem trūkst, tiek parādīts paziņojums: "Pievienojiet obligāto ‹field›." Ja kāds lauks ir dublēts pretēji specifikācijai, tiek piemērots noteikums: "Atstājiet tieši vienu ‹field›; atrasts ‹count›."
Atom 1.0 plūsmu struktūra un prasības
Atom 1.0 ir modernāks sindikācijas formāts ar stingrākiem validācijas noteikumiem nekā RSS 2.0. Atom plūsmā katram ierakstam (<entry>) ir obligāti jādefinē unikāls identifikators (<id>), virsraksts (<title>) un pēdējā atjauninājuma laiks (<updated>).
Papildus šiem pamata laukiem Atom 1.0 formātā tiek pārbaudīti šādi specifiski noteikumi:
- Autora pārmantošana: Atom plūsmai ir nepieciešams autors. Ja plūsmas līmenī autors nav norādīts, rīks pieprasa: "Pievienojiet <author> plūsmai vai tiešu <author> katram ierakstam." Ja autors trūkst konkrētam ierakstam, tiek parādīta kļūda: "Pievienojiet <author> šim ierakstam, tā <source> vai plūsmai."
- Alternatīvās saites: Ja Atom ierakstam nav iekļauta satura, ir jānorāda alternatīvā saite. Pretējā gadījumā tiek parādīta kļūda: "Pievienojiet alternatīvu <link>, ja Atom ierakstam nav iekļauta <content>."
- Satura un kopsavilkuma noteikumi: Ja satura elements izmanto ārēju avotu, tiek piemērots noteikums: "Ja <content> izmanto src, noņemiet tā iekļauto tekstu un bērnelementus." Ja saturs ir ārējs vai nav nolasāms kā teksts, ir spēkā prasība: "Pievienojiet <summary>, ja Atom saturs ir ārējs vai nav nolasāms kā teksts."
Saišu un identifikatoru validācija
Saites un identifikatori ir kritiski svarīgi plūsmu abonēšanai un lasītāju darbībai. Šis rīks veic detalizētu saišu un ID sintakses pārbaudi:
- Saites formāts: Jebkurai saitei ir jābūt pareizi parsējamai. Ja saite neatbilst standartiem, tiek parādīta kļūda: "Izlabojiet
‹field›; šo saiti nevar parsēt kā URL vai URI atsauci." - Atom ID un absolūtie IRI: Atom identifikatoriem ir jābūt absolūtiem. Relatīvi identifikatori nav atļauti, ko apstiprina kļūda: "Laukam
‹field›izmantojiet absolūtu IRI; relatīvie identifikatori nav derīgi Atom ID." - Unikalitāte: Identifikatori nedrīkst atkārtoties. Ja tiek atrasts dublēts ID, rīks ziņo: "Šis ID atkārto vērtību, kas pirmoreiz redzama rindā
‹first›."
Relatīvās saites un xml:base loma
Atom 1.0 standartā ir atļauts izmantot relatīvās saites, taču tikai tad, ja ir definēts bāzes URL, izmantojot atribūtu xml:base. Rīks spēj atpazīt un atrisināt šīs relatīvās atsauces. Ja plūsmā tiek izmantota relatīva saite bez derīga bāzes URL, tiek parādīta kļūda: "Laukam ‹field› izmantojiet absolūtu adresi; relatīvas drīkst būt tikai Atom atsauces ar izmantojamu xml:base."
Datumu formātu konvencijas
Gan RSS 2.0, gan Atom 1.0 izmanto stingri noteiktus datumu formātus, lai lasītāji varētu pareizi hronoloģiski sakārtot ierakstus. RSS 2.0 izmanto RFC 822 datuma un laika specifikāciju (piemēram, Wed, 02 Oct 2002 13:00:00 GMT), savukārt Atom 1.0 izmanto RFC 3339 formātu (piemēram, 2002-10-02T13:00:00Z). Ja datums neatbilst attiecīgā formāta prasībām vai nav reāls kalendārais datums, rīks uzrāda kļūdu: "Izmantojiet īstu datumu šai plūsmai nepieciešamajā formātā."
Biežākās XML un struktūras kļūdas
Pirms plūsmas loģisko lauku pārbaudes rīks analizē paša XML dokumenta integritāti. Šajā posmā var tikt konstatētas šādas problēmas:
- DOCTYPE deklarācijas: Drošības un saderības apsvērumu dēļ plūsmā nedrīkst būt DOCTYPE deklarācijas. Ja tāda tiek atrasta, parādās kļūda: "Pirms šīs plūsmas pārbaudes noņemiet DOCTYPE deklarāciju."
- Slikti veidots XML: Ja XML dokumentā ir sintakses kļūdas (piemēram, neaizvērti tagi vai nepareizi ligzdojoši elementi), pārbaude tiek pārtraukta ar paziņojumu: "Izlabojiet nepareizi veidoto XML un pārbaudiet vēlreiz."
- Neatbalstīti formāti un versijas: Ja ielādētais dokuments nav RSS 2.0 vai Atom 1.0, rīks ziņo: "Izmantojiet RSS 2.0 <rss> dokumentu vai Atom 1.0 <feed> dokumentu." vai "Šis pārbaudītājs atbalsta
‹format›‹expected›; noteikts‹actual›."
Struktūras pārbaude pret satura pārbaudi
Ir svarīgi saprast atšķirību starp to, ko šis rīks pārbauda, un to, ko tas nespēj pārbaudīt. Rīks veic tikai un vienīgi struktūras un formāta validāciju.
Uz šo pārbaudi attiecas šādi ierobežojumi:
- Saites netiek atvērtas: Rīks pārbauda saišu sintaktisko pareizību, taču tas nekad neatver norādītos URL. Tas nozīmē, ka netiek pārbaudīta saišu pieejamība, servera novirzīšanas (redirects), SSL/TLS sertifikāti vai galamērķa saturs.
- Satura drošība un precizitāte: Rīks nevar izvērtēt plūsmā iekļautā teksta vai mediju satura patiesumu, drošību vai piemērotību auditorijai. Uz to norāda arī sistēmas paziņojums: "Šis pārskats pārbauda tikai struktūru un vispārīgus formāta noteikumus. Tas neapliecina, ka saturs ir precīzs, drošs, pieņemams visiem lasītājiem vai gatavs publicēšanai."
Tehniskie ierobežojumi un datu apstrāde
Lai nodrošinātu stabilu darbību pārlūkprogrammā, rīkam ir noteikti daži tehniski ierobežojumi:
- Rakstzīmju limits: Vienā pārbaudē var ievadīt līdz 500 000 rakstzīmju. Pārsniedzot šo apjomu, tiek parādīts paziņojums: "Šis rīks vienā pārbaudē pieņem līdz
‹max›rakstzīmēm." - Laika limits: Ja plūsmas apstrāde prasa pārāk daudz resursu, darbība tiek pārtraukta ar paziņojumu: "Pārbaude aizņēma pārāk ilgu laiku. Izmēģiniet mazāku plūsmu." vai "Pārbaudi neizdevās pabeigt."
- Izvades ierobežojumi: Pārskatā tiek attēlots maksimāli līdz 200 problēmām un 100 ierakstiem. Ja plūsma pārsniedz šos rādītājus, tiek parādīti paziņojumi par datu saīsināšanu: "Tiek rādītas pirmās
‹shown›no‹total›problēmām." un "Tiek rādīti pirmie‹shown›no‹total›ierakstiem."
Datu apstrāde ir pilnībā lokāla. Plūsma tiek pārbaudīta jūsu pārlūkprogrammā. BroBroGo neko neaugšupielādē un nesaglabā, nodrošinot, ka jūsu dati neizplūst ārpus jūsu ierīces.
Biežāk uzdotie jautājumi (FAQ)
Kādus plūsmu formātus atbalsta šis pārbaudītājs?
Tas pārbauda pašreizējos RSS 2.0 un Atom 1.0 dokumentus. Vecākas RSS, RDF/RSS 1.0 un Atom 0.3 plūsmas tiek atpazītas, bet netiek pārbaudītas pēc nepareiziem noteikumiem.
Vai tas atver vai testē plūsmas saites?
Tas parsē laukus ar saitēm un atrisina Atom relatīvās atsauces, izmantojot xml:base. URL netiek atvērti, tāpēc pieejamība, novirzīšana, sertifikāti un mērķa saturs netiek pārbaudīti.
Kuri ierakstu lauki tiek pārbaudīti?
RSS vienumiem tiek pārbaudīts virsraksts vai apraksts un nolasīts GUID, saite un publicēšanas datums. Atom ierakstiem tiek pārbaudīts ID, virsraksts, atjauninājums, autora pārmantošana, alternatīvās saites un satura vai kopsavilkuma noteikumi.