L-Istruttura u r-Rekwiżiti tal-Feeds RSS 2.0
Il-feeds RSS 2.0 huma mibnija fuq il-lingwaġġ XML u jintużaw biex ixerrdu kontenut b'mod strutturat. Kull dokument RSS 2.0 validu għandu jkollu element għerq <rss> b'attribut tal-verżjoni speċifiku. Fil-livell immedjat taħt l-għerq, id-dokument għandu jkun fih element <channel> wieħed biss. Jekk jinstabu aktar jew inqas, il-validatur jirrapporta l-iżball "RSS irid ikun fih eżattament <channel> dirett wieħed; instabu ‹count›.".
L-element <channel> fih l-informazzjoni metadata tal-feed u l-entrati individwali, magħrufa bħala items. Għal kull item RSS, hemm regoli strutturali li jridu jiġu rrispettati biex il-qarrejja tal-feeds jinterpretaw il-kontenut b'mod korrett. B'differenza minn formati oħra, item fl-RSS 2.0 mhuwiex obbligat li jkollu kemm it-titlu kif ukoll id-deskrizzjoni fl-istess ħin, iżda ma jistax iħalli t-tnejn vojta. Il-validatur jiċċekkja r-regola ta' title-or-description biex jiżgura li mill-inqas wieħed minn dawn l-oqsma jkun preżenti. Barra minn hekk, l-għodda taqra u tanalizza l-oqsma tal-GUID, il-link u d-data tal-pubblikazzjoni ta' kull item biex tivverifika l-istruttura tagħhom.
L-Istruttura u r-Rekwiżiti tal-Feeds Atom 1.0
Il-format Atom 1.0 huwa standard ieħor għas-sindikazzjoni tal-kontenut li għandu regoli aktar stretti u definiti b'mod preċiż meta mqabbel ma' RSS. Element għerq validu għal feed Atom huwa <feed>. Kull entrata individwali fi ħdan dan il-feed hija rrappreżentata mill-element <entry>.
Għal kull entrata Atom, il-validatur japplika sett speċifiku ta' verifiki:
- ID: Jiġi vverifikat li kull entrata jkollha identifikatur uniku.
- Titlu: Kull entrata għandu jkollha titlu definit.
- Aġġornament (updated): Il-preżenza ta' timestamp validu li jindika l-aħħar modifika hija obbligatorja.
- Wirt tal-awtur: Atom jeħtieġ li l-awtur ikun identifikat. Jekk l-entrata nnifisha m'għandhiex element ta' awtur, il-validatur jiċċekkja jekk dan huwiex iddikjarat fl-element tal-feed ġenitur.
- Links alternattivi: Jiġu vverifikati r-relazzjonijiet tal-links biex jiġi żgurat li l-utenti jkunu jistgħu jaċċessaw il-verżjoni tal-web tal-kontenut.
- Kontenut jew sommarju: Hemm regoli speċifiċi dwar meta għandu jintuża sommarju jew kontenut sħiħ.
Kwistjonijiet Komuni u Żbalji fl-XML tal-Feeds
Meta jiġu ġġenerati feeds b'mod awtomatiku jew manwali, jistgħu jidħlu diversi żbalji strutturali li jwaqqfu l-qarrejja tal-feeds milli jipproċessaw il-kontenut. L-aktar problemi komuni li jidentifika dan il-validatur jinkludu:
- XML Iffurmat Ħażin: Jekk l-XML ma jkunx magħluq sew jew ikun fih karattri invalidi, jidher l-iżball "Sewwi l-XML iffurmat ħażin, imbagħad ivvalida mill-ġdid.".
- Dikjarazzjonijiet DOCTYPE: Id-dokumenti m'għandhomx jinkludu dikjarazzjonijiet DOCTYPE esterni. F'dan il-każ, l-għodda turi l-messaġġ "Neħħi d-dikjarazzjoni DOCTYPE qabel tiċċekkja dan il-feed.".
- Oqsma Meħtieġa Neqsin: Jekk element essenzjali bħat-titlu jew l-awtur ikun nieqes, jidher l-iżball "Żid il-
‹field›meħtieġ.". - Duplikazzjoni ta' Identifikaturi: L-IDs kollha għandhom ikunu uniċi. Jekk jinstab ID duplikat, il-validatur jirrapporta "Dan l-ID jirrepeti l-valur li deher l-ewwel fil-linja
‹first›.". - Kunflitti ta' Kontenut Atom: Jekk element ta' kontenut juża sors estern permezz tal-attribut
src, m'għandux ikun fih test inline jew elementi tfal. Jekk dan iseħħ, jidher l-iżball "Meta <content> juża src, neħħi t-test inline u l-elementi tfal tiegħu.".
L-Importanza ta' Links u IDs Assoluti u r-Rwol ta' xml:base
Il-links u l-identifikaturi (IDs) huma l-pedament ta' kull feed, peress li jippermettu lill-qarrejja jidentifikaw b'mod uniku l-artikli u jidderieġu lill-utenti lejn il-paġni tal-web korretti.
Fl-Atom 1.0, l-identifikaturi kollha għandhom ikunu IRI (Internationalized Resource Identifier) assoluti. Jekk jintuża identifikatur relattiv, il-validatur joħroġ l-iżball "Uża IRI assolut għal ‹field›; identifikaturi relattivi mhumiex ID Atom validi.".
Għal links normali, l-indirizzi għandhom ikunu assoluti biex jiġu evitati problemi ta' riżoluzzjoni. Madankollu, l-istandard Atom jippermetti l-użu ta' links relattivi biss jekk ikun hemm attribut xml:base validu definit fl-element għerq jew fl-elementi ġenituri. L-attribut xml:base jipprovdi l-indirizz bażi li miegħu jiġu magħquda l-links relattivi biex jiffurmaw URL sħiħ. Jekk jinstab link relattiv mingħajr dan l-attribut, il-validatur juri l-iżball "Uża indirizz assolut għal ‹field›; referenzi Atom b'xml:base li jista' jintuża huma l-uniċi li jkunu relattivi.".
Huwa importanti li wieħed jinnota li l-validatur janalizza l-istruttura u l-validità sintattika tal-links, iżda qatt ma jiftaħ l-URLs. Dan ifisser li d-disponibbiltà tas-server, ir-ridirezzjonijiet, iċ-ċertifikati SSL u l-kontenut tad-destinazzjoni ma jiġux ittestjati.
Konvenzjonijiet tal-Format tad-Data u Validazzjoni Strutturali
Kemm RSS 2.0 kif ukoll Atom 1.0 għandhom regoli stretti dwar kif għandhom jinkitbu d-dati. RSS 2.0 juża l-format RFC 822 (bħal Wed, 02 Oct 2002 13:00:00 GMT), filwaqt li Atom 1.0 juża l-format RFC 3339 (bħal 2002-10-02T15:00:00Z). Jekk id-data ma ssegwix il-format meħtieġ mill-ispeċifikazzjoni tal-feed rispettiv, il-validatur jirrapporta l-iżball "Uża data vera fil-format meħtieġ minn dan il-feed.".
Hemm distinzjoni ċara bejn il-validazzjoni strutturali u l-validazzjoni tal-kontenut. Dan il-validatur jiċċekkja biss l-istruttura u r-regoli komuni tal-format. Rapport b'suċċess mingħajr żbalji strutturali ma jipprovax li l-kontenut tal-feed huwa preċiż, sigur, aċċettat minn kull qarrej jew lest biex jiġi ppubblikat.
Limiti tal-Input u l-Ipproċessar tad-Data
Biex jiġi żgurat prestazzjoni tajba, il-validatur għandu xi limiti stabbiliti fuq id-daqs tal-input u l-wiri tar-riżultati:
- Daqs tal-Input: L-input huwa limitat għal massimu ta' 500,000 karattru għal kull verifika. Jekk dan il-limitu jinqabeż, jidher il-messaġġ "Din l-għodda taċċetta sa
‹max›karattru għal kull ċekk.". - Wiri tal-Problemi: Il-validatur juri massimu ta' 200 problema (żbalji u twissijiet). Jekk ikun hemm aktar, juri n-nota "Qed jintwerew l-ewwel
‹shown›minn‹total›problemi.". - Wiri tal-Entrati: L-għodda turi sa massimu ta' 100 entrata analizzata. Jekk il-feed fih aktar, juri n-nota "Qed jintwerew l-ewwel
‹shown›minn‹total›entrati.".
Il-feed tiegħek jiġi ċċekkjat fil-browser. BroBroGo ma jtella' u ma jsalva xejn, u b'hekk id-data tiegħek tibqa' privata waqt l-analiżi.
Mistoqsijiet Frekwenti (FAQ)
Liema formati tal-feed jappoġġja dan il-validatur?
Jivvalida dokumenti RSS 2.0 u Atom 1.0 attwali. Feeds RSS eqdem, RDF/RSS 1.0 u Atom 0.3 jiġu identifikati iżda ma jiġux iċċekkjati bir-regoli żbaljati.
Jiftaħ jew jittestja l-links fil-feed?
Janalizza oqsma li fihom links u jsolvi referenzi relattivi ta' Atom b'xml:base. Qatt ma jiftaħ l-URLs, għalhekk id-disponibbiltà, ir-ridirezzjonijiet, iċ-ċertifikati u l-kontenut tad-destinazzjoni ma jiġux ittestjati.
Liema oqsma tal-entrati jiġu ċċekkjati?
Għall-items RSS jiċċekkja t-titlu jew id-deskrizzjoni u jaqra l-GUID, il-link u d-data tal-pubblikazzjoni. Għall-entrati Atom jiċċekkja l-ID, it-titlu, l-aġġornament, il-wirt tal-awtur, links alternattivi u r-regoli tal-kontenut jew tas-sommarju.
X'jiġri jekk il-validazzjoni tieħu wisq ħin biex titlesta?
Jekk il-validazzjoni tieħu wisq ħin minħabba d-daqs jew l-istruttura tal-feed, l-għodda tieqaf u turi l-messaġġ "Il-validazzjoni damet wisq. Ipprova feed iżgħar.". Jekk il-proċess ifalli għal kollox, jidher il-messaġġ "Il-validazzjoni ma setgħetx titlesta.".