Artikel ini menjelaskan cara menulis dengan baik XML dengan menunjukkan contoh. Newsletter Web Writer ditulis menggunakan bentuk XML; kami menyebutnya AML atau About Markup Language. Meskipun ini adalah dokumen kerja, ini bukan dokumen XML yang dibuat dengan baik atau valid.
Terbentuk dengan baik
Ada beberapa aturan khusus untuk membuat dokumen XML yang terbentuk dengan baik:
- Deklarasi XML harus didahulukan di setiap dokumen.
- Komentar tidak valid dalam tag. Komentar tidak boleh berisi dua tanda hubung berturut-turut, selain awal dan akhir komentar.
- Tag harus memiliki tag akhir, atau ditutup di dalam tag tunggal itu sendiri, misalnya.
- Semua atribut tag harus dikutip, sebaiknya tanda kutip ganda kecuali atribut itu sendiri berisi tanda kutip ganda.
- Setiap dokumen XML harus berisi satu elemen yang sepenuhnya berisi semua elemen lainnya.
Hanya ada dua masalah dengan dokumen yang membuatnya tidak terbentuk dengan baik:
- Hal pertama yang dibutuhkan dokumen AML adalah pernyataan deklarasi XML.
- Masalah lainnya adalah tidak ada satu elemen yang sepenuhnya menutupi semua elemen lainnya. Untuk memperbaikinya, kami akan menambahkan elemen penampung eksternal:
Membuat dua perubahan sederhana tersebut (dan memastikan bahwa semua elemen hanya berisi CDATA) akan mengubah dokumen yang tidak terbentuk dengan baik menjadi dokumen yang terbentuk dengan baik.
Dokumen XML yang valid divalidasi terhadap Definisi Jenis Dokumen (DTD) atau Skema XML. Ini adalah seperangkat aturan yang dibuat oleh pengembang atau organisasi standar yang mendefinisikan semantik dokumen XML. Ini memberitahu komputer apa yang harus dilakukan dengan markup.
Dalam kasus Tentang Bahasa Markup, karena ini bukan bahasa XML standar, seperti XHTML atau SMIL, DTD akan dibuat oleh pengembang. DTD itu kemungkinan besar akan berada di server yang sama dengan dokumen XML dan dirujuk di bagian atas dokumen.
Sebelum Anda mulai mengembangkan DTD atau Skema untuk dokumen Anda, Anda harus menyadari bahwa hanya dengan dibentuk dengan baik, dokumen XML dapat menggambarkan dirinya sendiri, dan dengan demikian tidak memerlukan DTD.
Misalnya, dengan dokumen AML kami yang terbentuk dengan baik, ada tag berikut:
Jika Anda sudah familiar dengan buletin Web Writer, Anda mungkin mengenali bagian yang berbeda dari buletin. Ini membuatnya sangat mudah untuk membuat dokumen XML baru menggunakan format standar yang sama. Kami akan selalu menempatkan judul panjang penuh di tag, dan URL bagian pertama di tag.
DTD
Jika Anda diminta untuk menulis dokumen XML yang valid, baik untuk menggunakan data atau untuk memprosesnya, Anda akan memasukkannya ke dalam dokumen Anda dengan tag. Dalam tag ini, Anda menentukan tag XML dasar dalam dokumen dan lokasi DTD (biasanya URI Web).
Sebagai contoh:
Satu hal yang menyenangkan tentang deklarasi DTD adalah Anda dapat mendeklarasikan bahwa DTD bersifat lokal ke sistem di mana: Dokumen XML adalah dengan "SYSTEM." Anda juga dapat mengarahkan ke DTD publik, seperti dengan dokumen HTML 4.0:
Saat Anda menggunakan keduanya, Anda memberi tahu dokumen untuk menggunakan DTD tertentu (pengidentifikasi publik) dan di mana menemukannya (pengidentifikasi sistem).
Terakhir, Anda dapat menyertakan DTD internal langsung di dokumen, di dalam tag DOCTYPE. Misalnya (ini bukan DTD lengkap untuk dokumen AML):
Skema XML
Untuk membuat dokumen XML yang valid, Anda juga dapat menggunakan dokumen Skema XML untuk mendefinisikan XML Anda. XML Schema adalah dokumen XML yang menjelaskan dokumen XML. Pelajari cara menulis skema.
Catatan
Hanya menunjuk ke Skema DTD atau XML tidak cukup. XML yang ada di dokumen harus mengikuti aturan di DTD atau Skema. Menggunakan parser yang memvalidasi adalah cara sederhana untuk memeriksa apakah XML Anda mengikuti aturan DTD. Anda dapat menemukan banyak parser seperti itu secara online.