وحدة:Flagg/شرح

قالب [[|]] (عـلم عـام) هو قالب أعلام عام مع تنسيق الإخراج متغير. يستخدم لغة لوا بدلا من الآلية الموحدة، لأنها تتيح تجاوز اسم الصورة والهدف والارتباط، ويعمل القالب حتى لو كان قالب البلد غير موجود (دون تجاوز أي من حدود القوالب).

الوسائط

يتم إعطاء (بدائل القيم) لكل معلمة بين قوسين ().

التنسيق (المعلمة الأولى غير المسماه)

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

إذا كان أي حرف من المعلمة مفقود أو بطابع لا يتطابق مع أحد الخيارات التالية, سيتم استخدام القيمه الافتراضية المحددة أدناه؛ على سبيل المثال إذا كانت المعلمة الأولى مساوية لـi، أو i**، أو izz ستقرأ كالتالي: isc.

الصورة

الصورة (الحرف الأول)

الحرف	المعنى	المعنى	وصفه	مثال
u	unlinked	دون وصلة	صورة غير مرتبطة (إفتراضي)	{{flagg|uxx|France}} ←
c	country	البلد	وصلة الصورة لصفحة البلد/الكيان.	{{flagg|cxx|France}} ←
p [f]	prefix/suffix		وصلة الصورة لاسم البلد مع البادئة. "و/أو" نص اللاحقة (افتراضي "علم ...")، يتعين باستخدام |pref= و|suff= (انظر ادناه).	{{flagg|pxx|France}} ←
i	image page	صفحة الصورة	وصلة الصورة إلى الملف الخاص بها تستخدم مع الصور غير الحرة.	{{flagg|ixx|France}} ←
d	data template	بيانات القالب	وصلة الصورة إلى قالب بيانات بلد المستخدم، للاستخدام في النقاش/التوثيق. تضيف الوحدة تلقائياً redirect=no إذا كانت الوصلة تحويلة.	{{flagg|dxx|France}} ←
x	علامة الشطب	علامة ×	لا يتم عرض أي صورة. يستخدم صورة شفافة غير مرتبطة للحفاظ على المسافات في حالة إذا كان الحرف الثاني أي شيء آخر غير x، وأيضاً o لم يتم تحديدها.	{{flagg|xnx|France}} ←

الفاصل

الفاصل (الحرف الثاني)

الحرف	المعنى	المعنى	وصفه	مثال
s	span box	مربع ممتد (افتراضي)	يتم وضع صورة العلم في <span>، وهذا يعني أن أسماء البلدان منحازة في قوائم عمودية؛ راجع توثيق قالب {{Flaglist}}.	{{flagg|usu|Niger}} ← النيجر
n	non-breaking space	مسافة غير منقسمة	يستخدم مسافة غير منقسمة (&nbsp;) كما هو الحال في معظم قوالب الأعلام، بما فيها قالب {{علم}}. لاحظ أن &nbsp; لا يمنع في الواقع التفاف بين الصورة والنص في جميع المتصفحات؛ استخدم w كما هو موضح أدناه إذا لزم الأمر.	{{flagg|unu|Niger}} ← النيجر
l	line break	خط مكسور	يستخدم فاصل سطر جديد (<br/>) كفاصل.	{{flagg|ulu|Niger}} ← النيجر
t	table cell	خلية جدول	يستخدم فاصل خلية جدول (||).		النيجر
x	X mark	علامة ×	لا يستخدم أي فاصل.	{{flagg|uxu|Niger}} ← النيجر

الاسم

الاسم (الحرف الثالث)

الحرف	المعنى	المعنى	وصفه	مثال
c	country	البلد (افتراضي)	يضع الوصلة إلى وصلة البلد.	{{flagg|xxc|Chile}} ← تشيلي
p	prefix/suffix	بادئة / لاحقة	وصلة اسم البلد إلى صفحة البلد، مع سابقة و/أو لاحقة (افتراضياً "علم ..."). تحدد باستخدام |pref=، و|suff= (طالع أدناه).	{{flagg|xxp|Chile}} ← تشيلي
f	full prefix/suffix	بادئة / لاحقة الكاملة	كما p، لكن في هذه الحالة يتم عرض البادئة و/أو اللاحقة.	{{flagg|xxf|Chile}} ← علم تشيلي
b	both country and prefix/suffix		يضع وصلة البلد ووصلة البادئة واللاحقة، يربط اسم البلد إلى صفحة الدولة، ويضع وصلة أخرى مع البادئة اللاحقة.	{{flagg|xxb|Chile}} ← علم تشيلي
u	unlinked	دون وصلة (انظر. {{flagu}})	يتم عرض اسم البلد كنص عادي، دون وصلة.	{{flagg|xxu|Chile}} ← تشيلي
d	data template	بيانات القالب	يربط اسم البلد إلى قالب بيانات البلد المستخدم، للاستخدام في صفحات النقاش أو التوثيق. يضع بشكل افتراضي redirect=no إذا كان القالب عبارة عن تحويلة.	{{flagg|xxd|Chile}} ← تشيلي
x	X mark	علامة ×	لا يعرض أي نص.	{{flagg|xxx|Chile}} ←

أخرى

يمكن تمكين بعض الخيارات الإضافية بإلحاق الرسائل التالية إلى الأحرف الثلاثة، في أي أمر:

الحرف	معنى	معنى	وصفه	مثال
a	alt	نص بديل	يضيف اسم البلد (معلمة "name"، وإن لم تكن متوفرة يستخدم المعلمة الثانية الغير مسماة) كـ نص بديل للصورة يظهر عند تمرير الفأرة على الصورة، إذا استخدمت المعلمة |alt= لتخصيص نص بديل للصورة، فهذا لا يحتاج إلى تعيينه بصورة منفصلة.	{{flagg|uxxa|Pakistan}} ←
e	expands	اسم مختصر	يستخدم الاسم المنصوص عليه في قالب بيانات بلد (بدلا من المعلمة الأولى) للعرض، كما في قالب {{علم الدولة}}.	{{flagg|unue|PAK}} ← باكستان
o	Omits		يتجاهل الصورة والمسافات في حالة كانت الصورة غير مرئية، بحيث يظهر التباعد في حالة تم عرض العلم. مفيد للاستعمال في حالة التضمين في سطر أو في قوائم أفقية، حيث ليست هناك حاجة لمحاذاة الاسم.	{{flagg|unuo|Pakistan|image=}} ← باكستان Compare with: {{flagg|unu|Pakistan|image=}} ← باكستان
r	right		يعكس ترتيب العناصر, حيث يضع الصورة يمين الاسم كما قالب {{علم يمين}}. ولا يؤثر هذا على ترتيب الأحرف في التنسيق.	{{flagg|uncr|Pakistan}} ← باكستان
w	wrapping		يتجنب الالتفاف بإضافة <span class="nowrap"></span> حول الناتج.	{{flagg|unuw|Pakistan}} ← باكستان

الكيان/البلد (المعلمة الثانية الغير مسماة)

المعلمة الثانية هي اسم البلد أو الكيان. يستخدمها القالب لقراءة بيانات العلم من "قالب:بيانات بلد"؛ إذا لم يوجد القالب، سيتم استخدام نفس المعلمة افتراضياً كاسم البلد ولن يتم عرض أي صورة، وتعرف المعلمة اسم العرض الافتراضي إذا لم تستخدم المعلمة e.

وسائط الصورة

|variant= [المعلمة الثالثة غير المسماة]

يحدد صورة متغير العلم، كما هي محددة في قالب بيانات بلد. على سبيل المثال، {{flagg|ixx|Germany|naval}} ← يستخدم المتغير "naval بحري" في قالب:بيانات بلد ألمانيا.

|image=

تخصيص اسم الصورة تحتوي أو لا تحتوي "File:" .يمكن استخدامها إذا كانت الصورة المطلوبة ليست متوفرة كمتغير للكيان (يمكنك بدلا من ذلك تطلب ذلك يمكن ان تضاف في صفحة نقاش القالب البيانات التي تخصها)، أو في حالة عدم وجود قالب بيانات. قم بتعيينها إلى "none" أو ["blank" أو قيمة فارغة] لاستخدام صورة شفافة غير موصولة (عمليا مطابقة لتنسيق الوسيط x).

|size= و[|sz=]

يحدد حجم الصورة؛ الافتراضي هو 23×15 بكسل (أكبر في بعض الكيانات). يمكنك استخدام حجم صريح في بكسل (مثل 30x20px; اللاحقة "px" هي اختيارية) أو واحد من الأحجام النسبية "xs" (نصف الأبعاد الافتراضية)، "s" و"m" و"l" و"xl" (ضعف الحجم الافتراضي).

|border=

افتراضيا، يتضمن رمز العلم حدود، إلا إذا تم تعطيله في قالب بيانات بلد في الوسيط |border= يمكن تعيينه لـ "yes" أو ["y" ًأو "1"] لفرض الحدود عند استبعاده افتراضيا، أو يمكن تعيينه لـ "no" أو ["n" أو "0" أو سلسلة فارغة] لمنع ذلك.

|align= و[|al=]

قم بتعيينها إلى

• "left" أو ["l"] أو
• "center" أو ["centre" أو "c" أو "middle" أو "m"]
• أو "right" أو ["r"]

لضبط محاذاة صورة لتنسيق المربع الممتد (s) وتنسيق خلية الجدول (t). بالنسبة للوسيط t فانه افتراضياً محاذاة الوسط، أما s فهو محاذاة إلى اليمين، إن لم تحدد قيمة لـ r وإلا فأنه سيكون محاذاة لليسار.

|width= و[|w=]

يحدد عرض المربع الممتد المحيط حول الصورة (s) بالبكسل، بدون "px" يتم احتساب قيمة افتراضية بواسطة وحدة:Flaglist/size ويعتمد على حجم الصورة.

|alt=

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

|ilink=

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

وسائط النص والوصلة

|name=

تغيير اسم البلد المعروض. لاحظ أنه مع تنسيق f، وهذا يشمل البادئة و / أو لاحقة.

[|link=] و|clink=

الكتابة فوق الارتباط إلى مقالة البلد؛ يتم استخدام هذه أيضا لبناء وصلة بادئة / لاحقة للخيارات التالية: f، وp، وb .

|pref= و|suff= و|plink=

|pref= و|suff= تعيين البادئة واللاحقة لاستخدامها في بادئة / لاحقة الروابط (شكل الحروف f، وp وb). افتراضياً،إذا لم يتم تحديد ذلك، سيكون "علم_" بادئة (راجع {{flagof}}) ولن يتم استخدام لاحقة. يمكن استخدام المعلمة |plink= لتجاوز الارتباط المشترك.

|the=

قم بتعيينها إلى "yes" أو ["y"، أو "1"] لتضمين "the" قبل اسم البلد في بادئة/لاحقة الروابط . مثال: {{flagg|usf|Philippines|the=1}} ← علم ال الفلبين. استعمل |pthe= إذا كان الرابط يحتاج ذلك، "و" لكن في الاسم ليس كذلك، واستخدم |nthe= إذا كان الاسم يحتاج ذلك، ولكن الرابط لا يحتاج ذلك.

|section=

وصلة لقسم من أقسام المقالة، دون عرض اسم المقطع في الاسم، في حالة تم استخدام وصلة البلد وأيضاً بادئة/لاحقة الوصلة قم باستخدام |csection= للقسم في المقالة، واستخدم |psection= للقسم المسبوق/المتبوع من المقالة.

|altvar=، و[|avar=]، و|age=

إمكانية استخدام لاحقة قياسية محددة مسبقاً، كوصلة لفريق رياضي أو فرع عسكري. يتم تحميل بيانات altvar واللاحقة من وحدة:Flagg/Altvar data. القيم الممكنة للمعلمات هي الأسماء الأساسية للقوالب المخصصة المقابلة؛ قيم الاسم المستعار من أسم الرياضة الكاملة الموجودة (أنظر الأمثلة الواردة أدناه وصفحة البيانات).

بالنسبة لبعض الكيانات أو العناصر، هذا يغير الصورة أيضاً لمحدد بديل variant إلى رياضة أو فرع عسكري؛ على سبيل المثال: {{flagg|usp|Ireland|avar=ru}} ← أيرلندا يستخدم علم اتحاد الرغبي لتمثيل فريق اتحاد الرجبي الأيرلندي. لفرق الشباب في بعض الألعاب الرياضية (انظر صفحة البيانات)، الحد الأدنى للسن لا بد وأن يتم تعيينه باستخدام الوسيط |age=.

|nalign=، و[|nal=]

تعيين محاذاة النص في شكل خلية الجدول (t). افتراضياً محاذاة لليسار؛ القيم الممكنة هي نفسها بالنسبة لـ |align=.

|text=

تجاوز النص بالكامل؛ فقط يستخدم عند الضرورة لأي صيغ غير قياسية. بدلا من ذلك يمكنك تعيين الحرف الثالث من المعلمة تنسيق لـ x (دون نص) وقم بإضافة النص المخصص خارج القالب.

أمثلة

التنسيقات:

• {{flagg|usc|Fiji}} ← فيجي (التنسيق الافتراضي)
• {{flagg||Fiji}} ← فيجي (التنسيق الافتراضي)
• {{flagg|pnbr|Fiji}} ← علم فيجي
• <span style="display:inline-block;text-align:center;">{{flagg|ilf|Fiji|sz=xl}}</span> → علم فيجي

تنسيق الجدول والمحاذاة:

{{flagg|utu|Jamaica}}		جامايكا
{{flagg|utur|Jamaica}}	جامايكا
{{flagg|utu|Jamaica|al=l|nal=l}}		جامايكا
{{flagg|utu|Jamaica|al=c|nal=c}}		جامايكا
{{flagg|utu|Jamaica|al=r|nal=r}}		جامايكا

• {{flagg|usu|Switzerland}} ← سويسرا
• {{flagg|usu|Switzerland|al=l}} ← سويسرا
• {{flagg|usu|Switzerland|al=c}} ← سويسرا
• {{flagg|usu|Switzerland|al=r}} ← سويسرا

معايير الصورة الافتراضية واسماء المعلمات:

• {{flagg|isc|Myanmar}} ← ميانمار
• {{flagg|isc|Myanmar|border=}} ← ميانمار
• {{flagg|isc|Myanmar|1974}} ← ميانمار
• {{flagg|isc|Myanmar|variant=1974}} ← ميانمار
• {{flagg|isc|Myanmar|name=Burma|variant=1974}} ← Burma
• {{flagg|isc|Burma|variant=1974}} ← بورما
• {{flagg|isc|Myanmar|sz=30}} ← ميانمار
• {{flagg|isc|Myanmar|size=30}} ← ميانمار
• {{flagg|isc|Myanmar|size=30px}} ← ميانمار
• {{flagg|isc|Myanmar|size=30x18px}} ← ميانمار
• {{flagg|isc|Myanmar|size=xs}} ← ميانمار
• {{flagg|isc|Myanmar|size=xl}} ← ميانمار
• {{flagg|isc|Myanmar|width=30|size=xs}} ← ميانمار
• {{flagg|isc|Myanmar|image=}} ← ميانمار
• {{flagg|isc|Myanmar|image=Flag of None.svg}} ينتج: → ميانمار
• {{flagg|isc|Myanmar|image=File:Flag of None.svg}} ينتج: → ميانمار

الوصلات والـ altvars:

• {{flagg|psp|Egypt}} ← مصر
• {{flagg|psf|Egypt}} ← علم مصر
• {{flagg|psb|Egypt}} ← علم مصر
• {{flagg|psb|Philippines|the=1}} ← علم ال الفلبين
• {{flagg|csc|Egypt|section=History}} ← مصر
• {{flagg|csb|Egypt|csection=History}} ← علم مصر
• {{flagg|psb|Egypt|psection=Kingdom of Egypt (1922–1953)|variant=1922}} ← علم مصر
• {{flagg|psb|Egypt|plink=List of Egyptian flags}} ← علم مصر
• {{flagg|psf|Egypt|pref=تاريخ}} ← تاريخ مصر
• {{flagg|psp|Egypt|suff=at the Olympics}} ← مصر
• {{flagg|psp|Egypt|avar=fb}} ← مصر
• {{flagg|psp|Egypt|avar=football}} ← مصر
• {{flagg|psp|Egypt|avar=fbu|age=20}} ← مصر
• {{flagg|psf|Egypt|avar=navy}} ← مصر القوات البحرية

قالب بيانات غير موجود:

• {{flagg|isc|Belfast}} ← Belfast
• {{flagg|isc|Belfast|image=Flag of Belfast.svg}} ← Belfast

مقارنة مع قوالب أخرى

هذه القوالب تسبق قالب flagg، مع أن أغلبها لا تملك خيارات لتخصيص الوصلات والصور، إلا أنها ربما تكون أسرع لأنها تقوم فقط بوظيفتين دون الاستناد إلى لوا.

قوالب عامة

القالب	قالب [[|]] مقابل	مثال
{{العلم|البلد}}	{{flagg|unc|البلد}}	{{العلم|China}} ← China {{flagg|unc|China}} ← الصين
{{flagbig|البلد}}	{{flagg|ulc|البلد|sz=l}}	{{flagbig|China}} ← الصين {{flagg|ulc|China|sz=l}} ← الصين
{{flagc|البلد}}	{{flagg|inc|البلد}}	{{flagc|China}} ← الصين {{flagg|inc|China}} ← الصين
{{علم الدولة|البلد}}	{{flagg|unce|البلد}}	{{علم الدولة|CHN}} ← الصين {{flagg|unce|CHN}} ← الصين
{{علم ديكو|البلد}}	{{flagg|uxx|البلد}}	{{علم ديكو|China}} ← {{flagg|uxx|China}} ←
{{رمز علم|البلد}}	{{flagg|cxx|البلد}}	{{رمز علم|China}} ← {{flagg|cxx|China}} ←
{{صورة رمز علم|image}}	{{flagg|uxx|image=image}}	{{صورة رمز علم|Flag of China.svg}} ← {{flagg|uxx|image=Flag of China.svg}} ←
{{رابط علم|البلد|لاحقة }}	{{flagg|unp|البلد|suff=لاحقة }}	{{رابط علم|China|at the Hopman Cup}} ← الصين {{flagg|unp|China|suff=at the Hopman Cup}} ← الصين
{{flag+link|بادئة|البلد}}	{{flagg|unp|البلد|pref=بادئة}} (no existence check)	{{flag+link|Agriculture in|China}} ← الصين {{flagg|unp|China|pref=Agriculture in}} ← الصين
{{Flaglist|البلد}}	{{flagg|usc|البلد}}	{{Flaglist|China}} ← الصين {{flagg|usc|China}} ← الصين
{{flagof|البلد}}	{{flagg|unp|البلد|sz=l}}	{{flagof|China}} ← الصين {{flagg|unp|China|sz=l}} ← الصين
{{علم يمين|البلد}}	{{flagg|uncr|البلد}}	{{علم يمين|China}} ← الصين {{flagg|uncr|China}} ← الصين
{{Flagu|البلد}}	{{flagg|unu|البلد}}	{{Flagu|China}} ← الصين {{flagg|unu|China}} ← الصين
{{Noflag|البلد}}	{{flagg|xnu|البلد}}	{{Noflag|China}} ← China {{flagg|xnu|China}} ← الصين
{{Noflag|[[country]]}}	{{flagg|xnc|البلد}}	{{Noflag|[[الصين]]}} ← الصين {{flagg|xnc|China}} ← الصين

قوالب رياضية/عسكرية

تستخدم الأمثلة قوالب كرة القدم، وبقية الألعاب الرياضية تعمل تبعاً لذلك.