عرض مصدر قالب:صندوق رسالة أخرى/شرح

{{صفحة توثيق فرعية}}
{{مستخدم في النظام}}
{{Lua|Module:Message box}}
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE -->
{{قوالب صندوق رسالة}}

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

يُستخدم القالب لبناء قوالب الصفحات من نوع "مستخدم"، و"أرابيكا"، و"ميدياويكي"، و"قالب"، و"مساعدة"، و"بوابة" أو أي نطاقات أخرى مُستحدثة، وهذه النطاقات لا تُعطيها القوالب الأخرى مثل {{قا|صندوق رسالة مقالة}} أو {{قا|صندوق رسالة نقاش}} أو {{قا|صندوق رسالة ملف}} أو {{قا|صندوق رسالة تصنيف}}، لذلك إنه '''يجب عدم استخدامه''' لصناديق صفحات المقالات، والنقاشاشات، والصور والتصنيفات.

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

=== تعليمات ===
كما هو مُشار أعلاه، هذا القالب ينبغي أن يُستخدم في صناديق الرسائل ما لم تكن مقالاتٍ، أو صفحاتٍ للقناش، أو صفحات صور أو تصنيفات. بعض صناديق الرسائل في الصفحات الأخرى رُبما تستخدم -وبشكلٍ خاطئٍ- أحد الصناديق الأربعة المذكورة أعلاه. خذ راحتك في تحويل أي صناديق رسائل مُستخدمة في "الصفحات الأخرى" لتستخدم هذا القالب الورائي، وإذا واجهت مشاكل، فضلًا اطرحها في صفحة نقاش هذا القالب للحصول على مساعدة.

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

=== الاستخدام ===
مثال للاستخدام البسيط:
<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> – لقوالب الحماية مثل {{قا|حم}} حينما تُعرض في صفحة أخرى.
}}

=== أمثلة ===
بعض الأمثلة التي تستخدم تنسيقات نوع "ملاحظة".

{{صندوق رسالة أخرى
| النص = لا نوع ولا صورة مُعطاة ('''افتراضي''')
}}
{{صندوق رسالة أخرى
| الصورة = بدون
| النص = لا نوع و '''الصورة=بدون''' – لم تُستخدم صورة و'''النص''' يستخدم كامل مساحة صندوق الرسالة.
}}
{{صندوق رسالة أخرى
| الصورة = [[ملف: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>
}}

{{صندوق رسالة أخرى
| النوع = ملاحظة
| الصورة = [[ملف:Blue check.svg|30px]]
| صورة يسار = {{اختصار|أرابيكا:لحظ}}
| النص = 
'''هذه الصفحة [[أرابيكا:سياسات وإرشادات|سياسة رسمية]] في أرابيكا العربية.''' توضح هذه السياسة قواعدَ يجب على جميع المحررين اتباعها [[أرابيكا:الحس السليم|عادةً]]. تُعتمد السياسات بعد [[أرابيكا:الميدان/سياسات|النقاش]] و[[أرابيكا:تصويت/سياسات|التوافق]] حولها، وأي تعديلٍ أو إلغاءٍ لها يجري فقط عبر [[أرابيكا:آلية إقرار السياسات|آلية إقرار السياسات]].
}}
{{صندوق رسالة أخرى
| النوع = ملاحظة
| الصورة = [[ملف:Nutshell.png|30px]]
| النص = '''خلاصة الموضوع:''' هذا القالب يُستخدم لبناء صناديق رسائل لجميع الصفحات الأخرى التي '''ليست''' مقالات، أو صفحات نقاش، أو صفحات صور أو تصنيفات.
}}

=== الوسائط ===
قائمة بجميع الوسائط:

<syntaxhighlight lang="moin">
{{صندوق رسالة أخرى
| الاسم = اسم القالب
| النوع = شطب / حذف / محتوى / أسلوب / ملاحظة / نقل / حماية
| الصورة = بدون / [[ملف:Some image.svg|40px]]
| صورة يسار = [[ملف:Some image.svg|40px]]
| الطراز = قيم CSS
| طراز النص = قيم CSS
| وصلات عادية = no
| النص = نص صندوق الرسالة. 
| صغير = {{{صغير|}}} / نعم
| صورة صغيرة = بدون / [[ملف:Some image.svg|30px]]
| صورة صغير يسار = بدون / [[ملف:Some image.svg|30px]]
| نص صغير = نص قصير لصندوق الرسالة.
}}
</syntaxhighlight>

'''name'''
:(Optional) Name of the template. This adds a CSS class with name <code>box-''name''</code> to the HTML element, for use by bots or scripts.

'''type'''
:If no '''type''' parameter is given the template defaults to type '''notice'''. That means it gets a gray border.

'''image'''
:'''No parameter''' = If no '''image''' parameter is given the template uses a default image. Which default image it uses depends on the '''type''' parameter.
:'''An image''' = Should be an image with usual wiki notation. 40px - 50px width are usually about right depending on the image height to width ratio. (But the message box can handle images of any size.) For example:
::<code><nowiki>image = [[File:Crystal package settings.png|40px]]</nowiki></code>
:'''none''' = Means that no image is used.

'''imageright'''
:'''No parameter''' = If no '''imageright''' parameter is given then no image is shown on the right side.
:'''An image''' = Should be an image with usual wiki notation. 40px - 50px width are usually about right depending on the image height to width ratio. (But the message box can handle images of any size.) For example:
::<code><nowiki>imageright = [[File:Nuvola apps bookcase.png|40px]]</nowiki></code>
:'''Anything''' = Any other object that you want to show on the right side.

'''style'''
:Optional [[أوراق الأنماط المتتالية]] values used by the entire message box table. Without quotation marks <code>" "</code> but with the ending semicolons <code>;</code>. For example:
::<code>style = margin-bottom: 0.5em;</code>

'''textstyle'''
:Optional [[أوراق الأنماط المتتالية]] values used by the text cell. For example:
::<code>textstyle = text-align: center;</code>

'''plainlinks'''
:Normally on Wikipedia, external links have an arrow icon next to them, like this: [http://www.example.com Example.com]. However, in message boxes, the arrow icon is suppressed by default, like this: <span class="plainlinks">[http://www.example.com Example.com]</span>. To get the normal style of external link with the arrow icon, use {{وسيط|plainlinks|no}}.

'''text'''
:The message body text.

==== وسائط صغير ====
{{صندوق رسالة أخرى
| صغير = نعم
| النص = صغير = نعم
}}
{{صندوق رسالة أخرى
| النوع = أسلوب
| صغير = نعم
| النص = النوع = أسلوب <br /> صغير = نعم
}}
'''صغير'''
:'''نعم''' = لعرض صندوق الرسالة بشكلٍ صغيرٍ في الجانب الأيسر. هذا أيضًا يجعل الصورة الافتراضية أصغر. لاحظ أن أيّ بياناتٍ تُدخل إلى وسائط '''صورة صغيرة''' و'''صورة صغيرة يسار''' و'''نص صغير''' ستُستخدم فقط إذا استخدم "صغير=نعم". لجعل قالبك يتعامل مع وسيط صغير يُمكنك استخدام هذا الكود:
::<code><nowiki>صغير = {{{صغير|}}}</nowiki></code>

{{صندوق رسالة أخرى
| صغير = نعم
| الصورة = [[ملف:Replacement filing cabinet.svg|50px]]
| صورة صغيرة = [[ملف:Replacement filing cabinet.svg|32px]]
| النص = 
صغير = نعم <br /> الصورة = <nowiki>[[File:Replacement filing cabinet.svg|50px]]</nowiki> <br /> صورة صغيرة = <nowiki>[[File:Replacement filing cabinet.svg|32px]]</nowiki>
}}
'''صورة صغيرة'''
:'''لا وسيط''' = إذا لم يُعطى وسيط '''صورة صغيرة''' فإن القالب يستخدم وسيط '''الصورة'''. إذا كان وسيط '''الصورة''' فارغًا أيضًا فإن الصورة للصغيرة الافتراضية ستُستخدم.
:'''صورة''' = ينبغي أن تكون صورةً بصيغة نص ويكي كاملة. عرض 30px ينبغي أن حجمًا مُناسبًا. كمثال:
::<code><nowiki>صورة صغيرة = [[File:Replacement filing cabinet.svg|30px]]</nowiki></code>
:'''بدون''' = يعني عدم استخدام أي صورة. هذا يتجاوز أي صورة مُعطاة لوسيط الصورة، حين استخدام "صغير=نعم".

{{صندوق رسالة أخرى
| صغير = نعم
| صورة يسار = [[ملف:Nuvola apps bookcase.png|50px]]
| صورة صغيرة يسار = بدون
| النص = 
صغير = نعم <br /> صورة يسار = <nowiki>[[File:Nuvola apps bookcase.png|50px]]</nowiki> <br /> صورة صغيرة يسار = بدون
}}
'''صورة صغيرة يسار'''
:'''No parameter''' = If no '''smallimageright''' parameter is given then this template falls back to use the '''imageright''' parameter. If the '''imageright''' parameter also is empty then no image is shown on the right side.
:'''An image''' = Should be an image with usual wiki notation. 30px width is usually about right. For example:
::<code><nowiki>smallimageright = [[File:Nuvola apps bookcase.png|30px]]</nowiki></code>
:'''Anything''' = Any other object that you want to show on the right side.
:'''none''' = Means that no right side image is used. This overrides any image fed to '''imageright''', when "small=yes".

'''smalltext'''
:A shorter version of the message body text. If no '''smalltext''' parameter is given then this template falls back to use the '''text''' parameter.

=== 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 ombox CSS classes in [[ميدياويكي:Common.css]] for most of its looks, thus it is fully skinnable.

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 [[نقاش القالب:Ombox|talk page]]. Since this template works almost exactly like {{قا|صندوق رسالة مقالة}}, {{قا|صندوق رسالة نقاش}}, {{قا|صندوق رسالة ملف}} and {{قا|صندوق رسالة تصنيف}} their talk pages and related pages might also contain more details.

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

<includeonly>{{ملعب آخر|
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[تصنيف:قوالب صناديق الرسائل]]
[[تصنيف:مستثنى من الطباعة]]
}}</includeonly>