RSS-syötteen validoija ja sen toiminta
RSS-syötteen validoija on työkalu, jonka avulla verkkosivustojen ylläpitäjät, sisällöntuottajat, kehittäjät ja syötteiden siirtoja tekevät tiimit voivat tarkistaa RSS 2.0- ja Atom 1.0 -syötteiden rakenteellisen oikeellisuuden. Työkalu analysoi liitetyn XML-sisällön, tunnistaa sen muodon, jäsentää sen sisältämät merkinnät ja raportoi mahdolliset ongelmat syötteen rakenteessa, pakollisissa kentissä sekä linkkiviittauksissa.
Kun syöte validoidaan, työkalu tuottaa yksityiskohtaisen raportin havaituista virheistä ja varoituksista. Jokaisesta ongelmasta ilmoitetaan tarkka rivi- ja sarakenumero sekä XML-polku, jotta virheellinen kohta on helppo paikantaa ja korjata. Työkalu käsittelee enintään 500 000 merkin pituisia syötteitä. Jos syötteen käsittely epäonnistuu tai kestää liian kauan, järjestelmä ilmoittaa siitä käyttäjälle.
Syötteen käsittely ja tietosuoja
Tietoturva ja yksityisyys ovat keskeisessä asemassa syötteiden tarkistuksessa. Syöte tarkistetaan selaimessasi. BroBroGo ei lataa tai tallenna mitään. Kaikki analyysi ja jäsennys tapahtuvat paikallisesti käyttäjän omassa laitteessa, eikä syötteen tietoja lähetetä ulkoisille palvelimille.
On tärkeää huomata, että työkalu ei koskaan avaa syötteessä olevia URL-osoitteita. Tämä tarkoittaa, että linkkien teknistä saatavuutta, palvelimen uudelleenohjauksia, SSL-varmenteita tai kohdesivun varsinaista sisältöä ei testata. Raportti tarkistaa vain rakenteen ja yleiset muotosäännöt. Se ei todista, että sisältö on oikeaa, turvallista, kaikkien lukijoiden hyväksymää tai julkaisuvalmista.
RSS 2.0 -syötteiden rakenne ja vaatimukset
RSS 2.0 -formaatilla on tarkat rakenteelliset säännöt, jotka syötteen on täytettävä ollakseen yhteensopiva lukulaitteiden kanssa. RSS-syötteen on sisällettävä tasan yksi suora <channel>-elementti. Jos elementtejä on useampia tai ei lainkaan, työkalu antaa virheilmoituksen.
Jokaisen kanavan sisällä olevan item-elementin kohdalla validoija suorittaa seuraavat tarkistukset:
- Otsikko tai kuvaus: RSS-elementissä on oltava vähintään joko otsikko (
title) tai kuvaus (description). - Tunnisteet ja linkit: Työkalu lukee ja analysoi yksilöllisen tunnisteen (
GUID), linkin (link) sekä julkaisupäivän (publication date). - Päivämäärät: Julkaisupäivän on oltava todellinen päivämäärä ja sen on noudatettava RSS-standardin vaatimaa muotoilua.
Atom 1.0 -syötteiden rakenne ja vaatimukset
Atom 1.0 on uudempi ja tiukemmin määritelty syötemuoto kuin RSS 2.0. Validoija tarkistaa Atom-syötteistä useita erityissääntöjä, jotka liittyvät elementtien periytymiseen ja pakollisuuteen:
- ID-tunnisteet: Atom-syötteen
entry-elementeillä on oltava yksilöllinen ID. Tunnisteen on oltava absoluuttinen IRI-tunniste; suhteelliset tunnisteet eivät ole kelvollisia Atom ID -arvoja. Työkalu varoittaa myös, jos sama ID toistuu syötteessä useammassa kohdassa. - Tekijätiedot (Author inheritance): Atom-syötteessä on oltava määritettynä tekijä. Jos syötetasolla ei ole tekijää, on jokaisella yksittäisellä merkinnällä oltava oma tekijätietonsa.
- Sisältö ja tiivistelmät: Jos Atom-merkinnässä käytetään ulkoista sisältölähdettä
src-attribuutin avulla, elementin sisäinen teksti ja lapsielementit on poistettava. Jos sisältö on ulkoista tai sitä ei voi lukea tekstinä, merkinnälle on annettava tiivistelmä (summary). - Vaihtoehtoiset linkit: Merkinnälle on lisättävä vaihtoehtoinen linkki (
link rel="alternate"), jos siinä ei ole sisäistä sisältöelementtiä.
Linkit ja xml:base-määritteen rooli
Yksi yleisimmistä virheistä syötteissä liittyy suhteellisten ja absoluuttisten linkkien käyttöön. RSS- ja Atom-syötteiden lukijat vaativat yleensä absoluuttisia osoitteita, jotta ne voivat ohjata käyttäjän oikealle sivustolle.
Atom-syötteissä suhteelliset viittaukset ovat kuitenkin sallittuja, jos syötteessä käytetään xml:base-määritettä. Validoija osaa ratkaista suhteelliset Atom-viittaukset xml:base-arvon perusteella. Jos tätä määritettä ei ole tai sitä ei voida käyttää, suhteelliset linkit merkitään virheiksi, sillä vain Atom-viittaukset, joilla on käyttökelpoinen xml:base, voivat olla suhteellisia. Kaikkien muiden linkkikenttien on oltava suoraan jäsenneltävissä URL- tai URI-viittauksiksi.
Yleiset virheet ja niiden korjaaminen
Validoinnin aikana työkalu voi ilmoittaa useista erilaisista rakenteellisista ja syntaktisista virheistä. Alla olevaan taulukkoon on koottu tyypillisiä virhetilanteita ja niiden korjausohjeita:
| Virhetilanne | Syy ja korjaustoimenpide |
|---|---|
| XML-jäsennysvirhe | Syötteen XML-muotoilu on rikki. Korjaa virheellinen XML ja validoi uudelleen. |
| DOCTYPE-määrittely | Syöte sisältää DOCTYPE-määrittelyn. Poista DOCTYPE-määrittely ennen syötteen tarkistamista. |
| Tuntematon tai väärä versio | Syöte on vanhempaa muotoa tai sen versio on virheellinen. Validoija tukee RSS 2.0- ja Atom 1.0 -muotoja. |
| Puuttuva pakollinen kenttä | Syötteestä puuttuu vaadittu elementti. Lisää pakollinen kenttä raportin osoittamaan paikkaan. |
| Toistuva ID | Sama yksilöllinen tunniste esiintyy useasti. ID-arvon on oltava uniikki koko syötteessä. |
Jos syötteessä on erittäin paljon ongelmia tai merkintöjä, työkalu rajoittaa näytettävien tietojen määrää suorituskyvyn varmistamiseksi. Raportissa näytetään enintään 200 ongelmaa ja 100 merkintää kerrallaan. Jos nämä rajat ylittyvät, työkalu ilmoittaa asiasta katkaisuhuomautuksella.
Usein kysytyt kysymykset
Mitä syötemuotoja validoija tukee?
Se validoi nykyiset RSS 2.0- ja Atom 1.0 -asiakirjat. Vanhemmat RSS-, RDF/RSS 1.0- ja Atom 0.3 -syötteet tunnistetaan, mutta niitä ei tarkisteta väärillä säännöillä.
Avaako tai testaako se syötteen linkkejä?
Se jäsentää linkkejä sisältävät kentät ja ratkaisee suhteelliset Atom-viittaukset xml:base-arvolla. URL-osoitteita ei avata, joten saatavuutta, uudelleenohjauksia, varmenteita tai kohteen sisältöä ei testata.
Mitkä merkintäkentät tarkistetaan?
RSS item -elementistä tarkistetaan otsikko tai kuvaus ja luetaan GUID, linkki ja julkaisupäivä. Atom entry -elementistä tarkistetaan ID, otsikko, updated, author-periytyminen, vaihtoehtoiset linkit sekä content- tai summary-säännöt.
Miksi saan virheilmoituksen suhteellisesta linkistä?
Syötteiden linkkien on oltava pääsääntöisesti absoluuttisia, jotta lukulaitteet toimivat oikein. Ainoastaan Atom-syötteissä suhteelliset viittaukset ovat sallittuja, ja silloinkin vain silloin, kun syötteessä on määritetty toimiva xml:base-määrite osoitteen perustan määrittämiseksi.