عرض مصدر قالب:صندوق رسالة تصنيف/شرح

{{صفحة توثيق فرعية}}
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[أرابيكا:ويكي بيانات]]). -->
{{استخدام واسع}}
{{Lua|Module:Message box}}
{{قوالب صندوق رسالة}}

هذا قالبٌ ورائيٌّ يُستخدم في القوالب الأخرى المُستخدمة في نطاق '''تصنيف'''.

يُستخدم القالب لبناء قوالب صناديق الرسائل مثل {{قا|تصنيف فارغ}} لصفحات التصنيفات. يُوفر أيضًا ألوانًا متعدّدة، ويستخدم صورًا افتراضيّة إذا لم يُعطى وسيط للصورة، وبه بعض الميزات الأخرى.

يعمل هذا القالب بشكلٍ مُشابهٍ لقالب {{قا|صندوق رسالة مقالة}} ويستخدم نفس الوسائط.

=== الاستخدام ===
مثال للاستخدام البسيط:
<pre>
{{صندوق رسالة تصنيف| النص = بعض النصوص هنا.}}
</pre>

{{صندوق رسالة تصنيف| النص = بعض النصوص هنا.}}

الاستخدام المُعقد:
<pre>
{{صندوق رسالة تصنيف
| النوع = أسلوب
| الصورة = [[File:Emblem-question-yellow.svg|40px]]
| الطراز = width: 400px;
| طراز النص = color: red; font-weight: bold; font-style: italic;
| النص = نص الرسالة.
}}
</pre>

{{صندوق رسالة تصنيف
| النوع = أسلوب
| الصورة = [[ملف:Emblem-question-yellow.svg|40px]]
| الطراز = width: 400px;
| طراز النص = color: red; font-weight: bold; font-style: italic;
| النص = نص الرسالة.
}}

=== أنواع صناديق رسائل التصنيف ===
الأمثلة التالية تستخدم قيمًا مختلفة لوسيط {{وسيط|النوع}} لكن لا تسخدم وسائط للصور، لذلك تُعرض الصور الافتراضية لكل نوع.

{{صندوق رسالة تصنيف
| النوع = شطب
| النص = النوع=<u>شطب</u> – لقوالب الحذف السريع مثل {{قا|شطب}}.
}}

{{صندوق رسالة تصنيف
| النوع = حذف
| النص = النوع=<u>حذف</u> – لقوالب الحذف مثل {{قا|حذف}}.
}}

{{صندوق رسالة تصنيف
| النوع = محتوى 
| النص = النوع=<u>محتوى</u> – للمشاكل والتنبيهات الكبيرة مثل {{قا|تصنيف فارغ}}.
}}

{{صندوق رسالة تصنيف
| النوع = أسلوب
| النص = النوع=<u>أسلوب</u> – للمشاكل والتنبيهات البسيطة مثل {{قا|تصنيف مكتظ}}.
}}

{{صندوق رسالة تصنيف
| النوع = ملاحظة
| النص = النوع=<u>ملاحظة</u> – الرسائل والملاحظات من أي نوع، الدائمة أو المؤقتة.
}}

{{صندوق رسالة تصنيف
| النوع = نقل
| النص = النوع=<u>نقل</u> – لرسائل أو اقتراحات النقل أو الدمج أو الفصل مثل {{قا|تحويل تصنيف}}.
}}

{{صندوق رسالة تصنيف
| النوع = حماية
| النص = النوع=<u>حماية</u> – لقوالب الحماية مثل {{قا|حم}} حينما تُعرض في صفحة تصنيف.
}}

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

{{صندوق رسالة تصنيف
| النوع = أسلوب
| الصورة = [[ملف:Sub-arrows.svg|40px]]
| النص = النوع = أسلوب<br />الصورة = <nowiki>[[ملف:Sub-arrows.svg|40px]]</nowiki><br />هذه الصورة مستخدمة في {{قا|تصنيف مكتظ}} و {{قا|تصنيف رئيسي}}.
}}

{{صندوق رسالة تصنيف
| النوع = نقل
| الصورة = [[ملف:Redirect arrow rtl without text.svg|52px]]
| النص = النوع = نقل<br />الصورة = <nowiki>[[ملف:Redirect arrow rtl without text.svg|52px]]</nowiki><br />هذه الصورة مستخدمة في {{قا|تحويل تصنيف}}.
}}

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

{{صندوق رسالة تصنيف
| الصورة = بدون
| النص = لا نوع و '''الصورة=بدون''' – لم تُستخدم صورة و'''النص''' يستخدم كامل مساحة صندوق الرسالة.
}}

{{صندوق رسالة تصنيف
| الصورة = [[ملف:Gnome globe current event.svg|42px]]
| صورة يسار = [[ملف:Nuvola apps bookcase.svg|40px]]
| النص = الصورة = <nowiki>[[ملف:Gnome globe current event.svg|42px]]</nowiki><br />صورة يسار = <nowiki>[[ملف:Nuvola apps bookcase.svg|40px]]</nowiki>
}}

{{صندوق رسالة تصنيف
| الصورة = [[ملف:Gnome globe current event.svg|42px]]
| صورة يسار = [[ملف:Sports current event.svg|30px]]
| النص = '''هذا التصنيف يضم مقالاتٍ عن أحداثٍ رياضيّةٍ جاريةٍ.'''<br />تُجمع المقالات في هذا التصنيف باستخدام قالب {{قا|حدث رياضي جار}}.
}}

=== الوسائط ===
قائمة بجميع الوسائط:
<pre>
{{صندوق رسالة تصنيف
| الاسم = اسم القالب
| النوع = شطب / حذف / محتوى / أسلوب / ملاحظة / نقل / حماية
| الصورة = بدون / [[ملف:Some image.svg|40px]]
| صورة يسار = [[ملف:Some image.svg|40px]]
| الصنف = صنف CSS مخصص لتطبيقه على القالب
| الطراز = قيم CSS
| طراز النص = قيم CSS
| وصلات عادية = لا
| النص = نص صندوق الرسالة.
}}
</pre>

'''الاسم'''
:(اختياري) اسم القالب. هذا يُضيف صنف CSS مع اسم مُخصص هو <code>box-''الاسم''</code> إلى عنصر HTML، لأجل أن تستخدمه البوتات أو السكربتات.

'''النوع'''
:إذا لم تُعطى قيمة لوسيط '''النوع'''، فإن القالب يُضبط افتراضيًّا إلى نوع '''ملاحظة'''. هذا يعني حصوله على خلفية زرقاء كما هو موضح أعلاه.

'''الصورة'''
:''<span style="color:gray">[لا وسيط]</span>'' = إذا لم تُعطى قيمة لوسيط '''الصورة'''، فإن القالب يستخدم صورةً افتراضيّةً بناءً على ما حُدّد في وسيط '''النوع'''.
:''<span style="color:gray">[صورة]</span>'' = ينبغي أن تكون صورةً بصيغة [[نص ويكي]] كاملة. 20px - 40px حجم مناسب غالبًا اعتمادًا على نسبة الطول-إلى-العرض (لكن يُمكن للصندوق التعامل مع الصور بأي حجم).
::كمثال: <code><nowiki>الصورة = [[ملف:Sub-arrows.svg|20px]]</nowiki></code>
:''<span style="color:gray">[بدون]</span>'' = يعني عدم استخدام أي صورة.

'''صورة يسار'''
:''<span style="color:gray">[لا وسيط]</span>'' = إذا لم تُعطى قيمة لوسيط صورة يسار، فلن تُعرض صورة في الجانب الأيسر من الصندوق.
:''<span style="color:gray">[صورة]</span>'' = ينبغي أن تكون صورةً بصيغة [[نص ويكي]] كاملة. 20px - 40px حجم مناسب غالبًا اعتمادًا على نسبة الطول-إلى-العرض (لكن يُمكن للصندوق التعامل مع الصور بأي حجم).
::كمثال: <code><nowiki>صورة يسار = [[ملف:Nuvola apps bookcase.png|40px]]</nowiki></code>
:''<span style="color:gray">[أي شيء]</span>'' = أي عُنصر آخر تود أن يظهر في الجانب الأيسر.

'''الطراز'''
:قيمة CSS اختياريّة يستخدمها كامل جدول صندوق الرسالة. بدون علامات التنصيص <code>" "</code>.
::كمثال: <code>الطراز = margin-bottom: 0.5em;</code>

'''طراز النص'''
قيمة CSS اختياريّة تستخدمها خلية النص. بدون علامات التنصيص <code>" "</code> أيضًا.
::كمثال: <code>طراز النص = text-align: center;</code>

'''وصلات عادية'''
:افتراضيًّا في أرابيكا، تظهر الوصلات الخارجية وبجانبها أيقونة سهم، كهذه: [http://www.example.com Example.com]. مع ذلك، فإن أيقونة السهم مُزالة افتراضيًّا في صناديق الرسائل، كهذه: <span class="plainlinks">[http://www.example.com Example.com]</span>. لعرض الوصلات الخارجية بتنسيقها العادي مع أيقونة سهم، استخدم {{وسيط|وصلات عادية|لا}}.

'''النص'''
:نص جسم الرسالة.

<!-- 
=== Technical details ===
If you need to use special characters in the text parameter then you need to escape them like this:
<syntaxhighlight lang="tid">
{{صندوق رسالة تصنيف
| text = <div>
Equal sign = and a start and end brace { } work fine as they are. 
But here is a pipe {{!}} and two end braces <nowiki>}}</nowiki>. 
And now a pipe and end braces <nowiki>|}}</nowiki>.
</div>
}}
</syntaxhighlight>

{{صندوق رسالة تصنيف
| text = <div>
Equal sign = and a start and end brace { } work fine as they are. 
But here is a pipe {{!}} and two end braces <nowiki>}}</nowiki>. 
And now a pipe and end braces <nowiki>|}}</nowiki>.
</div>
}}

This template uses the cmbox CSS classes in [[MediaWiki:Common.css]] for most of its looks, thus it is fully skinnable.

Internally this meta-template uses HTML markup instead of wiki markup for the table code. That is the usual way we make meta-templates since wiki markup has several drawbacks. For instance it makes it harder to use [[mw:Help:Extension:ParserFunctions|parser functions]] and special characters in parameters. 

The default images for this meta-template are in PNG format instead of SVG format. The main reason is that some older web browsers have trouble with the transparent background that MediaWiki renders for SVG images. The PNG images here have hand-optimised transparent background colour so they look good in all browsers. Note that SVG icons only look somewhat bad in the old browsers, thus such hand optimisation is only worth the trouble for very widely used icons.

For more technical details see the {{وإو|talk page|Template talk:Cmbox}}. Since this template works almost exactly like the other mboxes, their talk pages and related pages might also contain more details (see the [[#See also|See also]] section below).
 -->

=== انظر أيضًا ===
{{انظر أيضا قوالب صناديق الرسائل}}

<includeonly>{{ملعب آخر||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[تصنيف:قوالب صناديق الرسائل]]
[[تصنيف:قوالب نطاق التصنيف]]

}}</includeonly>