إضافة كيانات أحرف لـ XSLT في Dreamweaver

تاريخ آخر تحديث 20‏/12‏/2021

اقرأ هذه المقالة لمعرفة كيفية تحديد كيانات الأحرف المقصودة لاستبدال الأحرف الخاصة لـ XSLT في Dreamweaver.

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

حدد كيان أحرف مفقودة

في XSLT، بعض الأحرف غير مسموحة في سياقات معينة. على سبيل المثال، لا يمكنك استخدام علامة أقل من (<) وعلامة العطف (&) في النص بين العلامات أو في قيمة السمة.سيعطيك محرك تحويل XSLT خطأ إذا تم استخدام هذه الأحرف بشكل غير صحيح. لحل المشكلة، يمكنك تحديد كيانات الأحرف لاستبدال الأحرف الخاصة.

كيان الحرف هو سلسلة من الأحرف تمثل أحرفاً أخرى. كيانات الأحرف إما مسماة أو مرقمة. يبدأ الكيان المسمى بعلامة العطف (&) متبوعة بالاسم أو الأحرف، وينتهي بفاصلة منقوطة (;). على سبيل المثال، < يمثل حرف القوس الزاوي الأيسر (<). الكيانات المرقمة تبدأ وتنتهي بنفس الطريقة، باستثناء أن علامة التجزئة (#) ورقماً يحددان الحرف.

يحتوي XSLT على الكيانات المحددة مسبقاً الخمسة التالية:

الحرف

المعلمة البرمجية للكيان

< (أقل من)

<

& (علامة العطف)

&

> (أكبر من)

>

" (علامة تنصيص)

&quot;

‘ (فاصلة عليا)

&apos;

إذا كنت تستخدم كيانات أحرف أخرى في ملف XSL، تحتاج إلى تعريفها في قسم DTD من ملف XSL. يوفر Dreamweaver عدة تعريفات كيانات افتراضية يمكنك رؤيتها في أعلى ملف XSL المنشأ في Dreamweaver. تغطي هذه الكيانات الافتراضية مجموعة واسعة من الأحرف الأكثر استخداماً.

عند معاينة ملف XSL في متصفح، يفحص Dreamweaver ملف XSL للبحث عن كيانات غير معرفة ويخطرك إذا تم العثور على كيان غير معرف.

إذا كنت تعاين ملف XML مرفق بملف XSLT أو إذا كنت تعاين صفحة من جانب الخادم مع تحويل XSLT، يخطرك الخادم أو المتصفح (بدلاً من Dreamweaver) بوجود كيان غير معرف. ما يلي مثال عن رسالة قد تحصل عليها في Internet Explorer عند طلب ملف XML محول بواسطة ملف XSL مع تعريف كيان مفقود:Reference to undefined entity 'auml'. حدث خطأ أثناء معالجة المورد 'http://localhost/testthis/list.xsl'. Line 28, Position 20 <p class=''test''>&auml;</p> -------------------^

لتصحيح الخطأ في صفحتك، يجب إضافة تعريف الكيان إلى صفحتك يدوياً.

Reference to undefined entity 'auml'. حدث خطأ أثناء معالجة المورد 'http://localhost/testthis/list.xsl'. Line 28, Position 20

<p class=''test''>&auml;</p>

-------------------^

حدد تعريف كيان مفقود

ابحث عن الحرف المفقود في صفحة مرجع كيان الحرف على موقع W3C في www.w3.org/TR/REC-html40/sgml/entities.html.

تحتوي صفحة الويب هذه على 252 كياناً مسموحاً في HTML 4 وXHTML 1.0.

على سبيل المثال، إذا كان كيان الحرف Egrave مفقوداً، ابحث عن "Egrave" في صفحة الويب W3C. ستجد الإدخال التالي:

<!ENTITY Egrave CDATA "&#200;" -- latin capital letter E with grave, U+00C8 ISOlat1 -->

سجل اسم الكيان ورمز الكيان في الإدخال.

في المثال، Egrave هو اسم الكيان، و&#200 هو رمز الكيان.

باستخدام هذه المعلومات، انتقل إلى عرض الرمز وأدخل علامة الكيان التالية في أعلى ملف XSL (بعد إعلان Doctype ومع علامات الكيان الأخرى):

<!ENTITY entityname "entitycode;">

في المثال، ستدخل علامة الكيان التالية:<!ENTITY Egrave "&#200;">

<!ENTITY Egrave "&#200;">

احفظ ملفك.

إذا كنت تستخدم نفس كيانات الأحرف بشكل متكرر، فقد تريد إضافة تعريفاتها بشكل دائم في ملفات XSL التي ينشئها Dreamweaver افتراضياً عند استخدام ملف > جديد.

أضف تعريفات الكيان إلى ملفات XSL التي ينشئها Dreamweaver افتراضياً

حدد موقع ملف التكوين التالي في مجلد تطبيق Dreamweaver وافتحه في أي محرر نصوص:

Configuration/DocumentTypes/MMDocumentTypeDeclarations.xml

حدد موقع الإقرار الذي يسمى mm_xslt_1:

<documenttypedeclaration id="mm_xslt_1">

أدخل علامة الكيان الجديدة أو العلامات في قائمة علامات الكيان، كما يلي:

<!ENTITY entityname "entitycode;">

احفظ الملف وقم بإعادة تشغيل Dreamweaver.