Kung minsan mas madaling maunawaan kung paano sumulat ng mahusay na nabuo na XML sa pamamagitan ng pagtingin sa isang halimbawa. Ang newsletter ng Web Writer ay isinulat gamit ang isang form ng XML - tinatawag namin itong AML o Tungkol sa Markup Language (pumunta figure). Bagaman ito ay isang dokumentong nagtatrabaho, hindi talaga ito isang mahusay na nabuo o wastong dokumentong XML.
Mahusay na Binuo
Mayroong ilang partikular na panuntunan upang lumikha ng isang mahusay na nabuo na dokumento ng XML:
- Ang deklarasyon ng XML ay dapat unang dumating sa bawat dokumento.
- Ang mga komento ay hindi wasto sa loob ng isang tag. Ang mga komento ay hindi maaaring maglaman ng dalawang gitling sa isang hilera, maliban sa simula at wakas ng komento.
- Ang mga tag ay dapat magkaroon ng isang dulo tag, o sarado sa loob ng singleton tag mismo, halimbawa
. - Ang lahat ng mga katangian ng mga tag ay dapat na naka-quote, mas mabuti double quotes maliban kung ang attribute mismo ay naglalaman ng isang double quote.
- Ang bawat XML na dokumento ay dapat maglaman ng isang elemento na ganap na naglalaman ng lahat ng iba pang mga elemento.
Mayroon lamang dalawang problema sa dokumento na hindi ito nabuo:
Ang unang bagay na kailangan ng dokumento ng AML ay isang statement ng deklarasyon ng XML.
Ang iba pang problema ay wala na ang isang elemento na ganap na naglalagay ng lahat ng iba pang mga sangkap. Upang ayusin ito, magdaragdag kami ng isang panlabas na elemento ng lalagyan: Ang paggawa ng dalawang simpleng mga pagbabago (at tiyakin na ang lahat ng mga elemento ay naglalaman lamang ng CDATA) ay i-on ang di-mahusay na nabuo na dokumento sa isang mahusay na nabuo na dokumento. Ang isang wastong dokumento ng XML ay napatunayan laban sa isang Dokumento Uri ng Kahulugan (DTD) o XML Schema. Ang mga ito ay isang hanay ng mga patakaran na nilikha ng developer o isang pamantayan ng organisasyon na tumutukoy sa mga semantika ng XML na dokumento. Ang mga ito ay nagsasabi sa computer kung ano ang gagawin sa markup. Sa kaso ng About Markup Language, dahil hindi ito isang karaniwang XML na wika, tulad ng XHTML o SMIL, ang DTD ay gagawin ng developer. Ang DTD ay malamang na maging sa parehong server bilang dokumento ng XML at isinangguni sa itaas ng dokumento. Bago ka magsimula pagbuo ng isang DTD o panukala para sa iyong mga dokumento, dapat mong maunawaan na sa pamamagitan lamang ng pagiging mahusay na nabuo, isang XML dokumento ay self-naglalarawan, at sa gayon ay hindi nangangailangan ng isang DTD. Halimbawa, sa aming mahusay na nabuo na dokumento ng AML, may mga sumusunod na tag: Kung pamilyar ka sa newsletter ng Web Writer, maaari mong makilala ang iba't ibang mga seksyon ng newsletter. Ginagawa nitong napakadaling lumikha ng bagong mga dokumento sa XML gamit ang parehong standard na format. Lagi naming ilagay ang buong pamagat ng haba sa tag, at ang unang seksyon na URL sa tag. Kung kinakailangang sumulat ng isang wastong dokumento ng XML, gamitin ang data o iproseso ito, isasama mo ito sa iyong dokumento gamit ang tag. Sa tag na ito, tinutukoy mo ang batayang XML na tag sa dokumento at ang lokasyon ng DTD (karaniwang isang Web URI). Halimbawa:
Isang magandang bagay tungkol sa mga deklarasyon ng DTD ay na maaari mong ipahayag na ang isang DTD ay lokal sa sistema kung saan ang XML na dokumento ay may "SYSTEM". Maaari mo ring ituro sa isang pampublikong DTD, tulad ng isang HTML 4.0 na dokumento:
Kapag ginamit mo ang pareho, sinasabi mo ang dokumento upang gumamit ng isang tukoy na DTD (ang pampublikong tagatukoy) at kung saan ito matatagpuan (ang tagatukoy ng system). Sa wakas, maaari mong isama ang isang panloob na DTD nang direkta sa dokumento, sa loob ng DOCTYPE tag. Halimbawa (hindi ito isang kumpletong DTD para sa dokumento ng AML):
> Upang lumikha ng wastong dokumentong XML, maaari ka ring gumamit ng isang dokumento ng XML Schema upang tukuyin ang iyong XML. Ang XML Schema ay isang XML na dokumento na naglalarawan ng mga XML na dokumento. Alamin kung paano magsulat ng isang schema. Ang pagturo lang sa isang DTD o XML Schema ay hindi sapat. Dapat sundin ng XML na nasa dokumento ang mga panuntunan sa DTD o Schema. Ang paggamit ng isang pagpapatunay na parser ay isang simpleng paraan upang masuri na ang iyong XML ay sumusunod sa mga panuntunan ng DTD. Maaari kang makahanap ng maraming mga naturang parser online.
DTDs
XML Schema
Tandaan