منسّق XML وأداة التحقق منه

كيف تستخدم منسّق XML

1. الصق XML الخاص بك في مربع الإدخال: مظروف SOAP أو موجز RSS أو خريطة موقع أو ملف SVG أو ملف إعدادات.
2. انقر تنسيق لتنسيقه بعنصر واحد في كل سطر ومسافات بادئة متسقة.
3. انقر تصغير لإزالة المسافات البيضاء بين الوسوم والحصول على أصغر نسخة ممكنة.
4. إذا لم يكن المستند سليم البنية، تبلّغ أداة الفحص بما حدث من خطأ وبمكانه لتنتقل مباشرةً إلى المشكلة.
5. انسخ النتيجة إلى محررك أو طلبك.

يتم التحليل محليًا في متصفحك. لا يُرفع XML الذي تلصقه ولا يُخزَّن، فيمكنك العمل بأمان مع حمولات واجهات برمجة التطبيقات الداخلية والإعدادات.

ما هو XML ولماذا ننسّقه؟

XML (لغة الترميز القابلة للتوسعة) معيار من W3C لتمثيل البيانات المنظّمة على هيئة عناصر مسمّاة متداخلة مع سمات اختيارية. وهو ما زال في كل مكان: خدمات الويب SOAP وموجزات RSS وAtom وخرائط مواقع XML وملفات Microsoft Office وتخطيطات Android وملفات Maven pom.xml ورسومات SVG كلها XML.

كثيرًا ما يُكتب XML الذي تولّده البرامج في سطر واحد أو بمسافات بادئة غير منتظمة. ويجعل التنسيق التسلسل الهرمي مرئيًا، فتتتبّع أي عنصر يتبع أي أب وتكتشف قيمة وُضعت في مكان خاطئ. ويفيد التصغير (Minify) حين تحتاج إلى تضمين XML في حمولة أخرى أو تقليل حجمه.

XML سليم البنية مقابل XML صالح

كثيرًا ما يُخلط بين هذين المصطلحين:

• يتبع XML سليم البنية (well-formed) قواعد الصياغة في مواصفة XML: عنصر جذر واحد، ووسوم متداخلة ومغلقة بشكل صحيح، وقيم سمات بين علامات اقتباس، وأحرف خاصة مُهرَّبة. وكل محلّل XML يشترط ذلك.
• XML الصالح (valid) هو سليم البنية ويتوافق أيضًا مع مخطط (DTD أو XSD أو RELAX NG) يحدد العناصر والسمات المسموح بها.

تفحص هذه الأداة سلامة البنية. أما التحقق من المخطط فيحتاج إلى ملف المخطط ويتم عادةً في أدوات البناء أو بيئة التطوير لديك.

أخطاء XML الشائعة وكيفية إصلاحها

أكثر من عنصر جذر واحد. يجب أن يحتوي مستند XML على عنصر واحد بالضبط في المستوى الأعلى:

<item>A</item>
<item>B</item>

غلّف العناصر الشقيقة في أب واحد:

<items>
  <item>A</item>
  <item>B</item>
</items>

وسوم غير متطابقة أو متداخلة بشكل خاطئ. يجب أن تُغلق الوسوم بترتيب عكسي وأسماؤها حساسة لحالة الأحرف، لذا فإن <Name>…</name> خطأ، وكذلك <b><i>text</b></i>.

أحرف خاصة غير مُهرَّبة. وجود < أو & مجرّدين داخل النص يُفسد التحليل. استخدم الكيانات المعرّفة مسبقًا:

مثلًا، يجب كتابة عنوان URL في خريطة موقع هكذا <loc>https://example.com/?a=1&amp;b=2</loc>. أو يمكنك تغليف الكتل النصية الكبيرة في قسم <![CDATA[ … ]]>، حيث لا تُفسَّر أحرف الترميز.

سمات بلا علامات اقتباس. خلافًا لـ HTML، يشترط XML علامات اقتباس حول كل قيمة سمة: <user id="42"> لا <user id=42>.

محتوى قبل إعلان XML. إن وُجد، فيجب أن يكون <?xml version="1.0" encoding="UTF-8"?> أول ما في الملف تمامًا. حتى مسافة واحدة أو سطر فارغ قبله يجعل المستند فاسد البنية.

نصائح وأفضل الممارسات

• صرّح بالترميز واحفظ الملفات بصيغة UTF-8 لتجنّب مشكلات الأحرف المشكّلة.
• احذر عند تنسيق المستندات التي تكون المسافات البيضاء فيها ذات معنى، كالمحتوى المختلط أو العناصر التي تستخدم xml:space="preserve"؛ فإضافة فواصل الأسطر قد تغيّر قيمة النص.
• استخدم مساحات الأسماء باتساق: يجب التصريح ببادئة مثل soap: بسمة xmlns:soap على العنصر أو على أحد أسلافه.
• هل تحتاج إلى تضمين XML في عنوان URL أو سلسلة JSON؟ رمّزه أولًا باستخدام ترميز وفك ترميز URL أو ترميز وفك ترميز Base64.

الأسئلة الشائعة

هل HTML هو نفسه XML؟

لا. HTML أكثر تسامحًا: فهو يسمح بعناصر غير مغلقة مثل <br> وسمات بلا علامات اقتباس وأسماء وسوم غير حساسة لحالة الأحرف. أما XHTML فهو نسخة من HTML تتبع قواعد XML. ولترتيب صفحات الويب العادية استخدم منسّق HTML بدلًا من ذلك.

هل يغيّر التنسيق بياناتي؟

يضيف التنسيق مسافات بيضاء بين العناصر، ويزيلها التصغير. تبقى أسماء العناصر والسمات ومحتوى النص كما هي، لكن في المستندات التي تكون فيها المسافات البيضاء داخل النص ذات دلالة قد تكون للمسافات البادئة الإضافية أهمية.

هل تتحقق هذه الأداة من المخطط XSD؟

لا. إنها تفحص أن المستند سليم البنية. أما التحقق مقابل DTD أو XSD فيتطلب المخطط ومحلّلًا يتحقق من الصلاحية.

لماذا يفشل XML الخاص بي عند وجود علامة &؟

في XML تبدأ & دائمًا إشارة إلى كيان. ويجب كتابة العلامة المجرّدة، الشائعة في عناوين URL وأسماء الشركات، هكذا & أو وضعها داخل قسم CDATA.

آخر تحديث 2026-10-16