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

هذا القالب مستخدم في عدد كبير من الصفحات .
لتفادي خلق بلبلة على نطاق واسع من الصفحات وزيادة الأعباء على الخوادم، يجب تجربة أي تعديل في هذه الصفحات الفرعية /ملعب أو /تجربة أو في ملعبك. بعدها يمكنك اضافة التعديلات دفعة واحدة، ورجاءً، لا تنسَ مناقشة أمر التعديلات أوّلًا قبل القيام بها.

هذه صفحة توثيق قالب:معرض الصور الفرعية، لشرح القالب وتصنيفه، وهي لا تدخل في استخدامه.

هذا القالب يستعمل لوا:

وحدة:Gallery

يوفر هذا القالب وظيفة متقدمة لبناء معرض (مع التحكم الدقيق في التنسيق). لإنشاء معارض عامة، استخدم وسم معرض الصور ^{[لغات أخرى]}‏.

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

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

جميع معلمات القالب فارغة

{{معرض الصور
| 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=
}}

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

لكل صورة

حدد سطرًا من النموذج التالي لكل صورة.

|File:Filename |Caption |altn=alternative text

لاحظ أن اسم الملف والتسمية التوضيحية لا يحتاجان إلى أسماء معلمات، ولكن يجب أن تكون كل معلمة نص بديل مسبوقة بـ |altn=.

أين:

|File:Filename – اسم ملف الصورة. أيضاً File: أو Image: يمكن استخدام البادئة

|Caption – التسمية التوضيحية تحت الصورة؛ انظر ويكيبيديا:Manual of Style/Captions

|altn= – alt attribute: |alt1= بالنسبة للصورة الأولى، |alt2= للصورة الثانية وهكذا

alternative text – نص بديل للصورة، يستخدم من قبل ضعاف البصر أو القراء الآخرين الذين لا يستطيعون رؤية الصورة بوضوح. إذا تم حذفه، فسيكون النص البديل للصورة فارغًا.

المعلمات الاختيارية

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

|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= تم ضبطها على نفس القيمة.

أمثلة

{{معرض الصور
|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=عملة ذهبية مع تمثال نصفي لواشنطن في اتجاه اليسار بقليل
}}

تصوير ثقافي عن جورج واشنطن

تمثال واشنطن خارج النصب التذكاري الوطني للقاعة الفيدرالية في مدينة نيويورك، ويطل على وول ستريت
بناء صورة واشنطن في جبل رشمور، ج. 1932
يتم إحياء ذكرى واشنطن على ربع دولار.
واشنطن على عملة الدولار

{{معرض الصور
|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=عملة ذهبية مع تمثال نصفي لواشنطن باتجاه اليسار
}}

تصوير ثقافي عن جورج واشنطن

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

تصوير ثقافي عن جورج واشنطن

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

بيانات القالب

ضع هذا القالب على مقالة أو صفحة مستخدم لإنشاء معرض للصور على تلك الصفحة بالإضافة إلى التسميات التوضيحية. يمكن لأي شخص وضع هذا القالب.

وسائط القالب[تحرير بيانات القالب]
وسيط		وصف	نوع	حالة
title	`title`	عنوان للمعرض العام مثال صور الدجاج	نص	مقترح
align	`align`	محاذاة المعرض على الصفحة؛ تشمل القيم المحتملة left، right، و center القيم المقترحة `left` `center` `right` غيابي left مثال center	نص	اختياري
footer	`footer`	إنشاء تذييل يظهر في الركن الأيمن السفلي من المعرض العام، بخط صغير، لأي نص يرغب المحرر في وضعه هناك مثال Early works	نص	اختياري
CSS styling	`style`	يسمح بإضافة تصميم Cascading Style Sheets المخصص إلى قالب المعرض. مثال border: 1px solid black;	نص	اختياري
captionstyle	`captionstyle`	تسمح هذه المعلمة للمحرر باستخدام تعليمات برمجية Cascading Style Sheet للتسمية التوضيحية	غير معروف	اختياري
state	`state`	تسمح هذه المعلمة للمحرر بتحديد ما إذا كان المعرض سيظهر في البداية إما موسعًا أو مصغرًا للقراء أم لا القيم المقترحة `expanded` `collapsed` غيابي expanded مثال collapsed	نص	اختياري
height	`height`	يحدد الحد الأقصى للارتفاع لأي صورة داخل المعرض غيابي 180 مثال 100	رقم	اختياري
width	`width`	مماثلة لمعلمة الارتفاع. يحدد الحد الأقصى للعرض لأي صورة في المعرض غيابي 180 مثال 120	رقم	اختياري
mode	`mode`	يضبط الوضع الذي تستخدمه علامة المعرض الداخلية، راجع مساعدة:وسم المعرض لمزيد من الخيارات القيم المقترحة `traditional` `nolines` `packed` `packed-overlay` `packed-hover` `slideshow` غيابي traditional	نص	اختياري
noborder	`noborder`	قم بإلغاء الحدود المحيطة بالصور غيابي no مثال yes	نص	اختياري
whitebg	`whitebg`	يستخدم لتعطيل الخلفية البيضاء في علامة المعرض الداخلية غيابي yes مثال no	بولياني	اختياري

تصانيف التتبع

انظر أيضًا

مساعدة:Gallery tag
{{تهذيب معرض صور}} – لوسم على معارض الصور غير الموسوعية
{{Gallery layout}} – لتطبيق تخطيط بنمط المعرض على كتل المحتوى العشوائية مثل إخراج القالب
{{عناصر معرض الصور}}
{{مصفوفة الصور}}
{{إطار صورة}}
{{عدة صور}}
{{توليف صورة}}
{{تكديس}} – حيث يمكن تكديس الصور وما إلى ذلك على الجانب الأيمن لتجنب مشاكل التباعد والعائمة
قالب:عدة صور