Extension:AltTag/ar

وظيفة AltTag هي أن يجعل وسوم بديلة (يختارها المستخدم) تعمل بنفس طريقة الوسوم الأصلية، الوسوم المقصودة هنا هي التي بصيغة XML ، فمثلا يمكنك أن تجعل <مرجع اسم="test" > تعمل بالضبط كـ هذا الكود مكتوب بشكل صحيح 100% ولكن اختلاط RTL مع LTR بعثر النص.

باستخدام هذه الإضافة يمكنك كتابة النص هكذا : <مرجع اسم=الاسم فئة=الفئة> هنا محتوى  كبير  محتوى شيفرة  كبير   هل رأيت الفرق؟!، هذه هي الفائدة، وفوائد أخرى أيضا !!.

خصائص

 * يمكنه معالجة جميع الوسوم (tag) وسماتها (attribute) أيضا. كما أنه يدعم الوسوم التي محتوياتها لا تتغير مثل nowiki و pre.
 * عملية معالجة الوسوم وسماتها تكون قبل عمل أي معالجة من mediawiki هذا يقلل من الأخطاء، والأخطار بنبسة كبيرة.
 * يمكنه معالجة وسم بديل مع سمة أصلية، أو سمة أصلية في وسم بديل، أو وسوم وسمات مختلطة.
 * يمكن إضافة أكثر من بديل لوسم واحد.

الأستخدام
بعد تركيب الإضافة يمكنك استخدام الوسم البديل مع سمات بديلة كما تستخدم الوسوم الأصلية تماماً.

ملاحظات

 * AltTag ليس فقط للغات RTL ولكن لجميع اللغات.
 * يمكن للوسم البديل أن يغلق الوسم الأصلي، والعكس صحيح. عدا وسوم nowikis فإن الوسم الذي يفتحه لا بد أن يكون نفسه الذي يغلقه.
 * AltTag لا يضيف وسوم جديدة، ولكنه يسمح لك باستخدام الوسوم الموجودة بأسماء مختلفة.

تعليمات التحميل
يرجى نسخ و لصق الكود الموجود في الأسفل وضعه في  ملاحظة: $IP هو الجذر الأساسي لميدياويكي، نفس المجلد الذي يحوي LocalSettings.php.

التركيب
لتركيب هذه الإضافة، أضف هذه الأسطر إلى LocalSettings.php:

تحديد الخيارات
لاستخدام AltTag لابد أن تعين بعض الخيارات، ويمكن تعيينها من خلال ملف AltTag.php، تجدها تحت السطر.

ملاحظة : الأمثلة المستخدمة هي للغة العربية.

 الخيارات هي: 

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

وسوم Nowiki
وهي أي وسم يراد من الوسم البديلة داخلها عدم المعالجة مثل nowiki ، pre أو أي وسم يريده المستخدم.

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

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

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

تجده تحت السطر :. مثال : تحذير : يجب عدم وضع أي شيء عدا الأحرف، لا نقاط، لا مسافات، لا علامات، أو أي شيء آخر.

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

للمطورين
تعمل الإضافة حسب الخطوات التالية :
 * 1) جلب جميع الوسوم في المصفوفة ، تحديدا.
 * 2) معالجة الوسوم في المصفوقة-حتى الآن لم يتأثر النص الأصلي- بالطريقة التالية:
 * 1) فحص إذا كان أحد الوسوم Nowiki إذا كان واحدا منها، فإنه يجعل قيمة المتغير  صحيح.
 * 2) إذا كان قيمة المتغير  صحيح، لا يعالج النص.وإنما يضيفه على شكله إلى مصفوفة الوسوم المعالجة  ، وتستمر العملية هكذا حتى وسم إغلاق Nowiki وحينها تكون قيمة   خاطئ


 * تتم معالجة الوسم من خلال فصل اسم الوسم ومعالجة في الدالة والجزء الباقي  ومعالجته في  . ووضع النتيجة في المصفوفة.
 * 3) عملية الاستبدال، وهنا تستبدل جميع الوسوم في النص ببديل عشوائي غير موجود في النص.
 * 4) عملية الإرجاع، تكون عن طريق استبدال البديل  بوسم من  ، مرة في كل مرة. لكي ترجع الوسوم لأماكنها الصحيحة بالترتيب.
 * لماذا عملية تبديل الوسوم ببديل مؤقتا أصلا؟ لأنه بلا هذه العملية فإن عملية استبدال الوسم غير المعالج بالوسم غير المعالج لن تتخطى الوسم الأول؛ لأنه تنطبق عليه (التعبير النمطي RegEx ) للوسوم. وبهذا فإنه سيأخذ أول وسم دائما.