نمایش مبدأ برای الگو:نگارخانه/توضیحات

{{زیرصفحه توضیحات}}
{{هشدار|پیش از ایجاد نگارخانه، لطفاً '''[[ویکی‌پدیا:سیاست استفاده از تصاویر#نگارخانه|سیاست استفاده از تصاویر برای نگارخانه‌ها]]''' را به‌طور کامل مطالعه کنید. به‌طور کلی، تا زمانی که فضای کافی برای ارائهٔ مؤثر تصاویر در مجاورت متن وجود داشته‌باشد '''نباید از نگارخانه استفاده کرد'''.}}
<!-- لطفاً رده‌ها را در جای مشخص‌شده در پایین این صفحه، و میان‌ویکی‌ها را در ویکی‌داده قرار دهید ([[ویکی‌پدیا:ویکی‌داده]] را ببینید) -->
{{برای|برچسب تمیزکاری نگارخانه|الگو:تمیزکاری نگارخانه}}
{{#اگرمساوی:{{نام‌کامل‌صفحه}}|الگو:نگارخانه|{{پراستفاده|۴۵۰}}}}
{{لوآ|پودمان:Gallery}}
{{الگوسبک|پودمان:Gallery/styles.css}}

این الگو قابلیت‌های پیشرفته به‌منظور ایجاد نگارخانه‌ها (کنترل دقیق قالب‌بندی) را ارائه می‌دهد. برای ایجاد نگارخانه‌های معمولی از [[ویکی‌پدیا:نگارخانه|برچسب نگارخانه]] استفاده کنید.

الن الگو، تصاویر نگارخانه را در قالب یک آرایه به‌صورت ردیفی از راست به چپ نمایش می‌دهد.  پارامترهای سراسری {{پارا|عرض}} و {{پارا|ارتفاع}} اندازهٔ ''تمامی'' تصاویر موجود در نگارخانه را کنترل می‌کنند. تعداد تصاویر در هر ردیف وابسته به پارامترهای عرض تصویر و عرض صفحهٔ نمایش است. در صورت تغییر اندازهٔ پنجره توسط کاربر، ممکن است تعداد تصاویر در هر ردیف تغییر کند.

برای مشاهدهٔ رهنمودهای شیوه‌نامه‌ای پیرامون جای مناسب جهت استفاده از نگارخانه‌ها {{پیوند بخش|ویکی‌پدیا:سیاست استفاده از تصاویر#نگارخانه}} را ببینید.

== نحو خالی ==
{| style="background: transparent;"
|<pre>{{نگارخانه
| عنوان       = 
| تراز        =
| پاورقی      =
| سبک         =
| جمع‌شوندگی   =
| ارتفاع      =
| عرض         =
| سبک زیرنویس =
| پرونده:
 | جایگزین۱ =
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۲=
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۳=
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۴=
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۵=
 | متن زیرنویس در اینجا
}}</pre>
|}

== پارامترها ==

=== برای هر یک از تصاویر ===

برای هر تصویر، یک سطر با قالب زیر تعریف کنید.
: <code>|پرونده:''نام پرونده''</code> {{پارا|جایگزین''n''|''متن جایگزین''}} <code>|''زیرنویس تصویر''</code>

در قالب فوق:
: <code>|پرونده:''نام پرونده''</code> – نام پروندهٔ تصویر. از هر یک از پیشوندهای <code>File:</code> یا <code>پرونده:</code> می‌توان استفاده کرد
: {{پارا|جایگزین''n''}} یا {{پارا|Alt''n''}} – [[alt attribute|ویژگی alt]]: {{پارا|جایگزین۱}} (با رقم فارسی) یا {{پارا|alt1}} برای تصویر اول، {{پارا|جایگزین۲}} یا {{پارا|alt2}} برای تصویر دوم و غیره.
:: <code>''متن جایگزین''</code> – [[ویکی‌پدیا:متن جایگزین برای تصاویر|متن جایگزین]] برای تصویر، برای استفاده توسط افراد کم‌بینا یا سایر مخاطبانی که قادر به دیدن تصویر به‌صورت واضح و شفاف نیستند. اگر این پارامتر خال گذاشته‌شود، متن جایگزین تصویر خالی خواهد بود.
: <code>|''زیرنویس تصویر''</code> – توضیحات زیرنویس در زیر تصویر؛ [[ویکی‌پدیا:شیوه‌نامه/زیرنویس تصویر]] را ببینید

=== پارامترهای اختیاری ===

این پارامترها بر خود نگارخانه اعمال می‌شوند:

: {{پارا|عنوان}} یا {{پارا|title}} – عنوانی برای نگارخانه
: {{پارا|تراز}} یا {{para|align}} – تراز نگارخانه در صفحه، left (پیش‌فرض)، center، یا right؛ مقدارها حتماً باید به انگلیسی وارد شوند؛ چرا که مقدار این پارامتر مستقیماً در ویژگی‌های [[شیوه‌نامه آبشاری (نگارش سند)|سی‌اس‌اس]] نگارخانه مورد استفاده قرار می‌گیرد. در صورت وارد کردن پارامتر {{پارا|جمع‌شوندگی}}، از این پارامتر چشم‌پوشی می‌شود.
: {{پارا|پاورقی}} یا {{پارا|footer}} – متن کوچک و ترازشده در چپ، زیر تصاویر
: {{پارا|سبک}} یا {{پارا|style}} – دستورات سبک [[شیوه‌نامه آبشاری (نگارش سند)|سی‌اس‌اس]] برای کل نگارخانه ([[راهنما:شیوه‌نامه‌های آبشاری]] را ببینید)
: {{پارا|جمع‌شوندگی}} یا {{پارا|state}} – حالت پیش‌فرض نگارخانه‌های جمع‌شونده (تاشو) را تنظیم می‌کند؛ از پارامترهای {{پارا|جمع‌شوندگی|expanded}} یا {{پارا|جمع‌شوندگی|collapsed}} استفاده کنید؛ (مقدارها باید انگلیسی باشند) نگارخانه‌های تاشو کل عرض صفحه را اشغال می‌کنند
: {{پارا|حالت}} یا {{پارا|mode}} – حالت مورد استفادهٔ برچسب نگارخانهٔ داخلی را تنظیم می‌کند.  مقدارهای معمول شامل {{پارا|حالت|packed}} و {{پارا|حالت|nolines}} می‌شوند (برای کسب اطلاعات و مشاهدهٔ گزینه‌های بیشتر، [[ویکی‌پدیا:نگارخانه]] را ببینید؛ مقدارهای این پارامتر حتماً باید به انگلیسی وارد شوند) 
این پارامترها بر تمامی تصاویر موجود در نگارخانه اعمال می‌شوند:
: {{پارا|بی‌قاب}} یا {{پارا|noborder}} – لغو حاشیهٔ دور تصاویر؛ برای تنظیم آن از {{پارا|بی‌قاب|بله}} استفاده کنید.
: {{پارا|پس‌زمینه سفید}} یا {{پارا|whitebg}} – لغو پس‌زمینه‌های سفید در پشت تصاویر؛ برای تنظیم آن از {{پارا|پس‌زمینه سفید|نه}} استفاده کنید.
: {{پارا|ارتفاع}} یا {{پارا|height}} – بیشینهٔ ارتفاع هر یک از تصاویر. اگر این پارامتر وارد نشده‌باشد، {{پارا|ارتفاع}} به‌طور پیش‌فرض بر روی ۱۸۰ پیکسل تنظیم می‌شود. در این پارامتر از یک عدد ساده نظیر&nbsp;{{xt|۲۰۰}} بدون تعیین واحد مانند&nbsp;{{!xt|200px}} استفاده کنید. این پارامتر هم ارقام فارسی را می‌پذیرد و هم ارقام انگلیسی.
: {{پارا|عرض}} یا {{پارا|width}} – بیشینهٔ عرض هر یک از تصاویر که به‌طور پیش‌فرض روی ۱۸۰ پیکسل تنظیم شده‌است. در این پارامتر از یک عدد ساده نظیر&nbsp;{{xt|۲۰۰}} بدون تعیین واحد مانند&nbsp;{{!xt|200px}} استفاده کنید. این پارامتر هم ارقام فارسی را می‌پذیرد و هم ارقام انگلیسی.
: {{پارا|سبک زیرنویس}} یا {{پارا|captionstyle}} – دستورات سبک [[شیوه‌نامه آبشاری (نگارش سند)|سی‌اس‌اس]] برای توضیح زیر تصاویر ([[راهنما:شیوه‌نامه‌های آبشاری]] را ببینید)

نسبت اولیهٔ عرض به ارتفاع تصویر با استفاده از {{پارا|عرض}} یا {{پارا|ارتفاع}} قابل تغییر نیست – در صورتی که پارامترهای {{پارا|عرض}} و {{پارا|ارتفاع}} هر دو بر روی یک مقدار یکسان تنظیم شوند، باعث تبدیل یک تصویر مستطیل‌شکل به یک تصویر مربعی نخواهند شد.

== نمونه‌ها ==
{{pre2|scroll|<nowiki>{{نگارخانه
|عنوان=نجسم‌های فرهنگی از جورج واشینگتن
|عرض=۱۶۰ | ارتفاع=۱۷۰
|تراز=center
|پاورقی=نمونهٔ شمارهٔ ۱
|پرونده:Federal Hall NYC 27.JPG 
 |جایگزین۱=یک مجسمه رو به یک ساختمان شهری به‌همراه ستون‌های یونانی و پرچم بسیار بزرگ ایالات متحده آمریکا
 |مجسمهٔ واشینگتن در خارج [[Federal Hall National Memorial|یادوارهٔ ملی تالار فدرال]] در [[نیویورک]]، ناظر بر [[وال استریت]]
|پرونده:Mount Rushmore2.jpg 
 |جایگزین۲=نیمرخ یک صورت تراشیده‌شده بر سنگ در دیوارهٔ کوهستان، همراه با چهار کارگر.
 |احداث پرترهٔ واشینگتن در [[کوه راشمور]]، ۱۹۳۲
|پرونده:2006 Quarter Proof.png 
 |جایگزین۳=سکهٔ براق نقره با نیمرخ نیم‌تنهٔ واشینگتن. 
 |یادبود واشینگتن بر روی یک سکهٔ [[کوارتر (سکه آمریکا)|کوارتر]].
|پرونده:George Washington Presidential $1 Coin obverse.png 
 |جایگزین ۴=سکهٔ طلا با نیم‌تنهٔ واشینگتن که کمی به چپ متمایل است
 |واشینگتن بر روی یک [[dollar coin (United States)|سکهٔ دلار]]
}}</nowiki>}}
{{نگارخانه
|عنوان=نجسم‌های فرهنگی از جورج واشینگتن
|عرض=۱۶۰ | ارتفاع=۱۷۰
|تراز=center
|پاورقی=نمونه ۱
|پرونده:Federal Hall NYC 27.JPG 
 |جایگزین۱=یک مجسمه رو به یک ساختمان شهری به‌همراه ستون‌های یونانی و پرچم بسیار بزرگ ایالات متحده آمریکا
 |مجسمهٔ واشینگتن در خارج [[Federal Hall National Memorial|یادوارهٔ ملی تالار فدرال]] در [[نیویورک]]، ناظر بر [[وال استریت]]
|پرونده:Mount Rushmore2.jpg 
 |جایگزین۲=نیمرخ یک صورت تراشیده‌شده بر سنگ در دیوارهٔ کوهستان، همراه با چهار کارگر.
 |احداث پرترهٔ واشینگتن در [[کوه راشمور]]، ۱۹۳۲
|پرونده:2006 Quarter Proof.png 
 |جایگزین۳=سکهٔ براق نقره با نیمرخ نیم‌تنهٔ واشینگتن. 
 |یادبود واشینگتن بر روی یک سکهٔ [[کوارتر (سکه آمریکا)|کوارتر]].
|پرونده:George Washington Presidential $1 Coin obverse.png 
 |جایگزین۴=سکهٔ طلا با نیم‌تنهٔ واشینگتن که کمی به چپ متمایل است
 |واشینگتن بر روی یک [[dollar coin (United States)|سکهٔ دلار]]
}}

{{pre2|scroll|<nowiki>{{نگارخانه
|عنوان=نجسم‌های فرهنگی از جورج واشینگتن
|عرض=۱۲۰ | ارتفاع=۱۰۰
|تراز=center
|پاورقی=نمونه ۲آ
|پرونده:Federal Hall NYC 27.JPG 
 |جایگزین۱=یک مجسمه رو به یک ساختمان شهری به‌همراه ستون‌های یونانی و پرچم بسیار بزرگ ایالات متحده آمریکا
 |مجسمهٔ واشینگتن در خارج [[Federal Hall National Memorial|یادوارهٔ ملی تالار فدرال]] در [[نیویورک]]، ناظر بر [[وال استریت]]
|پرونده:Mount Rushmore2.jpg 
 |جایگزین۲=نیمرخ یک صورت تراشیده‌شده بر سنگ در دیوارهٔ کوهستان، همراه با چهار کارگر.
 |احداث پرترهٔ واشینگتن در [[کوه راشمور]]، ۱۹۳۲
|پرونده:2006 Quarter Proof.png 
 |جایگزین۳=سکهٔ براق نقره با نیمرخ نیم‌تنهٔ واشینگتن. 
 |یادبود واشینگتن بر روی یک سکهٔ [[کوارتر (سکه آمریکا)|کوارتر]].
|پرونده:United_States_one_dollar_bill,_obverse.jpg
 |جایگزین۴=طرف جلویی اسکناس دلار آمریکا، به‌همراه پرترهٔ جورج واشینگتن بر در وسط آن.
 |[[اسکناس یک دلاری آمریکا]]
|پرونده:George Washington Presidential $1 Coin obverse.png
 |جایگزین۵=سکهٔ طلا با نیم‌تنهٔ واشینگتن که کمی به چپ متمایل است
 |واشینگتن بر روی یک [[dollar coin (United States)|سکهٔ دلار]]
}}</nowiki>}}
{{نگارخانه
|عنوان=نجسم‌های فرهنگی از جورج واشینگتن
|عرض=۱۲۰ | ارتفاع=۱۰۰
|تراز=center
|پاورقی=نمونه ۲آ
|پرونده:Federal Hall NYC 27.JPG 
 |جایگزین۱=یک مجسمه رو به یک ساختمان شهری به‌همراه ستون‌های یونانی و پرچم بسیار بزرگ ایالات متحده آمریکا
 |مجسمهٔ واشینگتن در خارج [[Federal Hall National Memorial|یادوارهٔ ملی تالار فدرال]] در [[نیویورک]]، ناظر بر [[وال استریت]]
|پرونده:Mount Rushmore2.jpg 
 |جایگزین۲=نیمرخ یک صورت تراشیده‌شده بر سنگ در دیوارهٔ کوهستان، همراه با چهار کارگر.
 |احداث پرترهٔ واشینگتن در [[کوه راشمور]]، ۱۹۳۲
|پرونده:2006 Quarter Proof.png 
 |جایگزین۳=سکهٔ براق نقره با نیمرخ نیم‌تنهٔ واشینگتن. 
 |یادبود واشینگتن بر روی یک سکهٔ [[کوارتر (سکه آمریکا)|کوارتر]].
|پرونده:United_States_one_dollar_bill,_obverse.jpg
 |جایگزین۴=طرف جلویی اسکناس دلار آمریکا، به‌همراه پرترهٔ جورج واشینگتن بر در وسط آن.
 |[[اسکناس یک دلاری آمریکا]]
|پرونده:George Washington Presidential $1 Coin obverse.png
 |جایگزین۵=سکهٔ طلا با نیم‌تنهٔ واشینگتن که کمی به چپ متمایل است
 |واشینگتن بر روی یک [[dollar coin (United States)|سکهٔ دلار]]
}}

{{نگارخانه
|عنوان=نجسم‌های فرهنگی از جورج واشینگتن
|عرض=۱۲۰ | ارتفاع=۱۰۰
|تراز=center
|پاورقی=نمونه ۲ب
|پرونده:Federal Hall NYC 27.JPG 
 |جایگزین۱=یک مجسمه رو به یک ساختمان شهری به‌همراه ستون‌های یونانی و پرچم بسیار بزرگ ایالات متحده آمریکا
 |مجسمهٔ واشینگتن در خارج [[Federal Hall National Memorial|یادوارهٔ ملی تالار فدرال]] در [[نیویورک]]، ناظر بر [[وال استریت]]
|پرونده:Mount Rushmore2.jpg 
 |جایگزین۲=نیمرخ یک صورت تراشیده‌شده بر سنگ در دیوارهٔ کوهستان، همراه با چهار کارگر.
 |احداث پرترهٔ واشینگتن در [[کوه راشمور]]، ۱۹۳۲
|پرونده:2006 Quarter Proof.png 
 |جایگزین۳=سکهٔ براق نقره با نیمرخ نیم‌تنهٔ واشینگتن. 
 |یادبود واشینگتن بر روی یک سکهٔ [[کوارتر (سکه آمریکا)|کوارتر]].
|پرونده:United_States_one_dollar_bill,_obverse.jpg
 |جایگزین۴=طرف جلویی اسکناس دلار آمریکا، به‌همراه پرترهٔ جورج واشینگتن بر در وسط آن.
 |[[اسکناس یک دلاری آمریکا]] – این زیرنویس همچنان توسط پارامتر عرض محدود شده‌است
|پرونده:George Washington Presidential $1 Coin obverse.png
 |جایگزین۵=سکهٔ طلا با نیم‌تنهٔ واشینگتن که کمی به چپ متمایل است
 |واشینگتن بر روی یک [[dollar coin (United States)|سکهٔ دلار]]
}}

==الگوداده==
{{سرآیند الگوداده}}
<templatedata>
{
	"params": {
		"عنوان": {
			"aliases": [
				"title"
			],
			"label": "عنوان",
			"description": "عنوان کل نگارخانه",
			"example": "تصاویری از مرغ‌ها",
			"type": "string",
			"suggested": true
		},
		"تراز": {
			"aliases": [
				"align"
			],
			"label": "تراز",
			"description": "تراز نگارخانه در صفحه؛ مقدارهای مجاز شامل left، right و center می‌شوند. مقدارهای فارسی مجاز نیستند.",
			"example": "center",
			"type": "string",
			"suggestedvalues": [
				"left",
				"center",
				"right"
			],
			"default": "right"
		},
		"پاورقی": {
			"aliases": [
				"footer"
			],
			"label": "پاورقی",
			"description": "یک پاورقی ایجاد می‌کند که پایین، سمت چپ کل نگارخانه، با فونت کوچک نمایش داده می‌شود.",
			"example": "آثار اولیه",
			"type": "string"
		},
		"سبک": {
			"aliases": [
				"style"
			],
			"label": "سبک",
			"description": "این پارامتر امکان به‌کار گرفتن کدهای شیوه‌نامه‌های آبشاری (CSS) را برای ویرایشگر فراهم می‌کند."
		},
		"سبک زیرنویس": {
			"aliases": [
				"captionstyle"
			],
			"label": "سبک توضیح تصویر",
			"description": "این پارامتر امکان به‌کار گرفتن کدهای شیوه‌نامه‌های آبشاری (CSS) برای شبک‌بندی زیرنویس تصاویر را برای ویرایشگر فراهم می‌کند."
		},
		"جمع‌شوندگی": {
			"aliases": [
				"state"
			],
			"label": "جمع‌شوندگی",
			"description": "این پارامتر امکان تعیین این که نگارخانه در ابتدا در حالت تاشده یا گسترده به مخاطب نمایش داده‌شود را برای ویرایشگر فراهم می‌کند. مقدارهای این پارامتر حتماً باید انگلیسی باشند و مقدارهای فارسی مجاز نیستند.",
			"example": "collapsed",
			"type": "string",
			"suggestedvalues": [
				"expanded",
				"collapsed"
			],
			"default": "expanded"
		},
		"ارتفاع": {
			"aliases": [
				"height"
			],
			"label": "ارتفاع",
			"description": "تعیین حداکثر ارتفاع تمامی تصاویر موجود در نگارخانه",
			"example": "۱۰۰",
			"type": "string",
			"default": "۱۸۰"
		},
		"عرض": {
			"aliases": [
				"width"
			],
			"label": "عرض",
			"description": "مشابه پارامتر ارتفاع؛ تعیین عرض تمامی تصاویر موجود در نگارخانه",
			"example": "۱۲۰",
			"type": "string",
			"default": "۱۸۰"
		},
		"حالت": {
			"aliases": [
				"mode"
			],
			"label": "حالت",
			"description": "حالت مورد استفاده توسط برچسب نگارخانهٔ داخلی را تنظیم می‌کند برای کسب اطلاعات و مشاهدهٔ گزینه‌های بیشتر، ویکی‌پدیا:نگارخانه را ببینید. مقدارهای فارسی برای این پارامتر مجاز نیستند.",
			"type": "string",
			"suggestedvalues": [
				"traditional",
				"nolines",
				"packed",
				"packed-overlay",
				"packed-hover",
				"slideshow"
			],
			"default": "traditional"
		},
		"بی‌قاب": {
			"aliases": [
				"noborder"
			],
			"label": "بی‌قاب",
			"description": "عدم استفاده از قاب در اطراف تصاویر",
			"example": "بله",
			"type": "string",
			"suggestedvalues": [
				"بله",
				"yes",
				"y",
				"true"
			],
			"default": "خیر"
		},
		"پس‌زمینه سفید": {
			"aliases": [
				"whitebg"
			],
			"label": "پس‌زمینه سفید",
			"description": "برای غیرفعال‌سازی پس‌زمینهٔ سفید در برچسب نگارخانهٔ داخلی کاربرد دارد. مقدارهای فارسی مجاز نیستند.",
			"example": "no",
			"type": "string",
			"default": "yes"
		}
	},
	"description": "برای ایجاد نگارخانه‌ای از تصاویر به‌همراه زیرنویس در صفحه‌ها، این الگو را در مقاله‌ها یا صفحه‌های کاربری قرار دهید. هر کاربری می‌تواند از این الگو استفاده کند.",
	"paramOrder": [
		"عنوان",
		"تراز",
		"پاورقی",
		"سبک",
		"سبک زیرنویس",
		"جمع‌شوندگی",
		"ارتفاع",
		"عرض",
		"حالت",
		"بی‌قاب",
		"پس‌زمینه سفید"
	]
}
</templatedata>

== رده‌های ردیابی ==
* {{پیوند رده با شمار|صفحه‌هایی که از نگارخانه با پارامترهای نامعلوم استفاده می‌کنند}}
* {{پیوند رده با شمار|صفحه‌های که از نگارخانه با پارامتر سبک زیرنویس استفاده می‌کنند}}

== جستارهای وابسته ==
* [[ویکی‌پدیا:نگارخانه]]
* {{الگو|تمیزکاری نگارخانه}}، برای برچسب‌زدن نگارخانه‌های تصاویر غیردانشنامه‌ای
* {{tl|Image array}}
* {{tl|Image frame}}
* {{الگو|تصویر چندگانه}}
* {{الگو|فتوکلاژ}}
* {{tl|Stack}}
<includeonly>{{Sandbox other| 
| <!-- لطفاً رده‌ها را زیر این سطر، و میان‌ویکی‌ها را در ویکی‌داده قرار دهید -->
[[رده:الگو:قالب‌بندی و عملکرد تصویر]]

}}</includeonly>