كيفية التعليق على سطر في XML

يوفر XML لغة ترميز لتخزين البيانات ونقلها من موقع إلى آخر. مثل HTML ، يستخدم نصًا عاديًا يمكنك تحريره في أي تطبيق يكتب ملفات TXT. على عكس HTML ، توفر علامات XML تفاصيل وصفية حول المحتوى بدلاً من الإرشادات المرئية لعرضه. أثناء قيامك بتعريف علامات XML لتمييز مجموعة من المعلومات ، يمكنك استخدام التعليقات لخدمة اثنين أغراض ضمن عملك: شرحه ، وحذف أجزاء منه من الكود الذي تستخدمه التطبيقات الأخرى معالجة. إذا كنت تعرف بالفعل بناء جملة تعليق HTML ، فأنت تعرف أيضًا مكافئ XML.

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

إذا كان سطرك يتكون من العبارة "استخدم هذا القسم لإنشاء وصف للقطط التي يمكن تبنيها" ، فسيبدو الأمر هكذا مع كلتا علامتي التعليق في المكان:

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

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

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

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

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

كل مرجع كيان يبدأ بعلامة العطف وينتهي بفاصلة منقوطة. بين هذين الحرفين ، يحتوي مرجع الكيان للرمز أقل من على الأحرف الصغيرة "lt" ، بدون علامات التنصيص وعلامات الترقيم. لا يشكل الرمز أكبر من حرفًا غير قانوني في XML ، ولكن من الممارسات الجيدة استخدام مرجع الكيان أيضًا ، والذي يتضمن الأحرف "gt".

اعلم أيضًا أنه إذا فشلت في فتح وإغلاق تعليقاتك بشكل صحيح ، أو وضعها حول قسم من التعليمات البرمجية يحتوي على معرّف ، فلن يتم تحليل XML الخاص بك بشكل صحيح.