الگو:نگارخانه

از ویکی‌پدیا، دانشنامهٔ آزاد
توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

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

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

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

نحو خالی[ویرایش]

{{نگارخانه
| عنوان       = 
| تراز        =
| پاورقی      =
| سبک         =
| جمع‌شوندگی   =
| ارتفاع      =
| عرض         =
| سبک زیرنویس =
| پرونده:
 | جایگزین۱ =
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۲=
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۳=
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۴=
 | متن زیرنویس در اینجا
| پرونده:
 | جایگزین۵=
 | متن زیرنویس در اینجا
}}

پارامترها[ویرایش]

برای هر یک از تصاویر[ویرایش]

برای هر تصویر، یک سطر با قالب زیر تعریف کنید.

|پرونده:نام پرونده |جایگزینn=متن جایگزین |زیرنویس تصویر

در قالب فوق:

|پرونده:نام پرونده – نام پروندهٔ تصویر. از هر یک از پیشوندهای File: یا پرونده: می‌توان استفاده کرد
|جایگزینn= یا |Altn=ویژگی alt: |جایگزین۱= (با رقم فارسی) یا |alt1= برای تصویر اول، |جایگزین۲= یا |alt2= برای تصویر دوم و غیره.
متن جایگزینمتن جایگزین برای تصویر، برای استفاده توسط افراد کم‌بینا یا سایر مخاطبانی که قادر به دیدن تصویر به‌صورت واضح و شفاف نیستند. اگر این پارامتر خال گذاشته‌شود، متن جایگزین تصویر خالی خواهد بود.
|زیرنویس تصویر – توضیحات زیرنویس در زیر تصویر؛ ویکی‌پدیا:شیوه‌نامه/زیرنویس تصویر را ببینید

پارامترهای اختیاری[ویرایش]

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

|عنوان= یا |title= – عنوانی برای نگارخانه
|تراز= یا |align= – تراز نگارخانه در صفحه، left (پیش‌فرض)، center، یا right؛ مقدارها حتماً باید به انگلیسی وارد شوند؛ چرا که مقدار این پارامتر مستقیماً در ویژگی‌های سی‌اس‌اس نگارخانه مورد استفاده قرار می‌گیرد. در صورت وارد کردن پارامتر |جمع‌شوندگی=، از این پارامتر چشم‌پوشی می‌شود.
|پاورقی= یا |footer= – متن کوچک و ترازشده در چپ، زیر تصاویر
|سبک= یا |style= – دستورات سبک سی‌اس‌اس برای کل نگارخانه (راهنما:شیوه‌نامه‌های آبشاری را ببینید)
|جمع‌شوندگی= یا |state= – حالت پیش‌فرض نگارخانه‌های جمع‌شونده (تاشو) را تنظیم می‌کند؛ از پارامترهای |جمع‌شوندگی=expanded یا |جمع‌شوندگی=collapsed استفاده کنید؛ (مقدارها باید انگلیسی باشند) نگارخانه‌های تاشو کل عرض صفحه را اشغال می‌کنند
|حالت= یا |mode= – حالت مورد استفادهٔ برچسب نگارخانهٔ داخلی را تنظیم می‌کند. مقدارهای معمول شامل |حالت=packed و |حالت=nolines می‌شوند (برای کسب اطلاعات و مشاهدهٔ گزینه‌های بیشتر، ویکی‌پدیا:نگارخانه را ببینید؛ مقدارهای این پارامتر حتماً باید به انگلیسی وارد شوند)

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

|بی‌قاب= یا |noborder= – لغو حاشیهٔ دور تصاویر؛ برای تنظیم آن از |بی‌قاب=بله استفاده کنید.
|پس‌زمینه سفید= یا |whitebg= – لغو پس‌زمینه‌های سفید در پشت تصاویر؛ برای تنظیم آن از |پس‌زمینه سفید=نه استفاده کنید.
|ارتفاع= یا |height= – بیشینهٔ ارتفاع هر یک از تصاویر. اگر این پارامتر وارد نشده‌باشد، |ارتفاع= به‌طور پیش‌فرض بر روی ۱۸۰ پیکسل تنظیم می‌شود. در این پارامتر از یک عدد ساده نظیر ۲۰۰ بدون تعیین واحد مانند 200px استفاده کنید. این پارامتر هم ارقام فارسی را می‌پذیرد و هم ارقام انگلیسی.
|عرض= یا |width= – بیشینهٔ عرض هر یک از تصاویر که به‌طور پیش‌فرض روی ۱۸۰ پیکسل تنظیم شده‌است. در این پارامتر از یک عدد ساده نظیر ۲۰۰ بدون تعیین واحد مانند 200px استفاده کنید. این پارامتر هم ارقام فارسی را می‌پذیرد و هم ارقام انگلیسی.
|سبک زیرنویس= یا |captionstyle= – دستورات سبک سی‌اس‌اس برای توضیح زیر تصاویر (راهنما:شیوه‌نامه‌های آبشاری را ببینید)

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

نمونه‌ها[ویرایش]

{{نگارخانه
|عنوان=نجسم‌های فرهنگی از جورج واشینگتن
|عرض=۱۶۰ | ارتفاع=۱۷۰
|تراز=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)|سکهٔ دلار]]
}}
{{نگارخانه
|عنوان=نجسم‌های فرهنگی از جورج واشینگتن
|عرض=۱۲۰ | ارتفاع=۱۰۰
|تراز=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)|سکهٔ دلار]]
}}

الگوداده[ویرایش]

این توضیحاتِ داده‌های الگو این الگو است که توسط ویرایشگر دیداری و دیگر ابزارها استفاده می‌شود.

نگارخانه

برای ایجاد نگارخانه‌ای از تصاویر به‌همراه زیرنویس در صفحه‌ها، این الگو را در مقاله‌ها یا صفحه‌های کاربری قرار دهید. هر کاربری می‌تواند از این الگو استفاده کند.

پارامترهای الگو

پارامترتوضیحاتنوعوضعیت
عنوانعنوان title

عنوان کل نگارخانه

مثال
تصاویری از مرغ‌ها
رشتهپیشنهادشده
ترازتراز align

تراز نگارخانه در صفحه؛ مقدارهای مجاز شامل left، right و center می‌شوند. مقدارهای فارسی مجاز نیستند.

مقدارهای پیشنهادی
left center right
پیش‌فرض
right
مثال
center
رشتهاختیاری
پاورقیپاورقی footer

یک پاورقی ایجاد می‌کند که پایین، سمت چپ کل نگارخانه، با فونت کوچک نمایش داده می‌شود.

مثال
آثار اولیه
رشتهاختیاری
سبکسبک style

این پارامتر امکان به‌کار گرفتن کدهای شیوه‌نامه‌های آبشاری (CSS) را برای ویرایشگر فراهم می‌کند.

ناشناختهاختیاری
سبک توضیح تصویرسبک زیرنویس captionstyle

این پارامتر امکان به‌کار گرفتن کدهای شیوه‌نامه‌های آبشاری (CSS) برای شبک‌بندی زیرنویس تصاویر را برای ویرایشگر فراهم می‌کند.

ناشناختهاختیاری
جمع‌شوندگیجمع‌شوندگی state

این پارامتر امکان تعیین این که نگارخانه در ابتدا در حالت تاشده یا گسترده به مخاطب نمایش داده‌شود را برای ویرایشگر فراهم می‌کند. مقدارهای این پارامتر حتماً باید انگلیسی باشند و مقدارهای فارسی مجاز نیستند.

مقدارهای پیشنهادی
expanded collapsed
پیش‌فرض
expanded
مثال
collapsed
رشتهاختیاری
ارتفاعارتفاع height

تعیین حداکثر ارتفاع تمامی تصاویر موجود در نگارخانه

پیش‌فرض
۱۸۰
مثال
۱۰۰
رشتهاختیاری
عرضعرض width

مشابه پارامتر ارتفاع؛ تعیین عرض تمامی تصاویر موجود در نگارخانه

پیش‌فرض
۱۸۰
مثال
۱۲۰
رشتهاختیاری
حالتحالت mode

حالت مورد استفاده توسط برچسب نگارخانهٔ داخلی را تنظیم می‌کند برای کسب اطلاعات و مشاهدهٔ گزینه‌های بیشتر، ویکی‌پدیا:نگارخانه را ببینید. مقدارهای فارسی برای این پارامتر مجاز نیستند.

مقدارهای پیشنهادی
traditional nolines packed packed-overlay packed-hover slideshow
پیش‌فرض
traditional
رشتهاختیاری
بی‌قاببی‌قاب noborder

عدم استفاده از قاب در اطراف تصاویر

مقدارهای پیشنهادی
بله yes y true
پیش‌فرض
خیر
مثال
بله
رشتهاختیاری
پس‌زمینه سفیدپس‌زمینه سفید whitebg

برای غیرفعال‌سازی پس‌زمینهٔ سفید در برچسب نگارخانهٔ داخلی کاربرد دارد. مقدارهای فارسی مجاز نیستند.

پیش‌فرض
yes
مثال
no
رشتهاختیاری

رده‌های ردیابی[ویرایش]

جستارهای وابسته[ویرایش]