Ponekad je lakše razumjeti kako napisati dobro oblikovani XML tako što ćete vidjeti primjer. Bilten web pisača napisan je pomoću XML formulara - zovemo ga AML ili O Markup Language (go figure). Iako je riječ o radnoj dokumentaciji, to zapravo nije dobro formirana ili valjana XML dokument.
Dobro oblikovan
Postoje određena pravila za stvaranje dobro oblikovanog XML dokumenta:
- XML deklaracija mora biti prva u svakom dokumentu.
- Komentari nisu važeći u oznaci. Komentari ne smiju sadržavati dva crtica u nizu, osim početka i kraja komentara.
- Oznake moraju imati završnu oznaku ili biti zatvorene unutar samog oznake singletona, na primjer
. - Navedite sve atribute oznaka, poželjno dvostruke navodnike, osim ako sam atribut sadrži dvostruki citat.
- Svaki XML dokument mora sadržavati jedan element koji u potpunosti sadrži sve ostale elemente.
Dokumentom koji ga čine dobro nije formiran samo dva problema:
Prva stvar koju AML dokument treba je izjava XML deklaracije.
Drugi je problem što ne postoji niti jedan element koji u potpunosti zatvara sve ostale elemente. Da biste to ispravili, dodat ćemo vanjski element spremnika: Izvršenje tih dviju jednostavnih promjena (i osiguranje da svi elementi sadrže samo CDATA) pretvoriti će nepravilno oblikovan dokument u dobro oblikovani dokument. Važeći XML dokument potvrđen je prema definiciji vrste dokumenta (DTD) ili XML sheme. Ovo su skup pravila koja je izradio razvojni programer ili organizacija standarda koja definira semantiku XML dokumenta. Ove informacije govore računalu o tome što treba učiniti s markupom. U slučaju O Markup Language, budući da to nije standardni XML jezik, kao što je XHTML ili SMIL, razvojni programer stvara DTD. Taj DTD najvjerojatnije bi bio na istom poslužitelju kao i XML dokument i naveden na vrhu dokumenta. Prije nego što započnete s razvojem DTD-a ili sheme za svoje dokumente, trebali biste shvatiti da je jednostavno oblikovanjem XML dokument samoopisivanje i stoga ne treba DTD. Na primjer, s našim dobro oblikovanim AML dokumentom, postoje sljedeće oznake: Ako ste upoznati s web biltenom Web Writera, možete prepoznati različite odjeljke newslettera. To olakšava izradu novih XML dokumenata u istom standardnom formatu. U oznaci smo uvijek stavili naslov u punoj duljini, a prvi URL odjeljka u oznaci. Ako ste dužni napisati valjani XML dokument, bilo da koristite podatke ili ih želite obraditi, uključili biste ih u dokument s oznakom. U ovoj oznaci definiramo osnovnu XML oznaku u dokumentu i mjestu DTD-a (obično Web URI). Na primjer:
Jedna lijepa stvar o DTD deklaracijama je da možete izjaviti da je DTD lokalna u sustavu gdje je XML dokument s "SYSTEM". Možete javiti i javnom DTD-u, kao što je HTML 4.0 dokument:
Kada upotrebljavate oboje, govorite dokumentu da koristi određeni DTD (javni identifikator) i gdje ga pronaći (identifikator sustava). Konačno, možete interno uključiti DTD u dokument, unutar oznake DOCTYPE. Na primjer (nije kompletan DTD za AML dokument):
> Da biste stvorili valjani XML dokument, možete upotrijebiti XML Schema dokument za definiranje XML-a. XML Shema je XML dokument koji opisuje XML dokumente. Saznajte kako napisati shemu. Samo upućivanje na DTD ili XML Schema nije dovoljno. XML koji se nalazi u dokumentu mora slijediti pravila u DTD-u ili shemi. Upotreba potvrde za parser jednostavan je način da provjerite slijedi li vaš XML DTD pravila. Mnogo takvih parsera možete pronaći na mreži.
DTDs
XML shema
Bilješka