مُنسّق XML

تفريغات XML المصغّرة من خدمات SOAP وموجزات RSS وتصديرات الإعدادات غير قابلة للقراءة في سطر واحد. يحلل هذا المُنسّق المستند، ويعيد بناءه بإزاحة متسقة بمقدار مسافتين، ويحفظ ترتيب السمات وأقسام CDATA، ويبلّغ عن أي مشكلة في التشكيل الصحيح مع رقم السطر لتصلح الوسوم غير المتطابقة دون بحث.

كيفية تنسيق XML

  1. 1

    الصق XML

    حتى 200 ألف حرف من XML بترميز UTF-8؛ ويُحفظ إعلان XML.

  2. 2

    نسّق

    يبني المحلل DOM ثم يعيد التسلسل بتباعد متسق.

  3. 3

    انسخ النتيجة

    المخرَج هو XML صحيح التشكيل جاهز للصق في السجلات أو الوثائق.

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

  • إعلان XML يبقى كما كتبته تمامًا، بعلامات الاقتباس واسم الترميز وقيمة standalone، وإذا لم يكن في XML إعلان فلن يُضاف إليه. وتبقى الحروف المرئية كما هي (العربية واليابانية والحروف ذات العلامات والرموز التعبيرية)، ويصبح المرجع الرقمي مثل é هو é. والنتيجة بترميز UTF-8، لذا إذا ذكر الإعلان ترميزًا آخر (مثل ISO-8859-1) فغيّره إلى UTF-8 قبل حفظ الملف.
  • إعلانات DOCTYPE التي تذكر نوع المستند وملف DTD خارجيًا فقط (ملفات plist من Apple، وملفات mapper في MyBatis، وإعدادات Hibernate) تُحفظ، ولا يُنزَّل ملف DTD أبدًا. أما DOCTYPE الذي يحتوي على مجموعة فرعية داخلية ([...]) أو إعلانات ENTITY فيُرفض، وكذلك عنوان DTD ليس http أو https أو مسارًا نسبيًا.
  • تعليمات المعالجة (<?xml-stylesheet ?>) تُبقى في سطر خاص بها.
  • التعليقات في سطر خاص بها أو ضمن السطر حسب السياق.
  • أقسام CDATA تُحفظ تماما بما في ذلك المسافة البيضاء داخلها.
  • قيم السمات يُعاد اقتباسها بعلامات اقتباس مزدوجة إن لم تحتو على مزدوجة، وبمفردة خلاف ذلك.
  • المراجع: تبقى &amp; و&lt; و&gt; كما هي. أما الحروف التي لا تظهر أو التي تغيّر اتجاه النص (مثل علامتي الاتجاه U+200E وU+200F، وU+202E، والمسافات صفرية العرض) فتُكتب في النص وقيم السمات بصيغة مراجع رقمية مثل &#x202E; حتى تتمكن من رؤيتها، وتبقى كما كتبتها داخل التعليقات وأقسام 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>

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

الخطأ الإصلاح
وسم إغلاق غير متطابق طابق اسمي الفتح والإغلاق
عنصر غير مغلق أضف وسم الإغلاق
حرف غير صالح في اسم وسم يجب أن تبدأ أسماء الوسوم بحرف أو شرطة سفلية
سمات مكررة على العنصر نفسه أزل المكررة
CDATA مشوّه تحقق من اقتران <![CDATA[ و]]>
< أو & غير مهروب في النص استخدم &lt; أو &amp;

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

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

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

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

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

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

نعم. النص داخل عناصر المحتوى المختلط وأقسام CDATA يُبقى كما هو؛ وتُضبط فقط المسافة البيضاء بين العناصر لأجل الإزاحة.

نعم، حتى 200 ألف حرف في كل مرة تلصق فيها، ويمكن أن يحمل العنصر الواحد حتى 256 سمة. للملفات الأكبر استخدم مُنسّقا تدفقيا مثل xmllint على سطر الأوامر.

نعم. تبقى إعلانات مساحات الأسماء على العنصر الذي كتبتها فيه، وتُحفظ البادئات كما هي تمامًا.

لا. يُرسَل XML الخاص بك إلى خادمنا لتنسيقه ولا يُحفظ هناك. وأثناء انتقالك بين الخطوات، تحتفظ الصفحة بما لصقته في علامة التبويب هذه من المتصفح فقط.

أدوات ذات صلة

عدّاد FPS

قِس معدل الإطارات FPS في المتصفح عبر requestAnimationFrame: تنعيم، وأدنى وأقصى معدل إطارات، وحد تنبيه، ورسم بياني اختياري. يعمل محليًا بلا رفع ملفات وبلا API.

مرجع جدول ASCII

جدول ASCII كامل من 0 إلى 127 مع التمثيل العشري والست عشري والثماني والثنائي والمرجع الرقمي في HTML لكل محرف، بما في ذلك أكواد التحكم مثل NUL وLF وDEL.

مولّد مؤشرات التحميل بلغة CSS

أنشئ دوّارًا دائريًا بـ CSS خالص: اضبط القطر وسماكة الحدود واللون وسرعة الدوران، وشاهد المعاينة المباشرة، وانسخ كود CSS جاهزًا للاستخدام. بلا SVG وبلا JavaScript.

مدقّق OpenAPI

الصق مستند OpenAPI أو Swagger بصيغة JSON أو YAML وافحص بنيته الأساسية: حقل الإصدار وكائن info والمسارات، مع أخطاء وتحذيرات واضحة.

مولد ظلال الألوان

توليد ظلال أغمق من لون أساسي بصيغة HEX عبر 3 إلى 20 خطوة متساوية، مفيدة للوحات نظام التصميم وحالات التمرير/الضغط.

منسّق PHP

أضف فواصل أسطر ومسافات بادئة من مسافتين أو 4 مسافات إلى مقطع PHP بسيط. راجع النتيجة: فهذه الأداة ليست محلّل PHP ولا تطبّق PSR-12.

الأداة متاحة بلغات أخرى