مُنسّق XML

ما الذي يحفظه التنسيق

• إعلان XML (<?xml version="1.0" encoding="UTF-8"?>) يُحفظ حرفيا.
• إعلانات DOCTYPE والمجموعات الفرعية الداخلية تُحفظ.
• تعليمات المعالجة (<?xml-stylesheet ?>) تُبقى في سطر خاص بها.
• التعليقات في سطر خاص بها أو ضمن السطر حسب السياق.
• أقسام CDATA تُحفظ تماما بما في ذلك المسافة البيضاء داخلها.
• قيم السمات يُعاد اقتباسها بعلامات اقتباس مزدوجة إن لم تحتو على مزدوجة، وبمفردة خلاف ذلك.
• مراجع الكيانات مثل & و< و> تُترك كما هي ما لم تفعّل توسيع الكيانات الكامل.

أمثلة الإزاحة

المُدخل (مصغّر):

<books><book id="1"><title>1984</title><author>George Orwell</author></book></books>

منسّق (مسافتان):

<books>
  <book id="1">
    <title>1984</title>
    <author>George Orwell</author>
  </book>
</books>

الأخطاء الشائعة التي تلتقطها الأداة

صحيح التشكيل مقابل صالح

• صحيح التشكيل XML يتبع القواعد النحوية: وسوم متوازنة، وأحرف صالحة، وتداخل سليم. تتحقق الأداة من هذا.
• صالح XML يتوافق إضافة إلى ذلك مع مخطط (DTD أو XSD). لذلك، استخدم مدقق XSD.

يمكن أن يكون مستند XML صحيح التشكيل دون أن يكون صالحا، لكن ليس العكس.

ملاحظات عملية

• ترتيب سمات XML ذو معنى لبعض الأنظمة (ليس كثيرا من الحديثة)، يحفظ المُنسّق ترتيب المُدخل.
• الوسوم ذاتية الإغلاق مقابل الوسوم الفارغة الصريحة: <foo/> و<foo></foo> متكافئان في XML؛ يستخدم المُنسّق ذاتية الإغلاق للعناصر الفارغة ما لم تنسحب من ذلك.
• بادئات مساحات الأسماء تُحفظ تماما.