محول كيان HTML

محول كيان HTML أداة مجانية تحوّل بين مراجع محارف HTML والمحارف المفكوكة لاستخدامها في صفحات الويب وأنظمة إدارة المحتوى وغيرها من التنسيقات النصية.

ما كيانات HTML، ولماذا نستخدمها؟

تمثّل كيانات HTML المحارف بصيغة نصية يستطيع HTML تمييزها عن الترميز الخاص به. يبدأ مرجع محرف HTML عادة بعلامة العطف وينتهي بفاصلة منقوطة. وقد يكون مرجعا مسمى، مثل & لتمثيل علامة العطف، أو مرجعا رقميا، مثل £ لتمثيل علامة الجنيه الإسترليني.

تفيد هذه الكيانات عندما يكون للمحرف معنى خاص في HTML. فعلامة "أصغر من" المكتوبة مباشرة قد تُفسّر على أنها بداية وسم، لذلك يمكن كتابتها بصيغة <. وتتيح مراجع المحارف أيضا تمثيل محارف معينة داخل HTML أو لغات الترميز المتوافقة معه، من دون الخلط بينها وبين الوسوم أو صياغة التحكم.

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

كيف أستخدم محول كيان HTML؟

أدخل النص المطلوب في الحقل المسمى ترميز أو فك الترميز، ثم اقرأ النتيجة المقابلة في مرمز ككيان HTML أو مفكوك من كيان HTML. استخدم الناتج المرمز عندما يجب أن يظهر النص داخل سياق مناسب لنص HTML أو سماته، واستخدم الناتج المفكوك عندما تحتاج إلى المحارف التي تمثلها الكيانات الموجودة.

تُجرى عملية التحويل على الخادم. تنتقل مدخلاتك إلى الخادم عبر HTTPS ولا يتم تخزينها.

تحقق أولا مما إذا كنت تحتاج فعلا إلى كيانات HTML. فقيمة سلسلة الاستعلام تحتاج عادة إلى الترميز المئوي لعناوين URL بدلا منها، بينما يستخدم اسم النطاق المدوّل Punycode. وقد خُصصت أداتا فك ترميز URL ومحول IDN Punycode لهذين التنسيقين على الترتيب.

كيف تبدو النتيجة بعد الترميز أو فك الترميز؟

تستبدل نتيجة فك الترميز مراجع الكيانات المعروفة بالمحارف التي تمثلها، بينما تمثل الصيغة المرمزة المحارف باستخدام صياغة الكيانات.

الإدخال: <p>Tea & cake</p>

الناتج بعد فك الترميز: <p>Tea & cake</p>

الأقواس الزاوية في الناتج المفكوك هي محارف قد تتحول إلى وسوم HTML إذا أُدرجت في صفحة بصفتها HTML. لا يؤدي فك الترميز إلى تنقية المحتوى أو إزالة النصوص البرمجية أو جعل HTML غير الموثوق آمنا. تعامل مع المحتوى المفكوك وفقا للسياق الذي ستستخدمه فيه.

أمثلة عملية ومدخلات قد تسبب مشكلات

يمكن للكيانات المسماة ومراجع المحارف الرقمية تمثيل المحرف نفسه بطرق مختلفة. على سبيل المثال، &amp; مرجع مسمى لعلامة العطف، بينما &#38; هو مرجعها الرقمي العشري و&#x26; هو صيغتها السداسية العشرية.

• المسافات العادية والأرقام المكتوبة مباشرة ليست مراجع كيانات، وتظل عادة نصا عاديا.
• لا تتغير علامات الترقيم إلا إذا ظهرت في صورة مرجع كيان معروف أو جرى ترميزها عمدا.
• يمكن تمثيل الأحرف ذات العلامات النطقية والكتابات غير اللاتينية والرموز التعبيرية بمراجع محارف رقمية تحدد نقاط ترميز Unicode بصرف النظر عن ترميز مصدر HTML. يعتمد العرض الصحيح على دعم الخط، بينما يصبح ترميز المحارف مهما عند تخزين الناتج المفكوك أو نقله.

أضف الفاصلة المنقوطة الختامية عند كتابة الكيانات. تتسامح المتصفحات مع بعض المراجع الخالية منها ضمن سياقات محدودة، لكن هذه الصيغة المختصرة قد تكون ملتبسة وأقل قابلية للعمل مع محللات مختلفة.

أين تظهر كيانات HTML في الاستخدام الفعلي؟

تظهر كيانات HTML كثيرا في مصدر HTML وأنظمة إدارة المحتوى ومحررات النص المنسق ورسائل البريد الإلكتروني بتنسيق HTML. على سبيل المثال، قد يحتوي عرض الشفرة في WordPress على &nbsp; لتمثيل مسافة غير قابلة للفصل، أو &amp; عندما يلزم الحفاظ على علامة العطف داخل الترميز.

وقد تظهر أيضا داخل بيانات يحملها تنسيق آخر. يؤدي ذلك إلى وجود عدة طبقات من الترميز يجب التعامل معها بالترتيب الصحيح.

• قد تتضمن حمولة JSON جزءا من HTML يحتوي نصه على كيانات. إلغاء تهريب JSON وفك ترميز كيانات HTML عمليتان منفصلتان.
• قد تحتوي سلسلة استعلام على HTML مرمز ترميزا مئويا. فك طبقة URL أولا، ثم حدد ما إذا كان النص الناتج يحتوي أيضا على كيانات.
• قد يتضمن URI للبيانات محتوى HTML أو نصا آخر يحتوي على كيانات، مع أن URI نفسه قد يستخدم الترميز المئوي أو Base64.
• قد ترمز رسالة بريد إلكتروني بتنسيق HTML علامات الترقيم الظاهرة، مع استخدام ترميز نقل MIME أيضا لأغراض الإرسال.
• قد يظهر اسم نطاق مدوّل بجوار HTML مرمز بالكيانات، لكن اسم النطاق نفسه يُمثّل عادة باستخدام Punycode لا كيانات HTML.

لماذا يفشل فك ترميز كيانات HTML أو ينتج نصا مشوها؟

يفشل فك الترميز عادة لأن المدخلات مكتوبة بصيغة غير صحيحة، أو تستخدم نظام ترميز مختلفا، أو تحتوي على أكثر من طبقة ترميز. افحص النص الأصلي بحثا عن مراجع محارف HTML مسماة أو رقمية، بدلا من تكرار عمليات التحويل من دون التحقق من النتيجة.

• مرجع مكتوب بصيغة غير صحيحة: قد يؤدي غياب علامة العطف أو علامة الرقم أو الفاصلة المنقوطة إلى منع التعرّف على المرجع. قارن النص بصيغ مثل &amp; أو &#38;.
• مدخلات مرمزة مرتين: قد يُفك نص مثل &amp;lt; مرة واحدة إلى &lt;، ثم يحتاج إلى تمريرة أخرى مقصودة ليتحول إلى علامة "أصغر من".
• عدم تطابق مجموعة المحارف: قد يُظهر النص الذي فُسّر باستخدام ترميز محارف غير صحيح رموزا بديلة أو أحرفا ذات علامات نطقية مشوهة.
• تنسيق غير صحيح: قد يكون النص الذي يحتوي على علامات النسبة المئوية مرمزا بتنسيق URL. أما السلسلة الطويلة التي تستخدم الأحرف أو الأرقام أو علامات الجمع أو الشرطات المائلة أو علامات المساواة في نهايتها، فقد تكون Base64.
• إذا كانت المدخلات Base64، فقد يكون المتغير أو الأبجدية غير صحيحين: يستخدم Base64 الآمن لعناوين URL محارف مختلفة عن Base64 القياسي. وقد يؤدي غياب الحشو أيضا إلى تعطل بعض أدوات فك الترميز. لا تتعلق هذه المشكلات بصياغة كيانات HTML، بل تتطلب استخدام فك ترميز Base64.

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

لماذا تبدو &nbsp; مثل مسافة عادية؟

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

هل أسماء كيانات HTML حساسة لحالة الأحرف؟

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

هل أحتاج إلى كيانات لكل حرف ذي علامة نطقية؟

لا. يمكن لمستند HTML يستخدم UTF-8 المعلن عنه بصورة صحيحة أن يحتوي مباشرة على محارف مثل é و£ و中文. وتظل الكيانات مفيدة عندما تتطلبها صياغة الترميز أو الأنظمة القديمة أو قاعدة نشر محددة.

هل يمكن استخدام كيانات HTML داخل XML؟

لا يعرّف XML مسبقا سوى مجموعة صغيرة من الكيانات المسماة، منها &amp; و&lt; و&gt; و&quot; و&apos;. كثير من الأسماء الصالحة في HTML غير صالح في XML ما لم يحددها نوع المستند، لذلك تكون مراجع المحارف الرقمية غالبا الخيار الأكثر أمانا.

هل يستطيع محول الكيانات إصلاح HTML التالف؟

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

مراجعات أخيرة

تأكد مما إذا كان المصدر يستخدم مراجع محارف HTML مسماة أو رقمية، وحوّل طبقة مراجع المحارف المطلوبة فقط، ثم قارن النتيجة بالنص المراد عرضه. وقبل وضع المحتوى المفكوك في صفحة منشورة، راجع أي أقواس زاوية أو علامات اقتباس أو علامات عطف ناتجة ضمن سياق HTML الفعلي الذي ستظهر فيه.