Expat، الإصدار 2.2.6

هذه هي مكتبة Expat، وهي مكتبة بلغة C لتحليل XML، بدأها جيمس كلارك في عام 1997. Expat هو محلل XML موجه بالتدفق. هذا يعني أنك تسجل معالجات مع المحلل قبل بدء التحليل. يتم استدعاء هذه المعالجات عندما يكتشف المحلل الهياكل المرتبطة في المستند الذي يتم تحليله. علامة البداية هي مثال على نوع الهياكل التي يمكنك تسجيل معالجات لها.

يجب على مستخدمي ويندوز استخدام حزمة expat_win32، التي تتضمن كلا من المكتبات المجمعة مسبقاً والملفات التنفيذية، ورموز المصدر للمطورين.

Expat هو برنامج حر. يمكنك نسخه وتوزيعه وتعديله بموجب شروط الترخيص الواردة في ملف COPYING الموزع مع هذه الحزمة. هذا الترخيص هو نفسه رخصة MIT/X Consortium.

إذا كنت تقوم ببناء Expat من سحب من مستودع Git، فأنت بحاجة إلى تشغيل سكريبت ينتج سكريبت configure باستخدام أدوات GNU autoconf و libtool. للقيام بذلك، تحتاج إلى autoconf 2.58 أو أحدث. قم بتشغيل السكريبت كما يلي:

./buildconf.sh

بمجرد الانتهاء من ذلك، اتبع نفس التعليمات المتبعة للبناء من توزيعة المصدر.

لبناء Expat من توزيعة مصدر، قم أولاً بتشغيل سكريبت shell التهيئة في دليل التوزيعة العلوي:

./configure

هناك العديد من الخيارات التي يمكنك تقديمها لـ configure (والتي يمكنك اكتشافها عن طريق تشغيل configure مع الخيار --help). لكن الخيار الأكثر أهمية هو الذي يحدد دليل التثبيت. افتراضياً، سيقوم سكريبت configure بإعداد الأشياء لتثبيت libexpat في /usr/local/lib، و expat.h في /usr/local/include، و xmlwf في /usr/local/bin. إذا، على سبيل المثال، تفضل التثبيت في /home/me/mystuff/lib، و /home/me/mystuff/include، و /home/me/mystuff/bin، يمكنك إبلاغ configure بذلك عن طريق:

./configure --prefix=/home/me/mystuff

خيار آخر مثير للاهتمام هو تمكين دعم الأعداد الصحيحة 64 بت لأرقام الأسطر والأعمدة ومؤشر البايت الكلي:

./configure CPPFLAGS=-DXML_LARGE_SIZE

ومع ذلك، فإن مثل هذا التعديل سيكون تغييراً مكسّراً لـ ABI وبالتالي لا يُنصح به للاستخدام العام — على سبيل المثال كجزء من توزيعة لينكس — بل للبنى ذات المتطلبات الخاصة.

بعد تشغيل سكريبت configure، سيقوم أمر make ببناء الأشياء وسيقوم make install بتثبيت الأشياء في موقعها المناسب. ألقِ نظرة على Makefile للتعرف على خيارات إضافية لـ make. لاحظ أنك تحتاج إلى إذن كتابة في الدلائل التي سيتم تثبيت الأشياء فيها.

إذا كنت مهتماً ببناء Expat لتوفير معلومات المستند بترميز UTF-16 بدلاً من UTF-8 الافتراضي، اتبع هذه التعليمات (بعد تشغيل make distclean). يرجى ملاحظة أننا نستخدم configure مع --without-xmlwf لأن xmlwf لا يدعم هذا الوضع من التجميع (حتى الآن):

1. قم بتصحيح جماعي لملفات Makefile.am لاستخدام libexpatw.la كاسم للمكتبة:
   find -name Makefile.am -exec sed -e 's,libexpat\.la,libexpatw.la,' -e 's,libexpat_la,libexpatw_la,' -i {} +

2. قم بتشغيل automake لإعادة كتابة ملفات Makefile.in:
   automake

3. للإخراج بـ UTF-16 على هيئة unsigned short (وسلاسل الإصدار/الخطأ على هيئة char)، قم بتشغيل:
   ./configure CPPFLAGS=-DXML_UNICODE --without-xmlwf
   للإخراج بـ UTF-16 على هيئة wchar_t (بما في ذلك سلاسل الإصدار/الخطأ)، قم بتشغيل:
   ./configure CFLAGS="-g -O2 -fshort-wchar" CPPFLAGS=-DXML_UNICODE_WCHAR_T --without-xmlwf
   ملاحظة: الأخير يتطلب libc مجمعة مع -fshort-wchar أيضاً.

4. قم بتشغيل make (والذي يستثني xmlwf).

استخدام DESTDIR مدعوم. يعمل كما يلي:

make install DESTDIR=/path/to/image

يتجاوز DESTDIR المحدد داخل Makefile، لأن أولوية تعيين المتغير هي

1. سطر الأوامر
2. داخل Makefile
3. البيئة

ملاحظة: ينطبق هذا فقط على مكتبة Expat نفسها، بناء إصدارات UTF-16 من xmlwf والاختبارات غير مدعوم حالياً.

عند استخدام Expat مع مشروع يستخدم autoconf للتهيئة، يمكنك استخدام الماكرو الاستكشافي في conftools/expat.m4 لتحديد كيفية تضمين Expat. راجع التعليقات في أعلى ذلك الملف لمزيد من المعلومات.

دليل مرجعي متاح في الملف doc/reference.html في هذه التوزيعة.