Ovaj članak objašnjava kako pravilno pisati XML pokazujući primjer. Bilten Web Writer napisan je u obliku XML-a; nazivamo ga AML ili About Markup Language. Iako je ovo radni dokument, to nije dobro oblikovan ili valjan XML dokument.
Dobro oblikovano
Postoje neka posebna pravila za stvaranje dobro oblikovanog XML dokumenta:
- XML deklaracija mora biti na prvom mjestu u svakom dokumentu.
- Komentari nisu valjani unutar oznake. Komentari ne smiju sadržavati dvije crtice u nizu, osim početka i kraja komentara.
- Oznake moraju imati završnu oznaku ili, na primjer, biti zatvorene unutar same singleton oznake.
- Svi atributi oznaka moraju se navoditi, po mogućnosti dvostruki navodnici, osim ako sam atribut sadrži dvostruke navodnike.
- Svaki XML dokument mora sadržavati jedan element koji u potpunosti sadrži sve ostale elemente.
Postoje samo dva problema s dokumentom zbog kojih nije dobro oblikovan:
- Prva stvar koja AML dokumentu treba je izjava XML deklaracije.
- Drugi je problem što niti jedan element u potpunosti ne zatvara sve ostale elemente. Da bismo to popravili, dodat ćemo vanjski element spremnika:
Izvođenjem te dvije jednostavne promjene (i osiguravanjem da svi elementi sadrže samo CDATA) pretvorit će neoblikovani dokument u dobro oblikovan dokument.
Važeći XML dokument provjerava se prema definiciji vrste dokumenta (DTD) ili XML shemi. To su skup pravila koja je stvorio programer ili organizacija za standardizaciju koja definiraju semantiku XML dokumenta. Oni računalu govore što da radi s oznakama.
U slučaju O Označni jezik, jer ovo nije standardni XML jezik, poput XHTML ili SMIL, DTD bi stvorio programer. Taj bi se DTD najvjerojatnije nalazio na istom poslužitelju kao i XML dokument i na njega se navodi na vrhu dokumenta.
Prije nego što započnete s razvojem DTD-a ili sheme za svoje dokumente, trebali biste shvatiti da se XML dokument samooblikovanjem, samo ako je dobro oblikovan, sam opisuje i da mu zato nije potreban DTD.
Na primjer, s našim dobro oblikovanim dokumentom AML postoje sljedeće oznake:
Ako ste upoznati s biltenom Web Writer, možda ćete prepoznati različite odjeljke biltena. To olakšava stvaranje novih XML dokumenata u istom standardnom formatu. Uvijek bismo u oznaku stavili naslov u punoj dužini i URL prvog odjeljka u oznaku.
DTD-ovi
Ako trebate napisati valjani XML dokument, bilo da biste koristili podatke ili ih obrađivali, trebali biste ga dodati u svoj dokument s oznakom. U ovoj oznaci definirate osnovnu XML oznaku u dokumentu i mjesto DTD-a (obično web URI).
Na primjer:
Jedna lijepa stvar kod DTD deklaracija je ta što možete proglasiti da je DTD lokalni sustavu u kojem je XML dokument je sa "SUSTAVOM". Također možete ukazati na javni DTD, na primjer s dokumentom HTML 4.0:
Kada koristite oboje, govorite dokumentu da koristi određeni DTD (javni identifikator) i gdje ga pronaći (sistemski identifikator).
Napokon, možete uključiti interni DTD izravno u dokument, unutar oznake DOCTYPE. Na primjer (ovo nije potpuni DTD za AML dokument):
XML shema
Da biste stvorili važeći XML dokument, također možete koristiti dokument XML sheme za definiranje svog XML-a. XML shema je XML dokument koji opisuje XML dokumente. Saznajte kako napisati shemu.
Bilješka
Samo pokazivanje na DTD ili XML shemu nije dovoljno. XML koji se nalazi u dokumentu mora slijediti pravila u DTD-u ili shemi. Upotreba validacijskog parsera jednostavan je način da provjerite poštuje li vaš XML DTD pravila. Mnogo takvih parsera možete pronaći na mreži.