Wp/afb/مساعدة: دليل سريع للقوالب

```plaintext Template:Wp/afb/Pp-semi-indef Template:Wp/afb/Pp-move-indef Template:Wp/afb/Wikipedia how to Template:Wp/afb/Wiki markup ها دليل سريع لنماذج الويكي. للمزيد من التفاصيل شوف Template, Wikipedia:Templates و m:Help:Advanced templates.

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

صفحات القوالب تلقاها في مجال أسماء القوالب. يعني أي صفحة يبدأ عنوانها بكلمة "Template:"، مثل "foo"، تنفع للغرض هذا. ومحتوى نموذج بعنوان Template:foo يقدر يضاف إلى صفحة ويكي عن طريق تعديل الصفحة وكتابة {{foo}} فيها. ولما تشوف الصفحة، {{foo}} يتغير تلقائيًا إلى محتوى صفحة "Template:foo". وإذا تغيرت الصفحة "Template:foo" بعدين، كل الصفحات اللي تحتوي على {{foo}} بتتغير تلقائيًا.

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

لما القالب يتمدد تلقائيًا ويظهر في الصفحة، نقول إنه "متضمن".

توثيق القوالب (أو المفروض يكون) في صفحاتها. فلو تبي تعرف شلون تستخدم نموذج اسمه "foo" (يمكن لأنك شفت {{foo|...}} في مصدر المقال)، روح ل"Template:foo". (عادةً التوثيق تلقاه في "Template:foo/doc"، لكنه يُضمن أيضًا في الصفحة الرئيسية "Template:foo").

إنشاء، تعديل، واستخدام القوالب

تقدر تبدأ نموذج جديد بنفس الطريقة اللي تبدأ فيها صفحة مقال. الفرق الوحيد إن العنوان لازم يبدأ ب Template:.

بمجرد ما تنشئ القالب، مثال Template:foo، تقدر تضيف {{foo}} في الصفحات اللي تبي تستخدمه فيها. كل صفحة تستخدم القالب هذا بتستخدم نفس النص الجاهز كل مرة يزورها مستخدم. لما يتحدث القالب، كل الصفحات اللي تحتوي على علامة القالب تتحدث تلقائيًا.

بديلًا عن ذلك، إذا ما تبي الصفحة تعكس تحديثات مستقبلية للنموذج، تقدر تضيف {{subst:foo}} في الصفحات اللي تبي تستخدم النص الجاهز فيها. النظام يسحب نسخة واحدة من نص القالب ويستبدلها في الصفحة بدل علامة القالب. إذا أحد عدل القالب بعدين، الصفحات اللي استخدمت كلمة subst: ما تتحدث. أحيانًا هذا هو المطلوب.

لو القالب اللي تبي تعدله شكله {{foo}}، تروح ل Template:foo علشان تعدله. للوصول هناك، اكتب "Template:foo" في مربع البحث (شوف البحث)، أو سو رابط ويكي مثل [[Template:foo]] في مكان مثل صندوق الرمل واضغط عليه.

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

المدخلات

القوالب تقدر يكون لها مدخلات تندمج بشكل ديناميكي في الصفحة المتضمنة. بدل بس اسم القالب، مثل {{foo}}، يكون فيه قيم إضافية مفصولة بخط العمودي (|)، مثل {{foo|July|lc=yes}}. هنا July هو قيمة أول مدخل غير مسمى؛ yes هي قيمة المدخل المسمى lc. كتابة صفحة نموذج بمدخلات أصعب من كتابة نموذج بدون مدخلات. شوف Template.

تعديل القوالب الحالية

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

Template:Wp/afb/Slink فيه نصايح لتجنب المشاكل.

نموذج رابط القالب

علشان تضيف الاسم الكامل للنموذج كـ نص (بما في ذلك الأقواس المحيطة) في مقال ويكي، استخدم نموذج رابط القالب. الدافع الأساسي لهذا هو التوثيق والتعليمات. مثال قصير هو الكود:

{{tl|foo}}

يولد

Template:Wp/afb/Tl

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

شلون أگدر أعرف شلون أستخدم نموذج موجود؟: لرؤية توثيق القالب اللي اسمه "foo"، رح ل"Template:foo".

شلون أگدر أعرف وين يتم استخدام نموذج؟: لعرض قائمة كل الصفحات اللي تم تضمين نموذج فيها، استخدم Special:WhatLinksHere واكتب template:اسم_القالب (مزيد من المعلومات).

أگدر أستخدم نموذج في أكثر من مشروع؟: لا، إذا تبي تستخدمه في ويكيتين لغتين مختلفتين، لازم تنشئه مرتين.

هل أسماء القوالب حساسة لحالة الأحرف؟: نعم، ماعدا (في معظم الويكيات)^[1] الحرف الأول عادةً.

شلون أگدر أضيف مدخلات؟: شوف Template للتعليمات.

عدلت القالب، ليش ما تغيرت الصفحة اللي يستخدم فيها؟: ويكيبيديا وجهازك يخزنان صفحات الويب كـ مخبأة – أو نسخ محفوظة – ومو دايمًا يظهر لك الصفحة محدثة. جرب أولاً تجاوز مخبأ المتصفح عن طريق الضغط على Template:Wp/afb/Key press، Template:Wp/afb/Key press، أو Template:Wp/afb/Key press. إذا ما نفع، ممكن تحتاج لتفريغ مخبأ الصفحة (ويمكن تنفيذ هذا بطرق مختلفة). أسهل طريقة لهذا هي الضغط على عدل في الصفحة اللي يظهر فيها القالب، بعدين اضغط على نشر التغييرات بدون ما تغير شيء – مافي داعي تعبي الحقل ملخص لأنه ما راح يكون فيه تاريخ لهذا كـ تغيير.

أگدر أنقل نموذج لاسم جديد؟: نعم، هذا مثل نقل الصفحات العادي. لما تكون الصفحة المطلوبة للتضمين صفحة إعادة توجيه، الهدف من إعادة التوجيه يتضمن بدلًا من ذلك.

أگدر أستخدم نموذج داخل نموذج؟: نعم.

شلون أگدر أضيف نموذج جديد؟: تبدأ نموذج جديد بنفس طريقة الصفحة العادية. الفرق الوحيد إن العنوان لازم يبدأ بـ Template:Wp/afb/Code. لا تنسى توثيقه علشان المحررين الثانين يقدرون يستخدمونه!

وين دليل اللغة المستخدمة في كتابة القوالب؟: اللغة داخل القوالب هي نفسها لغة تنسيق ويكي العادية، لكن كُتاب القوالب يميلون لاستخدام دوال معقدة مثل #if: التعليمات. شوف Template في ويكيبيديا وmw:Help:Template في ويكيميديا، بما في ذلك جميع صفحات المساعدة لـ"الوظائف المتقدمة" في الجزء السفلي من الصفحة.

أمثلة

w:en:Template:stub: رسالة تُستخدم غالبًا (في ويكيبيديا الإنجليزية).
w:en:Template:Biological classification: نموذج

يستخدم لتنسيق التصنيف البيولوجي.

w:en:Template:OED online: نموذج للمراجع المستندة إلى قاموس أوكسفورد الإنجليزي.