وحدة:Flagg/شرح

قالب {{Flagg}} (عـلم عـام) هو قالب أعلام عام مع تنسيق الإخراج متغير. يستخدم لغة لوا بدلا من الويكيبيديا:WikiProject Flag Template، لأنها تتيح تجاوز اسم الصورة والهدف والارتباط، ويعمل القالب لحد لو كان قالب البلد غير موجود (دون تجاوز أى من حدود القوالب).

الوسائط

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

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

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

اذا كان أى حرف من المعلمة مفقود أو بطابع لا يتدور مع واحد من الخيارات اللى بعد كده , سيتم استخدام القيمه الافتراضية المحددة أدناه؛ على سبيل المثال اذا كانت المعلمة الأولى مساوية لـ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}} → باكستان
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|Fiji}} →  Fiji (default format)
• {{flagg||Fiji}} →  Fiji (default format)
• {{flagg|pnbr|Fiji}} → Flag of Fiji
• <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|البلد}}	{{علم|الصين}} → {{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|البلد}}	{{علم ديكو|الصين}} → {{flagg|uxx|China}} →
{{رمز علم|البلد}}	{{flagg|cxx|البلد}}	{{رمز علم|الصين}} → {{flagg|cxx|China}} →
{{صورة رمز علم|image}}	{{flagg|uxx|image=image}}	{{صورة رمز علم|Flag of China.svg}} → {{flagg|uxx|image=Flag of China.svg}} →
{{رابط علم|البلد|لاحقة }}	{{flagg|unp|البلد|suff=لاحقة }}	{{رابط علم|الصين|at the Hopman Cup}} → الصين {{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|[[الصين]]}} → الصين {{flagg|xnc|China}} → China

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

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