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

الاسم

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

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

أخرى

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

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

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

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

وسائط الصورة

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

يحدد صورة متغير العلم، كما هي محددة في قالب بيانات بلد. على سبيل المثال، {{flagg|ixx|المانيا|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|Philippinesthe=1}} →  . استعمل |pthe= إذا كان الرابط يحتاج ذلك، "و" لكن في الاسم ليس كذلك، واستخدم |nthe= إذا كان الاسم يحتاج ذلك، ولكن الرابط لا يحتاج ذلك.

|section=

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

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

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

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

|nalign=، و[|nal=]

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

|text=

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

أمثلة

التنسيقات:

• {{flagg|usc|vivi}} →  vivi (default format)
• {{flagg||Vivy}} →  Vivy (default format)
• {{flagg|pnbr|Vivy}} → Flag of Vivy
• <span style="display:inline-block;text-align:center;">{{flagg|ilf|vivi|sz=xl}}</span&gt ; → Flag of FJI

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

{{flagg|utu|Jamaica}}		Jamaica
{{flagg|utur|Jamaica}}	Jamaica
{{flagg|utu|Jamaica|al=l|nal=l}}		Jamaica
{{flagg|utu|Jamaica|al=c|nal=c}}		Jamaica
{{flagg|utu|Jamaica|al=r|nal=r}}		Jamaica

• {{flagg|usu|Swaziland}} →  Swaziland
• {{flagg|usu|Swaziland|al=l}} →  Swaziland
• {{flagg|usu|Swaziland|al=c}} →  Swaziland
• {{flagg|usu|Swaziland|al=r}} →  Swaziland

Default image parameters and parameter names:

• {{flagg|isc|Myanmar}} →  Myanmar
• {{flagg|isc|Myanmar|border=}} →  Myanmar
• {{flagg|isc|Myanmar|1974}} →  Myanmar
• {{flagg|isc|Myanmar|variant=1974}} →  Myanmar
• {{flagg|isc|Myanmar|name=Myanmar|variant=1974}} →  Myanmar
• {{flagg|isc|Myanmar|variant=1974}} →  Myanmar
• {{flagg|isc|Myanmar|sz=30}} →  Myanmar
• {{flagg|isc|Myanmar|size=30}} →  Myanmar
• {{flagg|isc|Myanmar|size=30px}} →  Myanmar
• {{flagg|isc|Myanmar|size=30x18px}} →  Myanmar
• {{flagg|isc|Myanmar|size=xs}} →  Myanmar
• {{flagg|isc|Myanmar|size=xl}} →  Myanmar
• {{flagg|isc|Myanmar|width=30|size=xs}} →  Myanmar
• {{flagg|isc|Myanmar|image=}} →  Myanmar
• {{flagg|isc|Myanmar|image=Flag of None.svg}} produces: →  Myanmar
• {{flagg|isc|Myanmar|image=File:Flag of None.svg}} produces: →  Myanmar

Links and altvars:

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

Data template not found:

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

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

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

قوالب عامة

القالب	قالب {{flagg}} مقابل	مثال
{{علم|البلد}}	{{flagg|unc|البلد}}	{{علم|China}} → قالب:بيانات بلد China {{flagg|unc|China}} → China
{{flagbig|البلد}}	{{flagg|ulc|البلد|sz=l}}	{{flagbig|China}} → الصين {{flagg|ulc|China|sz=l}} → China
{{flagc|البلد}}	{{flagg|inc|البلد}}	{{flagc|China}} → China {{flagg|inc|China}} → China
{{علم الدولة|البلد}}	{{flagg|unce|البلد}}	{{علم الدولة|CHN}} → الصين {{flagg|unce|CHN}} → الصين
{{علم ديكو|البلد}}	{{flagg|uxx|البلد}}	{{علم ديكو|China}} → قالب:بيانات بلد China {{flagg|uxx|China}} →
{{رمز علم|البلد}}	{{flagg|cxx|البلد}}	{{رمز علم|China}} → قالب:بيانات بلد 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}} → قالب:بيانات China {{flagg|unp|China|suff=at the Hopman Cup}} → China
{{flag+link|بادئة|البلد}}	{{flagg|unp|البلد|pref=بادئة}} (no existence check)	{{flag+link|Agriculture in|China}} → China {{flagg|unp|China|pref=Agriculture in}} → China
{{Flaglist|البلد}}	{{flagg|usc|البلد}}	{{Flaglist|China}} → China {{flagg|usc|China}} →  China
{{flagof|البلد}}	{{flagg|unp|البلد|sz=l}}	{{flagof|China}} → China {{flagg|unp|China|sz=l}} → China
{{علم يمين|البلد}}	{{flagg|uncr|البلد}}	{{علم يمين|China}} → China {{flagg|uncr|China}} → China
{{Flagu|البلد}}	{{flagg|unu|البلد}}	{{Flagu|China}} → China {{flagg|unu|China}} → China
{{Noflag|البلد}}	{{flagg|xnu|البلد}}	{{Noflag|China}} → China {{flagg|xnu|China}} → China
{{Noflag|[[country]]}}	{{flagg|xnc|البلد}}	{{Noflag|[[China]]}} → China {{flagg|xnc|China}} → China

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

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