مساعدة:قالب

اختصار: س:ق

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

هناك نوعان من القوالب: قالب عادي، وقالب بمتغيرات.

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

إنشاء القالب

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

تلميحات

إذا تضمن القالب روابط انترويكي، فإن هذه الروابط ستظهر في كل الصفحات، و هذا غير مرغوب فيه. لهذا إذا أردنا الإشارة إلى أن القالب مستعمل في لغات أخرى، فيجب استعمال <noinclude> روابط انترويكي </noinclude>. أما بالنسبة لتسمية القالب فهو يخضع للسياسة العامة لتسمية المقالات.

إذا تم وضع القالب في تصنيف، فكل المقالات التي يوجد بها القالب ستظهر في هذا التصنيف. وهذا يسمح مثلا بمعرفة جميع المقالات بذرة لموضوع معين.

استعمال

لإضافة القالب إلى الصفحة نستعمل: {{اسم القالب}}.

لكي يكون تعديل القالب ظاهرا في كل الصفحات نستعمل: {{subst:اسم القالب}}

من الممكن إدماج نص من كلمات سحرية:{{ويكي الاقتباس:أحدث التغييرات}}.

كل الحروف و الرموز مقبولة بما فيها الفراغات.

كل تغيير للقالب يمسح الكاش آليًا لكل الصفحات المرتبطة بالقالب.

قد يتضمن القالب متغيرات تتغير حسب المقالة: {{شيء|متغير=قيمة}}، مع {{{متغير}}} في القالب، أو {{brol|قيمة1|قيمة2}} مع {{{1}}}،{{{2}}} . لاحظ أنه يتم استعمال 3 لامات } و ليس اثنان.

يمكن لقالب أن يتضمن قوالب أخرى.

المتغيرات

المتغيرات هي ما كل ما يوجد بعد اسم القالب وهي نوعان:

الوسيط، أو الوسيط الشكلي، هو مدخل له اسم معين في القالب.
المعطى، أو الوسيط الفعلي، هو أي نص يكتب بعد الوسيط الشكلي.

في المثال {{اسم قالب|نص = كلمة}}: اسم الوسيط الشكلي هو نص، واسم الوسيط الفعلي هو كلمة.

تغيير المتغيرات

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

مثال

افترض قالبا بسيطا اسمه {{قالب كذا}} ويحتوي على النص التالي: '''{{{نص}}}'''. عند كتابة {{قالب كذا|نص = كلمة}} نحصل على كلمة. وعند كتابة {{قالب كذا|نص = كلمة أخرى}} نحصل على كلمة أخرى.

إذا أردنا استخدام الصيغة {{قالب كذا|نص غليظ = كلمة}} بدل {{قالب كذا|نص = كلمة}} والحصول على نفس النتيجة (كلمة)، يجب 'إحاطة' الوسيط القديم (نص) بالوسيط الجديد (نص غليظ)، أي تعويض عبارة '''{{{نص}}}''' بعبارة {{{نص غليظ|'''{{{نص}}}'''}}} في نص القالب. وهكذا سواء كتبنا {{قالب كذا|نص غليظ = كلمة}} أو {{قالب كذا|نص غليظ = كلمة}} نحصل على نفس النتيجة (كلمة).

قالب بمتغيرات

يمكن لقالب أن يضم متغيرات تتغير قيمها حسب الصفحة التي يوجد بها القالب. الشيء الذي يمكن مثلا من استعمال جدول يضم معلومات تتغير حسب المقال، انظر مثلا: قالب:Demography 4col


{|  border="0" width={{{1}}} cellspacing="2" cellpadding="2" 
|  colspan="4" bgcolor="#eeeeee" align="center" | <strong> تطور النمو [[ديموغرافيا|الديموغرافي]] <span style="color:#0000D0;">{{FULLPAGENAME}}</span> بين {{{2}}} و {{{5}}}</strong>
|-  bgcolor="#eeeeee"
| align="center" |<strong>{{{2}}}</strong>
| align="center" |<strong>{{{3}}}</strong>
| align="center" |<strong>{{{4}}}</strong>
| align="center" |<strong>{{{5}}}</strong>

|- bgcolor="#eeeeee"
| align="center" |{{{6}}}
| align="center" |{{{7}}}
| align="center" |{{{8}}}
| align="center" |{{{9}}}
|-
|
|}

فالقالب يضم متغيرات (بين 3 لامات)تتغير قيمها حسب كل مقال، و في المقال بلد الوليد تظهر قيم المتغيرات.

{{Demography 4col|530px|[[1991]]|[[1996]]|[[2001]]|[[2004]] |'''330.700'''|'''319.805'''|'''316.580'''|'''321.713'''}}

حيث القيم بخط غليظ قد تغيرت حسب المقال.

قيم افتراضية لمتغير

يمكن للمتغير أن يأخذ قيمة افتراضية، أي قيمة تستعمل آليًا عند غياب قيمة للمتغير في المقال الذي يضم القالب: {{{3|123}}}، فإذا لم تتم الإشارة إلى قيمة المتغير {{{3}}} فالقيمة ستكون في هذه الحالة هو 123.

قوالب خاصة

هذه القوالب محجوزة، لا يمكن استعمالها لتسمية القوالب.

`{{NAMESPACE}}`	اسم المتغير حيث توجد الصفحة	"مساعدة"
`{{PAGENAME}}`	اسم الصفحة بدون سابق للمتغير	"قالب"
`{{PAGENAMEE}}`	اسم الصفحة بدون سابق للمتغير في الصيغة المستعملة للعنوان	"%D9%82%D8%A7%D9%84%D8%A8"
`{{FULLPAGENAME}}`	اسم الصفحة بسابق للمتغير	"مساعدة:قالب"
`{{FULLPAGENAMEE}}`	اسم الصفحة بسابق للمتغير في الصيغة المستعملة للعنوان	"%D9%85%D8%B3%D8%A7%D8%B9%D8%AF%D8%A9:%D9%82%D8%A7%D9%84%D8%A8"
`{{SITENAME}}`	اسم الموقع	"ويكي الاقتباس"
`{{SERVER}}`	عنوان الموقع	"//ar.wikiquote.org"
`{{localurl:اسم الصفحة}}`	العنوان المرتبط بالصفحة	"/wiki/Nom_d%27une_page"
`{{localurl:اسم الصفحة\|متغيرات}}`	نفس الشيء لكن بمتغيرات	"/w/index.php?title=Nom_d%27une_page&paramètres"
`{{CURRENTMONTH}}`	الشهر	"11"
`{{CURRENTMONTHNAME}}`	اسم الشهر	"نوفمبر"
`{{CURRENTMONTHNAMEGEN}}`	( اسم الشهر (ببعض الخصوصيات	"نوفمبر"
`{{CURRENTDAY}}`	اسم اليوم	"2"
`{{CURRENTDAYNAME}}`	يوم الأسبوع	"السبت"
`{{CURRENTYEAR}}`	السنة	"2024"
`{{CURRENTTIME}}`	الساعة الحالية	"21:21"
`{{NUMBEROFARTICLES}}`	عدد المقالات	"3٬703"
`{{ns:7}}`	اسم المتغير بعد رقمه	"نقاش الملف"

مثال لاستعمال القوالب الخاصة

{{SERVER}}{{localurl:{{TnT}}:{{PAGENAME}}\|action=edit}}	//ar.wikiquote.org/w/index.php?title=%D9%85%D8%B3%D8%A7%D8%B9%D8%AF%D8%A9:%D9%82%D8%A7%D9%84%D8%A8&action=edit
{{SERVER}}{{localurl:Special:Whatlinkshere\|target={{NAMESPACE}}:{{PAGENAME}}}}	//ar.wikiquote.org/w/index.php?title=%D8%AE%D8%A7%D8%B5:Whatlinkshere&target=مساعدة:قالب
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}}	//ar.wikiquote.org/wiki/%D9%85%D8%B3%D8%A7%D8%B9%D8%AF%D8%A9:%D9%82%D8%A7%D9%84%D8%A8_1
''انظر : [[{{NAMESPACE}}:{{PAGENAME}}_1\|{{NAMESPACE}} {{PAGENAME}} 1]].''	انظر : مساعدة قالب 1.
[[{{NAMESPACE}}:{{PAGENAME}}_1]]	مساعدة:قالب 1
[[{{FULLPAGENAME}}_1]]	مساعدة:قالب 1

وسوم الإدماج

في بعض الحالات يكون من المهم إضافة عناصر إلى القن المصدري للقالب، دون أن تظهر هذه الإضافات في الصفحات التي يوجد بها القالب. للقيام بذلك، يتم وضع الإضافات بين الوسوم <noinclude> و </noinclude>.

عكسيا، العناصر التي نريدها أن تظهر عند الإدماج، لكن تختفي عند عرض القالب لوحده، توضع بين <includeonly> و </includeonly>.

وضع عنوان بين includeonly قد يؤدي إلى تشويه الفهرس و كذا الرابط عدل هذه الصفحة.

لهذا ينصح بترك فراغ بين آخر رمز = لعنوان و الوسم <includeonly>.

ينصح أيضا، عند وضع <noinclude>...</noinclude>، بترك فراغ سابق، و إضافة تعليق مخفي.

قالب مستخدم

لإنشاء قالب غير موسوعي، ولكن لاستعماله مثلًا في صفحة المستخدم، من المكن القيام بتجارب; لهذا يمكن أن نستعملها في صفحة تابعة للمستخدم فمثلا إذا أراد مستخدم:فلان تجريب قالب:كذا ما فما عليه إلا أن ينشئ صفحة جديدة بعنوان قالب:كذا/ملعب أو مستخدم:فلان/ملعب و في هذه الصفحة يقوم بتجريب القالب، بعد ذلك يمكن تجريب القالب في صفحاته الشخصية. ليرى النتيجة، دون التأثير على الملف الخاص بالقوالب.

مشاكل في الصفحات التي تضم القالب

تحديث: لتحديث صفحة تضم قالب تم تغييره لكن التعديلات الجديدة لا تظهر، استخدم زر [حدث] الموجود في توثيق القالب.