XML-muotoilija

Näin muotoilet XML:n

1. Liitä XML tai napsauta Avaa tiedosto ladataksesi .xml-, .svg-, .xsd-, .xsl-, RSS- tai muun XML-tiedoston (enintään 10 Mt).
2. Valitse Sisennys: 2 välilyöntiä, 4 välilyöntiä tai tabulaattori.
3. Napsauta Muotoile (siisti) saadaksesi luettavan, sisennetyn XML:n, tai Minimoi saadaksesi mahdollisimman tiiviin version. Validoi vain tarkistaa dokumentin ja jättää tuloksen ennalleen.
4. Valitse Poista kommentit, jos haluat pudottaa <!-- … -->-kommentit tuloksesta.
5. Kopioi tai lataa tulos.

Jokainen toiminto tarkistaa ensin, että dokumentti on hyvinmuodostettu. Jos se ei ole, mitään ei muuteta ja virheilmoitus kertoo ongelman rivin ja sarakkeen.

Mitä muotoilija tekee

Muotoile (siisti) sijoittaa jokaisen elementin omalle rivilleen sisennettynä syvyytensä mukaan:

<catalog>
  <book id="1">
    <title>XML &amp; you</title>
    <tags/>
  </book>
</catalog>

• Elementti, joka sisältää vain tekstiä, pysyy yhdellä rivillä, kuten yllä oleva <title>; tekstin ympärillä olevat tyhjät merkit poistetaan.
• Attribuutit säilyttävät järjestyksensä, arvonsa ja lainausmerkkityylinsä; vain niiden välillä olevat välilyönnit normalisoidaan.
• Kommentit, CDATA-osiot, käsittelyohjeet ja XML-ilmoitus säilytetään.
• Elementti, jolla on xml:space="preserve", kopioidaan täsmälleen sellaisenaan, tyhjät merkit mukaan lukien.
• Entiteetit, kuten & tai ä, jätetään koskemattomiksi: tekstiä ei koskaan pureta ja koodata uudelleen.

Minimoi poistaa tunnisteiden välisen tyhjän tilan ja, jos valittu, kommentit. Tekstisisältö säilytetään sellaisenaan. Tilarivi näyttää koon ennen ja jälkeen tavuina.

Mitä “hyvinmuodostettu” tarkoittaa

Hyvinmuodostettu XML-dokumentti noudattaa XML 1.0:n syntaksisääntöjä:

• juurielementtejä on täsmälleen yksi;
• jokaisella avaavalla tunnisteella on vastaava sulkeva tunniste, oikein sisäkkäin (<a><b></b></a>, ei koskaan <a><b></a></b>), tai se on itsesulkeva (<br/>);
• attribuuttien arvot ovat lainausmerkeissä, eikä sama attribuutti esiinny kahdesti elementissä;
• < ja & tekstissä escapetaan muodossa < ja &;
• nimet erottelevat kirjainkoon: <Title> ei sulkeudu merkinnällä </title>.

Tarkistus käyttää selaimesi sisäänrakennettua XML-jäsennintä, joten harvinaisempien tapausten (ilmoittamattomat entiteetit, virheelliset merkit, nimiavaruuden etuliitteet) virheilmoitukset tulevat itse selaimelta ja ovat sen kielellä. Hyvinmuodostettu ei ole sama asia kuin kelvollinen DTD:n tai XSD-skeeman suhteen: tämä työkalu ei tarkista skeemoja.

Käyttövinkkejä

Muotoilu helpottaa huomattavasti XML-tiedostojen lukemista, vertailua ja versionhallintaa: kun jokainen elementti on omalla rivillään, muutokset näkyvät muutoshistoriassa selvästi rivikohtaisina eroina. Minimointi taas pienentää siirrettävän datan kokoa, esimerkiksi kun XML upotetaan rajapintapyyntöön tai asetukseen. Jos saat virheilmoituksen, korjaa aina ensimmäinen virhe ensin, sillä yksi puuttuva sulkeva tunniste voi aiheuttaa useita seurannaisvirheitä myöhemmin dokumentissa. Suomalaiset ääkköset ja muut Unicode-merkit säilyvät sellaisinaan, kunhan tiedosto on tallennettu UTF-8-koodauksella.