در حال ویرایش الگو:Gallery/توضیحات

{{زیرصفحه توضیحات}}
{{لوآ|Module:Gallery}}

{{برای|the cleanup tag|Template:Cleanup-gallery}}

This template provides advanced gallery building functionality (such as scrolling captions and fine-tuned formatting control). For creating basic galleries, use the [[ویکی‌پدیا:نگارخانه]].

This template displays a gallery of images in an array, left-to-right in rows.  Global parameters {{پارا|width}} and {{پارا|height}} control the size of all images in the gallery unless overridden by an image's {{پارا|width''n''}} parameter. The number of images per row is based upon the image width parameters and the width of the screen. The number of images per row can change when the user resizes the window.

For style guidelines about where galleries are appropriate, see §[[ویکی‌پدیا:سیاست استفاده از تصاویر]] of Wikipedia's [[ویکی‌پدیا:سیاست استفاده از تصاویر]].

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

=== برای هر نگاره ===

Specify a line of the following form for each image.
: <code>|File:''Filename''</code> {{پارا|alt''n''|''Alt text''}} <code>|''Caption''</code>

Where:
: <code>|File:''Filename''</code> – the image's file name. Either <code>File:</code> or <code>Image:</code> prefix may be used
: {{پارا|Alt''n''}} – [[alt attribute]]: {{پارا|alt1}} for the first image, {{پارا|alt2}} for the second image, etc
:: <code>''Alt text''</code> – the [[ویکی‌پدیا:متن جایگزین برای تصاویر]] for the image, used by visually impaired or other readers who cannot see the image clearly. If omitted, the image's alt text will be blank.
: <code>|''Caption''</code> – the caption under the image; see [[Wikipedia:Manual of Style/Captions]]

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

These parameters apply to the gallery:

: {{پارا|title}} – The gallery's title
: {{پارا|align}} – The alignment of the gallery on the page, left (default), center, or right; ignored when {{پارا|state}} is set
: {{پارا|footer}} – Small, right-aligned text below the images
: {{پارا|style}} – [[شیوه‌نامهٔ آبشاری]] style directives for the whole gallery (see [[Help:Cascading Style Sheets]])
: {{پارا|state}} – Sets the default state of collapsible galleries; use {{پارا|state|expanded}} or {{پارا|state|collapsed}}; collapsible galleries occupy the full page width

These parameters apply to all of the images in the gallery:

: {{پارا|height}} – Maximum height of each image. If this parameter is not included, {{پارا|height}} defaults to 180 pixels.
: {{پارا|width}} – Maximum width of each image, default is 180 pixels.
: {{پارا|cellwidth}} – Width of each image cell or box, default is {{پارا|width}}). If specified, {{پارا|cellwidth}} overrides any value specified with {{پارا|width}}.
: {{پارا|lines}} – The number of text lines needed for the largest caption (default: 2 lines).

The image's original ratio of width to height cannot be modified by {{پارا|width}} or {{پارا|height}} – a rectangular image will not be made square if {{پارا|width}} and {{پارا|height}} are set to the same value.

These parameters apply to each image, separately:

: {{پارا|width''n''}} (where <code>''n''</code> is a number) – specifies the width of <code>image ''n''</code> when it needs to be different from the value specified by {{پارا|width}}

Note that making an image wider with the {{پارا|width''n''}} parameter does not produce a wider caption, which will still be constrained by the {{پارا|width}} parameter.

== مثال ==
{{Pre2|scroll|<nowiki>{{Gallery
|title=Cultural depictions of George Washington
|width=160 | height=170 | lines=4
|align=center
|footer=Example 1
|File:Federal Hall NYC 27.JPG |
 alt1=Statue facing a city building with Greek columns and huge U.S. flag
 |Statue of Washington outside [[Federal Hall]] in [[نیویورک]], looking on [[وال استریت]]
|File:Mount Rushmore2.jpg |
 alt2=Profile of stone face on mountainside, with 3 workers.
 |Construction of Washington portrait at [[کوه راشمور]], c. 1932
|File:2006 Quarter Proof.png |
 alt3=Shiny silver coin with profile of Washington bust. 
 |Washington is commemorated on a [[کوارتر (سکه آمریکا)]].
|File:George Washington Presidential $1 Coin obverse.png |
 alt4=Gold coin with bust of Washington facing slightly left
 |Washington on a [[dollar coin (United States)|dollar coin]]
}}</nowiki>}}
{{Gallery
|title=Cultural depictions of George Washington
|width=160 |height=170 |lines=4
|align=center
|footer=Example 1
|File:Federal Hall NYC 27.JPG |
 alt1=Statue facing a city building with Greek columns and huge U.S. flag
 |Statue of Washington outside [[Federal Hall]] in [[نیویورک]], looking on [[وال استریت]]
|File:Mount Rushmore2.jpg |
 alt2=Profile of stone face on mountainside, with 3 workers.
 |Construction of Washington portrait at [[کوه راشمور]], c. 1932
|File:2006 Quarter Proof.png |
 alt3=Shiny silver coin with profile of Washington bust. 
 |Washington is commemorated on a [[کوارتر (سکه آمریکا)]].
|File:George Washington Presidential $1 Coin obverse.png |
 alt4=Gold coin with bust of Washington facing slightly left
 |Washington on a [[dollar coin (United States)|dollar coin]]
}}

{{Pre2|scroll|<nowiki>{{Gallery
|title=Cultural depictions of George Washington
|width=120 |height=100 |lines=4
|align=center
|footer=Example 2a
|File:Federal Hall NYC 27.JPG |
 alt1=Statue facing a city building with Greek columns
 |Statue of Washington outside [[Federal Hall]] in [[نیویورک]], looking on [[وال استریت]]
|File:Mount Rushmore2.jpg |
 alt2=Profile of stone face on mountainside, with 3 workers.
 |Work on Washington portrait at [[کوه راشمور]], c. 1932
|File:2006 Quarter Proof.png |
 alt3=Shiny silver coin with profile of Washington bust. 
 |Washington on a [[کوارتر (سکه آمریکا)]]
|File:United_States_one_dollar_bill,_obverse.jpg | width4=200 |
 alt4=Front side of U.S. dollar bill, with Washington portrait in center.
 |[[اسکناس یک دلاری آمریکا|U.S. one-dollar bill]]
|File:George Washington Presidential $1 Coin obverse.png |
 alt5=Gold coin with bust of Washington facing left
 |Washington on a [[dollar coin (United States)|dollar coin]]
}}</nowiki>}}
{{Gallery
|title=Cultural depictions of George Washington
|width=120 |height=100 |lines=4
|align=center
|footer=Example 2a
|File:Federal Hall NYC 27.JPG |
 alt1=Statue facing a city building with Greek columns
 |Statue of Washington outside [[Federal Hall]] in [[نیویورک]], looking on [[وال استریت]]
|File:Mount Rushmore2.jpg |
 alt2=Profile of stone face on mountainside, with 3 workers.
 |Work on Washington portrait at [[کوه راشمور]], c. 1932
|File:2006 Quarter Proof.png |
 alt3=Shiny silver coin with profile of Washington bust. 
 |Washington on a [[کوارتر (سکه آمریکا)]]
|File:United_States_one_dollar_bill,_obverse.jpg | width4=200 |
 alt4=Front side of U.S. dollar bill, with Washington portrait in center.
 |[[اسکناس یک دلاری آمریکا|U.S. one-dollar bill]]
|File:George Washington Presidential $1 Coin obverse.png |
 alt5=Gold coin with bust of Washington facing left
 |Washington on a [[dollar coin (United States)|dollar coin]]
}}
Note how in the above example, the parameter {{پارا|width4|200}} sets the width of image 4, to allow the dollar-bill image to be wider than the other images in the gallery. However, the width of the caption remains at 120px, as set by the {{پارا|width|120}} parameter.

{{Gallery
|title=Cultural depictions of George Washington
|width=120 |height=100 |lines=4
|align=center
|footer=Example 2b
|File:Federal Hall NYC 27.JPG |
 alt1=Statue facing a city building with Greek columns
 |Statue of Washington outside [[Federal Hall]] in [[نیویورک]], looking on [[وال استریت]]
|File:Mount Rushmore2.jpg |
 alt2=Profile of stone face on mountainside, with 3 workers.
 |Work on Washington portrait at [[کوه راشمور]], c. 1932
|File:2006 Quarter Proof.png |
 alt3=Shiny silver coin with profile of Washington bust. 
 |Washington on a [[کوارتر (سکه آمریکا)]]
|File:United_States_one_dollar_bill,_obverse.jpg | width4=200 |
 alt4=Front side of U.S. dollar bill, with Washington portrait in center 
 |[[اسکناس یک دلاری آمریکا|U.S. one-dollar bill]] – the caption here is still constrained by the width parameter.
|File:George Washington Presidential $1 Coin obverse.png |
 alt5=Gold coin with bust of Washington facing left
 |Washington on a [[dollar coin (United States)|dollar coin]]
}}

==الگوهای وابسته==
* {{الگو|Cleanup-gallery}}, the template marking unencyclopedic image galleries.
* {{الگو|Multiple image}}

<includeonly>
[[رده:الگو:گرافیک]]
</includeonly>