وحدة:Flagg/شرح

قالب {{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	خلية جدول	يستخدم فاصل خلية جدول (||).	{{flagg|utu|Niger}} ينتج: ←
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}} ينتج: ←
• {{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|age=20|avar=fbu}} ينتج: ←
• {{flagg|psf|Egypt|avar=navy}} ينتج: ←

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

• {{flagg|isc|Belfast}} ينتج: ←
• {{flagg|isc|Belfast|image=Flag of Belfast.svg}} ينتج: ←

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

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

قوالب عامة

القالب	قالب {{flagg}} مقابل	مثال
{{العلم|البلد}}	{{flagg|unc|البلد}}	{{العلم|China}} ينتج: ← قالب:بيانات بلد الصين {{flagg|unc|China}} ينتج: ←
{{flagbig|البلد}}	{{flagg|ulc|البلد|sz=l}}	{{flagbig|China}} ينتج: ← قالب:Flagbig {{flagg|ulc|China|sz=l}} ينتج: ←
{{flagc|البلد}}	{{flagg|inc|البلد}}	{{flagc|China}} ينتج: ← قالب:Flagc {{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}} ينتج: ← قالب:Flag+link {{flagg|unp|China|pref=Agriculture in}} ينتج: ←
{{Flaglist|البلد}}	{{flagg|usc|البلد}}	{{Flaglist|China}} ينتج: ← قالب:Flaglist {{flagg|usc|China}} ينتج: ←
{{flagof|البلد}}	{{flagg|unp|البلد|sz=l}}	{{flagof|China}} ينتج: ← قالب:Flagof {{flagg|unp|China|sz=l}} ينتج: ←
{{علم يمين|البلد}}	{{flagg|uncr|البلد}}	{{علم يمين|China}} ينتج: ← قالب:علم يمين {{flagg|uncr|China}} ينتج: ←
{{Flagu|البلد}}	{{flagg|unu|البلد}}	{{Flagu|China}} ينتج: ← قالب:Flagu {{flagg|unu|China}} ينتج: ←
{{Noflag|البلد}}	{{flagg|xnu|البلد}}	{{Noflag|China}} ينتج: ← China {{flagg|xnu|China}} ينتج: ←
{{Noflag|[[country]]}}	{{flagg|xnc|البلد}}	{{Noflag|[[الصين]]}} ينتج: ← الصين {{flagg|xnc|China}} ينتج: ←

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

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

القالب	قالب {{flagg}} مقابل	مثال
{{ك ق|البلد}}	{{flagg|unpe|البلد|avar=fb}}	{{ك ق|China}} ينتج: ← قالب:ك ق {{flagg|unpe|China|avar=fb}} ينتج: ←
{{ك ق|البلد|align=1}}	{{flagg|uspe|البلد|avar=fb|al=c}}	{{ك ق|China|align=1}} ينتج: ← قالب:ك ق {{flagg|uspe|China|al=c|avar=fb}} ينتج: ←
{{ك ق-كبير|البلد}}	{{flagg|ulpe|البلد|avar=fb|sz=l}}	{{ك ق-كبير|China}} ينتج: ← قالب:ك ق-كبير {{flagg|ulpe|China|sz=l|avar=fb}} ينتج: ←
{{ك ق-يم|البلد}}	{{flagg|unpre|البلد|avar=fb}}	{{ك ق-يم|China}} ينتج: ← قالب:ك ق-يم {{flagg|unpre|China|avar=fb}} ينتج: ←
{{ك ق ت|عمر|البلد}}	{{flagg|unpe|البلد|avar=fbu|age=عمر}}	{{ك ق ت|17|China}} ينتج: ← قالب:ك ق ت {{flagg|unpe|China|age=17|avar=fbu}} ينتج: ←
{{ك ق ن|البلد}}	{{flagg|unpe|البلد|avar=fbw}}	{{ك ق ن|China}} ينتج: ← قالب:ك ق ن {{flagg|unpe|China|avar=fbw}} ينتج: ←
{{Fbwu|عمر|البلد}}	{{flagg|unpe|البلد|avar=fbwu|age=عمر}}	{{Fbwu|17|China}} ينتج: ← قالب:Fbwu {{flagg|unpe|China|age=17|avar=fbwu}} ينتج: ←
{{Army|البلد}}	{{flagg|unfe|البلد|avar=army}} (لا يتجاوز الاسم التلقائي)	{{Army|China}} ينتج: ← قالب:Army {{flagg|unfe|China|avar=army}} ينتج: ←
{{بحرية|البلد}}	{{flagg|unfe|البلد|avar=navy}} (لا يتجاوز الاسم التلقائي)	{{بحرية|China}} ينتج: ← قالب:بحرية {{flagg|unfe|China|avar=navy}} ينتج: ←
{{قوات جوية|البلد}}	{{flagg|unfe|البلد|avar=air force}} (لا يتجاوز الاسم التلقائي)	{{قوات جوية|China}} ينتج: ← قالب:قوات جوية {{flagg|unfe|China|avar=air force}} ينتج: ←