Struktura dhe Kërkesat e Burimeve RSS 2.0
Formatet e burimeve të të dhënave RSS 2.0 bazohen në rregulla të përcaktuara strukturore për të siguruar që lexuesit e përmbajtjes të mund t'i interpretojnë saktë ato. Një burim RSS 2.0 duhet të jetë një dokument XML i vlefshëm që përmban elementin rrënjë <rss> me atributin e versionit të saktë.
Brenda këtij elementi, struktura kërkon një kanal të vetëm. Nëse kjo strukturë shkelet, mjeti shfaq mesazhin e gabimit "RSS duhet të përmbajë saktësisht një <channel> të drejtpërdrejtë; u gjetën ‹count›.". Për çdo zë (item) brenda kanalit RSS, zbatohen rregulla specifike të fushave:
- Duhet të ekzistojë rregulli
title-or-description, që do të thotë se çdo zë duhet të ketë të paktën një titull ose një përshkrim. - Analizuesi lexon fushën
GUID(identifikuesin unik), lidhjen (link) dhe datën e publikimit (publication date). - Çdo datë e përdorur duhet të jetë një datë reale në formatin e kërkuar nga ky burim, përndryshe shfaqet gabimi "Përdorni një datë reale në formatin që kërkon ky burim.".
Struktura dhe Kërkesat e Burimeve Atom 1.0
Formati Atom 1.0 përdor një strukturë më strikte XML në krahasim me RSS. Elementi rrënjë për këtë format është <feed>. Për vërtetimin e saktë të zërave Atom, mjeti kontrollon rregullat e mëposhtme:
- Identifikuesi unik (ID): Çdo zë duhet të ketë një ID të vlefshme.
- Titulli dhe Përditësimi: Fushat e titullit dhe kohës së përditësimit janë të detyrueshme për çdo zë.
- Trashëgimia e Autorit: Kontrollohet nëse autori është i përcaktuar në nivel zëri ose nëse trashëgohet nga burimi kryesor. Nëse mungon, shfaqet gabimi "Shtoni <author> te ky zë, <source> i tij ose burimi." ose "Shtoni <author> te burimi ose një <author> të drejtpërdrejtë te çdo zë.".
- Lidhjet Alternative: Duhet të shtohet një lidhje alternative kur një zë Atom nuk ka përmbajtje të brendshme, duke shkaktuar gabimin "Shtoni një <link> alternativ kur një zë Atom nuk ka <content> brenda." nëse kjo mungon.
- Përmbajtja dhe Përmbledhja: Kur elementi i përmbajtjes përdor atributin
srcpër burime të jashtme, duhet të hiqet teksti i brendshëm dhe elementet fëmijë, përndryshe shfaqet gabimi "Kur <content> përdor src, hiqni tekstin brenda dhe elementet fëmijë.". Gjithashtu, duhet të shtohet një përmbledhje kur përmbajtja Atom është e jashtme ose nuk lexohet si tekst.
Roli i xml:base në Referencat Relative Atom
Në dokumentet Atom 1.0, lidhjet dhe identifikuesit mund të shprehen si adresa relative. Për të zgjidhur këto adresa në URL absolute të plota, përdoret atributi standard xml:base.
Mjeti analizon fushat me lidhje dhe zgjidh referencat relative Atom duke përdorur këtë atribut. Nëse një lidhje është relative dhe nuk mund të zgjidhet për shkak të mungesës së një xml:base të vlefshëm, vërtetuesi do të raportojë gabimin "Përdorni një adresë absolute për ‹field›; vetëm referencat Atom me një xml:base të përdorshëm mund të jenë relative.". Për më tepër, identifikuesit Atom (ID) kanë rregulla edhe më strikte: ata duhet të jenë gjithmonë IRI absolute. Nëse përdoret një identifikues relativ, mjeti kthen gabimin "Përdorni një IRI absolut për ‹field›; identifikuesit relativë nuk janë ID të vlefshme Atom.".
Dallimi midis Vërtetimit Strukturor dhe Atij të Përmbajtjes
Ky vërtetues kryen një analizë të strukturës dhe të rregullave të formatit XML, por ka kufizime të qarta operative:
- Nuk ka qasje në rrjet: Mjeti nuk i hap kurrë URL-të e analizuara. Kjo do të thotë se disponueshmëria e serverit, ridrejtimet e mundshme HTTP, vlefshmëria e certifikatave SSL/TLS dhe saktësia e përmbajtjes në destinacion nuk testohen.
- Kufizimi i raportit: Raporti i gjeneruar kontrollon vetëm strukturën dhe rregullat e zakonshme të formatit. Ai nuk provon se përmbajtja është e saktë, e sigurt, e pranuar nga çdo lexues ose gati për publikim.
- Përpunimi lokal: I gjithë përpunimi i të dhënave kryhet lokalisht. Burimi kontrollohet në shfletuesin tuaj dhe BroBroGo nuk ngarkon ose ruan asgjë.
Problemet e Zakonshme dhe Mesazhet e Gabimeve në XML
Gjatë vërtetimit të burimeve RSS dhe Atom, mund të hasen disa gabime strukturore dhe skematike. Tabela e mëposhtme përmbledh mesazhet kryesore të gabimit që gjeneron mjeti dhe kuptimin e tyre teknik:
| Mesazhi i Gabimit | Shkaku i Shfaqjes |
|---|---|
| "Hiqni deklaratën DOCTYPE para se të kontrolloni këtë burim." | Dokumenti përmban një deklaratë DOCTYPE që mund të shkaktojë probleme sigurie ose përpunimi. |
| "Ndreqni XML-në e keqformuar dhe vërtetojeni përsëri." | XML nuk është i mirëformuar sipas standardeve bazë të shenjimit (p.sh. etiketa të pa mbyllura). |
| "Përdorni një dokument RSS 2.0 <rss> ose Atom 1.0 <feed>." | Formati i zbuluar nuk mbështetet nga ky vërtetues. |
"Ky vërtetues mbështet ‹format› ‹expected›; u zbulua ‹actual›." |
Versioni i dokumentit të zbuluar ndryshon nga versionet e mbështetura RSS 2.0 ose Atom 1.0. |
"Shtoni fushën e kërkuar ‹field›." |
Një element i detyrueshëm për strukturën e burimit ose të zërit mungon. |
"Mbani saktësisht një ‹field›; u gjetën ‹count›." |
Një fushë që duhet të jetë unike është përsëritur disa herë. |
"Ndreqni ‹field›; kjo lidhje nuk mund të analizohet si URL ose referencë URI." |
Sintaksa e lidhjes së vendosur është e dëmtuar ose e pavlefshme. |
"Kjo ID përsërit vlerën e parë për herë të parë në rreshtin ‹first›." |
Identifikuesi i zërit nuk është unik brenda të njëjtit burim. |
Mjeti pranon deri në 500,000 karaktere për çdo kontroll. Nëse dokumenti i ngarkuar tejkalon këtë kufi, shfaqet mesazhi "Ky mjet pranon deri në ‹max› karaktere për çdo kontroll.". Në rast se procesi i analizimit zgjat shumë ose dështon, do të shfaqen mesazhet "Vërtetimi zgjati shumë. Provoni një burim më të vogël." ose "Vërtetimi nuk mundi të përfundonte.". Raporti përfundimtar shfaq maksimalisht 200 problemet e para dhe 100 zërat e parë, duke treguar shënimet përkatëse të shkurtimit nëse kalohen këto limite.
FAQ
Cilat formate burimesh mbështet ky vërtetues?
Ai vërteton dokumentet aktuale RSS 2.0 dhe Atom 1.0. Burimet më të vjetra RSS, RDF/RSS 1.0 dhe Atom 0.3 identifikohen, por nuk kontrollohen sipas rregullave të formatit të gabuar.
A i hap ose i teston lidhjet në burim?
Ai analizon fushat me lidhje dhe zgjidh referencat relative Atom me xml:base. URL-të nuk hapen kurrë, ndaj disponueshmëria, ridrejtimet, certifikatat dhe përmbajtja e destinacionit nuk testohen.
Cilat fusha të zërave kontrollohen?
Për zërat RSS kontrollon titullin ose përshkrimin dhe lexon GUID-in, lidhjen dhe datën e publikimit. Për zërat Atom kontrollon ID-në, titullin, përditësimin, trashëgiminë e autorit, lidhjet alternative dhe rregullat e përmbajtjes ose përmbledhjes.
Ku përpunohen të dhënat e burimit tim XML?
Burimi kontrollohet në shfletuesin tuaj. BroBroGo nuk ngarkon ose ruan asgjë, duke siguruar që të dhënat tuaja të mos largohen nga pajisja juaj.