عرض مصدر قالب:معرض الصور/شرح

<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[أرابيكا:ويكي بيانات]]). -->
{{من أجل|وسم التهذيب|قالب:تهذيب معرض صور}}
{{استخدام واسع}}
{{تنبيه|قبل إنشاء معرض، يرجى قراءة '''[[أرابيكا:IG|سياسة استخدام الصور للمعارض]]'''. بشكل عام، '''لا ينبغي إضافة معرض''' طالما أن هناك مساحة لعرض الصور بشكل فعال بجوار النص.}}
{{صفحة توثيق فرعية}}
{{Lua|وحدة:Gallery}}

يوفر هذا القالب وظيفة متقدمة لبناء معرض (مع التحكم الدقيق في التنسيق). لإنشاء معارض عامة، استخدم {{Ill-WD2|وسم معرض الصور|id=Q15410413}}.

يعرض هذا القالب معرضًا للصور في مصفوفة، من اليمين إلى اليسار في صفوف. تتحكم المعلمات العامة {{وسيط|width}} و{{وسيط|height}} في حجم جميع الصور في المعرض. يعتمد عدد الصور لكل صف على معلمات عرض الصورة وعرض الشاشة. يمكن أن يتغير عدد الصور لكل صف عندما يقوم المستخدم بتغيير حجم النافذة.

للحصول على دليل الأسلوب حول الأماكن المناسبة للمعارض، راجع {{وصلة قسم|Wikipedia:Image use policy#Image galleries}}.

== جميع معلمات القالب فارغة ==
{| style="background: transparent;"
|<syntaxhighlight lang="wikitext">{{معرض الصور
| title        = 
| align        =
| footer       =
| style        =
| state        =
| height       =
| width        =
| perrow       =
| mode         = 
| whitebg      = 
| noborder     =
| captionstyle =
| File:
 | Write a caption here
 | alt1=
| File:
 | Write a caption here
 | alt2=
| File:
 | Write a caption here
 | alt3=
| File:
 | Write a caption here
 | alt4=
| File:
 | Write a caption here
 | alt5=
}}</syntaxhighlight>
|}

== إعدادات القالب ==

=== لكل صورة ===

حدد سطرًا من النموذج التالي لكل صورة.
: <code>|File:''Filename''</code> <code>|''Caption''</code> {{وسيط|alt''n''|''alternative text''}}

لاحظ أن اسم الملف والتسمية التوضيحية لا يحتاجان إلى أسماء معلمات، ولكن يجب أن تكون كل معلمة نص بديل مسبوقة بـ {{وسيط|alt''n''}}.

أين:
: <code>|File:''Filename''</code> – اسم ملف الصورة. أيضاً <code>File:</code> أو <code>Image:</code> يمكن استخدام البادئة
: <code>|''Caption''</code> – التسمية التوضيحية تحت الصورة؛ انظر [[أرابيكا:Manual of Style/Captions]]
: {{وسيط|alt''n''}} – [[alt attribute]]: {{وسيط|alt1}} بالنسبة للصورة الأولى، {{وسيط|alt2}} للصورة الثانية وهكذا
:: <code>''alternative text''</code> – [[أرابيكا:نص بديل للصور|نص بديل]] للصورة، يستخدم من قبل ضعاف البصر أو القراء الآخرين الذين لا يستطيعون رؤية الصورة بوضوح. إذا تم حذفه، فسيكون النص البديل للصورة فارغًا.
=== المعلمات الاختيارية ===

تنطبق هذه المعلمات على المعرض بأكمله:

: {{وسيط|title}} – عنوان المعرض
: {{وسيط|align}} – محاذاة المعرض على الصفحة، إلى اليسار (افتراضي)، أو الوسط، أو اليمين؛ تم تجاهله عند تعيين {{وسيط|state}}.
: {{وسيط|footer}} – نص صغير بمحاذاة إلى اليمين أسفل الصور
: {{وسيط|style}} – [[أوراق الأنماط المتتالية|CSS]] توجيهات الأسلوب للمعرض بأكمله (انظر [[مساعدة:Cascading Style Sheets]])
: {{وسيط|state}} – يضبط الحالة الافتراضية للمعارض القابلة للطي؛ استخدم {{وسيط|state|expanded}} أو {{وسيط|state|collapsed}}؛ تشغل المعارض القابلة للطي عرض الصفحة بالكامل
: {{وسيط|mode}} – يضبط الوضع الذي تستخدمه علامة المعرض الداخلية. تتضمن القيم الشائعة {{وسيط|mode|packed}} و{{وسيط|mode|nolines}} (راجع [[مساعدة:Gallery tag]] لمزيد من الخيارات)
تنطبق هذه المعلمات على جميع الصور الموجودة في المعرض:
: {{وسيط|noborder}} – قم بإلغاء الحدود المحيطة بالصور، واستخدم {{وسيط|noborder|yes}} للضبط.
: {{وسيط|whitebg}} – قم بإلغاء الخلفية البيضاء بعد الصور، واستخدم {{وسيط|whitebg|no}} للضبط.
: {{وسيط|height}} – الحد الأقصى لارتفاع كل صورة. إذا لم يتم تضمين هذه المعلمة، فإن القيمة الافتراضية {{وسيط|height}} هي 180 بكسل. استخدم رقمًا بسيطًا هنا، على سبيل المثال، {{نص ملون أخضر|200}}، بدون تسمية الوحدات، على سبيل المثال، {{نص ملون أحمر|200px}}.
: {{وسيط|width}} – الحد الأقصى لعرض كل صورة، الافتراضي هو 180 بكسل. استخدم رقمًا هنا، على سبيل المثال، {{نص ملون أخضر|150}}، بدون وحدات، على سبيل المثال، {{نص ملون أحمر|150px}}.
: {{وسيط|perrow}} – عدد الصور التي سيتم عرضها في كل صف
: {{وسيط|captionstyle}} – [[أوراق الأنماط المتتالية|CSS]] توجيهات الأسلوب للتسميات التوضيحية (انظر [[مساعدة:Cascading Style Sheets]])

لا يمكن تعديل نسبة العرض إلى الارتفاع الأصلية للصورة بواسطة {{وسيط|width}} أو {{وسيط|height}} - لن تصبح الصورة المستطيلة مربعة إذا كانت {{وسيط|width}} و{{وسيط|height}} تم ضبطها على نفس القيمة.

== أمثلة ==
{{خام|<nowiki>{{معرض الصور
|title=تصوير ثقافي عن جورج واشنطن
|width=160 | height=170
|align=center
|footer=مثال 1
|File:Federal Hall NYC 27.JPG 
 |تمثال واشنطن خارج [[النصب التذكاري الوطني للقاعة الفيدرالية]] في [[مدينة نيويورك]]، ويطل على [[وول ستريت]]
 |alt1=تمثال يواجه مبنى مدينة به أعمدة يونانية وعلم أمريكي ضخم
|File:Mount Rushmore2.jpg 
 |بناء صورة واشنطن في [[جبل رشمور]]، ج. 1932
 |alt2=جانب من الوجه الحجري على سفح الجبل، مع 3 عمال.
|File:2006 Quarter Proof.png 
 |يتم إحياء ذكرى واشنطن على [[ربع (عملة الولايات المتحدة)|ربع]] دولار.
 |alt3=عملة فضية لامعة عليها صورة تمثال نصفي لواشنطن. 
|File:George Washington Presidential $1 Coin obverse.png 
 |واشنطن على [[عملة الدولار (الولايات المتحدة)|عملة الدولار]]
 |alt4=عملة ذهبية مع تمثال نصفي لواشنطن في اتجاه اليسار بقليل
}}</nowiki>}}
{{معرض الصور
|title=تصوير ثقافي عن جورج واشنطن
|width=160 |height=170
|align=center
|footer=مثال 1
|File:Federal Hall NYC 27.JPG
 |تمثال واشنطن خارج [[النصب التذكاري الوطني للقاعة الفيدرالية]] في [[مدينة نيويورك]]، ويطل على [[وول ستريت]]
 |alt1=تمثال يواجه مبنى مدينة به أعمدة يونانية وعلم أمريكي ضخم
|File:Mount Rushmore2.jpg
 |بناء صورة واشنطن في [[جبل رشمور]]، ج. 1932
 |alt2=جانب من الوجه الحجري على سفح الجبل، مع 3 عمال.
|File:2006 Quarter Proof.png
 |يتم إحياء ذكرى واشنطن على [[ربع (عملة الولايات المتحدة)|ربع]] دولار.
 |alt3=عملة فضية لامعة عليها صورة تمثال نصفي لواشنطن. 
|File:George Washington Presidential $1 Coin obverse.png
 |واشنطن على [[عملة الدولار (الولايات المتحدة)|عملة الدولار]]
 |alt4=عملة ذهبية مع تمثال نصفي لواشنطن في اتجاه اليسار بقليل
}}

{{خام|<nowiki>{{معرض الصور
|title=تصوير ثقافي عن جورج واشنطن
|width=120 |height=100
|align=center
|footer=مثال 2a
|File:Federal Hall NYC 27.JPG
 |تمثال واشنطن خارج [[النصب التذكاري الوطني للقاعة الفيدرالية]] في [[مدينة نيويورك]]، ويطل على [[وول ستريت]]
 |alt1=Statue facing a city building with Greek columns
|File:Mount Rushmore2.jpg
 |عمل على صورة واشنطن في [[جبل رشمور]]، ج. 1932
 |alt2=جانب من الوجه الحجري على سفح الجبل، مع 3 عمال.
|File:2006 Quarter Proof.png
 |واشنطن على عملة [[ربع (عملة الولايات المتحدة)|الربع]]
 |alt3=عملة فضية لامعة عليها صورة تمثال نصفي لواشنطن. 
|File:United_States_one_dollar_bill,_obverse.jpg
 |عملة دولار أمريكي واحد
 |alt4=الجانب الأمامي من عملة الدولار الأمريكي، مع صورة واشنطن في المنتصف.
|File:George Washington Presidential $1 Coin obverse.png
 |واشنطن على [[عملة الدولار (الولايات المتحدة)|عملة الدولار]]
 |alt5=عملة ذهبية مع تمثال نصفي لواشنطن باتجاه اليسار
}}</nowiki>}}
{{معرض الصور
|title=تصوير ثقافي عن جورج واشنطن
|width=120 |height=100
|align=center
|footer=مثال 2a
|File:Federal Hall NYC 27.JPG
|alt1=Statue facing a city building with Greek columns
 |تمثال واشنطن خارج [[النصب التذكاري الوطني للقاعة الفيدرالية]] في [[مدينة نيويورك]]، ويطل على [[وول ستريت]]
|File:Mount Rushmore2.jpg
|alt2=جانب من الوجه الحجري على سفح الجبل، مع 3 عمال.
 |عمل على صورة واشنطن في [[جبل رشمور]]، ج. 1932
|File:2006 Quarter Proof.png
|alt3=عملة فضية لامعة عليها صورة تمثال نصفي لواشنطن. 
 |واشنطن على عملة [[ربع (عملة الولايات المتحدة)|الربع]]
|File:United_States_one_dollar_bill,_obverse.jpg
|alt4=الجانب الأمامي من عملة الدولار الأمريكي، مع صورة واشنطن في المنتصف.
 |عملة دولار أمريكي واحد
|File:George Washington Presidential $1 Coin obverse.png
|alt5=عملة ذهبية مع تمثال نصفي لواشنطن باتجاه اليسار
 |واشنطن على [[عملة الدولار (الولايات المتحدة)|عملة الدولار]]
}}

{{معرض الصور
|title=تصوير ثقافي عن جورج واشنطن
|width=120 |height=100
|align=center
|footer=مثال 2b
|File:Federal Hall NYC 27.JPG
|alt1=Statue facing a city building with Greek columns
 |تمثال واشنطن خارج [[النصب التذكاري الوطني للقاعة الفيدرالية]] في [[مدينة نيويورك]]، ويطل على [[وول ستريت]]
|File:Mount Rushmore2.jpg
|alt2=جانب من الوجه الحجري على سفح الجبل، مع 3 عمال.
 |عمل على صورة واشنطن في [[جبل رشمور]]، ج. 1932
|File:2006 Quarter Proof.png
|alt3=عملة فضية لامعة عليها صورة تمثال نصفي لواشنطن. 
 |واشنطن على عملة [[ربع (عملة الولايات المتحدة)|الربع]]
|File:United_States_one_dollar_bill,_obverse.jpg 
|alt4=الجانب الأمامي من عملة الدولار الأمريكي، مع صورة واشنطن في المنتصف 
 |عملة دولار أمريكي واحد – التسمية التوضيحية هنا لا تزال مقيدة بمعلمة العرض.
|File:George Washington Presidential $1 Coin obverse.png
|alt5=عملة ذهبية مع تمثال نصفي لواشنطن باتجاه اليسار
 |واشنطن على [[عملة الدولار (الولايات المتحدة)|عملة الدولار]]
}}

== بيانات القالب ==
<templatedata>
{
	"params": {
		"title": {
			"label": "title",
			"description": "عنوان للمعرض العام",
			"example": "صور الدجاج",
			"type": "string",
			"suggested": true
		},
		"align": {
			"label": "align",
			"description": "محاذاة المعرض على الصفحة؛ تشمل القيم المحتملة left، right، و center",
			"example": "center",
			"type": "string",
			"default": "left",
			"suggestedvalues": [
				"left",
				"center",
				"right"
			]
		},
		"footer": {
			"label": "footer",
			"description": "إنشاء تذييل يظهر في الركن الأيمن السفلي من المعرض العام، بخط صغير، لأي نص يرغب المحرر في وضعه هناك",
			"example": "Early works",
			"type": "string"
		},
		"style": {
			"label": "CSS styling",
			"description": "يسمح بإضافة تصميم Cascading Style Sheets المخصص إلى قالب المعرض.",
			"example": "border: 1px solid black;",
			"type": "string"
		},
		"captionstyle": {
			"label": "captionstyle",
			"description": "تسمح هذه المعلمة للمحرر باستخدام تعليمات برمجية Cascading Style Sheet للتسمية التوضيحية"
		},
		"state": {
			"label": "state",
			"description": "تسمح هذه المعلمة للمحرر بتحديد ما إذا كان المعرض سيظهر في البداية إما موسعًا أو مصغرًا للقراء أم لا",
			"example": "collapsed",
			"type": "string",
			"default": "expanded",
			"suggestedvalues": [
				"expanded",
				"collapsed"
			]
		},
		"height": {
			"label": "height",
			"description": "يحدد الحد الأقصى للارتفاع لأي صورة داخل المعرض",
			"example": "100",
			"type": "number",
			"default": "180"
		},
		"width": {
			"label": "width",
			"description": "مماثلة لمعلمة الارتفاع. يحدد الحد الأقصى للعرض لأي صورة في المعرض",
			"example": "120",
			"type": "number",
			"default": "180"
		},
		"mode": {
			"label": "mode",
			"description": "يضبط الوضع الذي تستخدمه علامة المعرض الداخلية، راجع مساعدة:وسم المعرض لمزيد من الخيارات",
			"type": "string",
			"default": "traditional",
			"suggestedvalues": [
				"traditional",
				"nolines",
				"packed",
				"packed-overlay",
				"packed-hover",
				"slideshow"
			]
		},
		"noborder": {
			"label": "noborder",
			"description": "قم بإلغاء الحدود المحيطة بالصور",
			"example": "yes",
			"type": "string",
			"default": "no"
		},
		"whitebg": {
			"description": "يستخدم لتعطيل الخلفية البيضاء في علامة المعرض الداخلية",
			"example": "no",
			"type": "boolean",
			"default": "yes"
		}
	},
	"description": "ضع هذا القالب على مقالة أو صفحة مستخدم لإنشاء معرض للصور على تلك الصفحة بالإضافة إلى التسميات التوضيحية. يمكن لأي شخص وضع هذا القالب."
}
</templatedata>

== تصانيف التتبع ==
* {{سطر تصنيف وصفحاته|صفحات تستخدم معرض الصور بمعلمة نمط التسمية التوضيحية}}
* {{سطر تصنيف وصفحاته|صفحات تستخدم معرض الصور بمعلمات غير معروفة}}

== انظر أيضًا ==
* [[مساعدة:Gallery tag]]
* {{قا|تهذيب معرض صور}}، لوسم على معارض الصور غير الموسوعية
* {{قا|Gallery layout}}، لتطبيق تخطيط بنمط المعرض على كتل المحتوى العشوائية مثل إخراج القالب
* {{قا|Gallery items}}
* {{قا|Image array}}
* {{قا|إطار صورة}}
* {{قا|عدة صور}}
* {{قا|توليف صورة}}
* {{قا|Stack}}، حيث يمكن تكديس الصور وما إلى ذلك على الجانب الأيمن لتجنب مشاكل التباعد والعائمة

<includeonly>{{ملعب آخر| 
| <!-- التصانيف هنا، ووصلات الانترويكي في ويكي بيانات  -->
[[تصنيف:قوالب تنسيق وتوظيف الصور]]

}}</includeonly>