Rules for Creating XML Document with Example and XSD

XML (eXtensible Markup Language) is a markup language used to store and transport data in a structured, self-descriptive format that is both human-readable and machine-readable.

---

Rules for Creating a Well-Formed XML Document

• Rule 1: Every XML document must have exactly one root element that contains all other elements.
• Rule 2: All XML elements must have a closing tag (e.g., <name>...</name>) or be self-closing (e.g., <br/>).
• Rule 3: XML tags are case-sensitive — <Name> and <name> are different.
• Rule 4: XML elements must be properly nested — tags cannot overlap (e.g., <b><i>text</i></b> is correct).
• Rule 5: Attribute values must always be enclosed in quotes (single or double).
• Rule 6: The XML document should begin with an XML declaration: <?xml version="1.0"?>.
• Rule 7: Element names must start with a letter or underscore, not a number or special character.
• Rule 8: No reserved characters like <, >, & should be used directly in content — use entity references (<, >, &).
• Rule 9: White spaces are preserved in XML (unlike HTML).
• Rule 10: Comments are written as <!-- comment --> and cannot appear inside tags.

---

XML File Example (With Simple Type, Attributes, and Nested Elements)

<?xml version="1.0" encoding="UTF-8"?>
<library>
    <book id="101" category="fiction">
        <title>The Alchemist</title>
        <author>Paulo Coelho</author>
        <price>350.00</price>
        <publisher>
            <name>HarperCollins</name>
            <country>USA</country>
        </publisher>
    </book>
    <book id="102" category="science">
        <title>A Brief History of Time</title>
        <author>Stephen Hawking</author>
        <price>500.00</price>
        <publisher>
            <name>Bantam Books</name>
            <country>UK</country>
        </publisher>
    </book>
</library>

Explanation:

• library — Root element
• book — Element with attributes (id, category)
• title, author, price — Simple type elements (contain only text)
• publisher — Nested element containing child elements (name, country)

---

Equivalent XSD (XML Schema Definition)

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <xs:element name="library">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="book" maxOccurs="unbounded">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="title" type="xs:string"/>
                            <xs:element name="author" type="xs:string"/>
                            <xs:element name="price" type="xs:decimal"/>
                            <xs:element name="publisher">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="name" type="xs:string"/>
                                        <xs:element name="country" type="xs:string"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                        <xs:attribute name="id" type="xs:integer" use="required"/>
                        <xs:attribute name="category" type="xs:string" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>

</xs:schema>

Key Points of XSD:

• xs:string, xs:decimal, xs:integer — Simple types for elements
• xs:complexType — Used for elements that have child elements or attributes
• xs:sequence — Ensures child elements appear in a specific order
• xs:attribute — Defines attributes with use="required" to make them mandatory
• maxOccurs="unbounded" — Allows multiple book elements

---

Conclusion

XML provides a flexible way to structure data with strict well-formedness rules. XSD validates the structure, data types, and constraints of an XML document, ensuring data integrity and consistency.