V tem članku je razloženo, kako pravilno pisati XML s prikazom primera. Glasilo Web Writer je napisano v obliki XML; imenujemo ga AML ali About Markup Language. Čeprav je to delovni dokument, ni dobro oblikovan ali veljaven dokument XML.
Dobro oblikovan
Obstaja nekaj posebnih pravil za ustvarjanje dobro oblikovanega dokumenta XML:
- Izjava XML mora biti na prvem mestu v vsakem dokumentu.
- Komentarji znotraj oznake niso veljavni. Komentarji ne smejo vsebovati dveh vezajev zapored, razen začetka in konca komentarja.
- Oznake morajo imeti končno oznako ali pa morajo biti na primer zaprte znotraj same oznake singleton.
- Navesti je treba vse atribute oznak, po možnosti dvojne narekovaje, razen če atribut sam vsebuje dvojne narekovaje.
- Vsak dokument XML mora vsebovati en element, ki v celoti vsebuje vse ostale elemente.
Z dokumentom obstajata le dve težavi, zaradi katerih dokument ni dobro oblikovan:
- Prva stvar, ki jo potrebuje dokument AML, je izjava o izjavi XML.
- Druga težava je, da noben element popolnoma ne zapre vseh ostalih elementov. Da bi to popravili, bomo dodali zunanji element vsebnika:
Če naredite ti dve preprosti spremembi (in zagotovite, da bodo vsi elementi vsebovali samo CDATA), se neoblikovan dokument spremeni v dobro oblikovan dokument.
Veljavni dokument XML je preverjen glede na definicijo vrste dokumenta (DTD) ali shemo XML. To je nabor pravil, ki jih je ustvaril razvijalec ali organizacija za standarde, ki opredeljujejo semantiko dokumenta XML. Ti računalniku povedo, kaj naj naredi z oznako.
V primeru O Označevalni jezik, ker to ni standardni jezik XML, kot sta XHTML ali SMIL, bi DTD ustvaril razvijalec. Ta DTD bi bil najverjetneje na istem strežniku kot dokument XML in naveden na vrhu dokumenta.
Preden začnete razvijati DTD ali shemo za svoje dokumente, se morate zavedati, da dokument XML s svojo dobro oblikovano obliko samo opisuje in zato ne potrebuje DTD.
Na primer, v našem dobro oblikovanem dokumentu AML so naslednje oznake:
Če poznate glasilo Web Writer, boste morda prepoznali različne oddelke glasila. Tako je zelo enostavno ustvarjati nove dokumente XML v isti standardni obliki. V oznako bi vedno vnesli celozaslonski naslov, v oznako pa URL prvega odseka.
DTD
Če morate napisati veljaven dokument XML, bodisi za uporabo podatkov bodisi za njihovo obdelavo, ga vključite v dokument z oznako. V tej oznaki določite osnovno oznako XML v dokumentu in lokacijo DTD (običajno spletni URI).
Na primer:
Ena lepa stvar pri izjavah DTD je, da lahko izjaviš, da je DTD lokalni za sistem, v katerem je Dokument XML ima "SISTEM". Lahko tudi pokažete na javni DTD, na primer z dokumentom HTML 4.0:
Ko uporabljate oboje, dokumentu naročite, naj uporabi določen DTD (javni identifikator) in kje ga najti (sistemski identifikator).
Nazadnje lahko v dokument vključite tudi notranji DTD znotraj oznake DOCTYPE. Na primer (to ni popoln DTD za dokument AML):
Shema XML
Če želite ustvariti veljaven dokument XML, lahko za definiranje XML uporabite tudi dokument sheme XML. Shema XML je dokument XML, ki opisuje dokumente XML. Naučite se napisati shemo.
Opomba
Samo kazanje na shemo DTD ali XML ni dovolj. XML, ki je v dokumentu, mora upoštevati pravila v DTD ali shemi. Uporaba validacijskega razčlenjevalnika je preprost način, da preverite, ali vaš XML sledi pravilom DTD. V spletu lahko najdete veliko takšnih razčlenjevalnikov.