Editing Help:Gallery

Galleries are an image syntax that creates a gallery of thumbnails (or similar image series). The syntax is:

<pre>
<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>
</pre>

Note that the image code is not enclosed in brackets when enclosed in gallery tags. Images can be preceded by '''Image:''', '''File:''' or nothing, however using '''Image:''' is preferred.

Captions are optional, and may contain wiki links or other formatting. Some of the parameters controlling thumb output can also be used here, specifically the ones that modify the file (as opposed to ones that control where in the page the image falls). For example, with multi-paged media like pdfs, you can use code like <code>page=4</code>.

The File: prefix can be omitted. However, it is helpful to include it as an aid for quickly locating image specifiers in the wikitext (for example, when cleaning up page layout).

'''Note that currently we do not support pdfs!'''

For example:
<pre>
<gallery>
File:Wiki.png|Item 1
File:Wiki.png|a link to [[Help:Contents]]
File:Wiki.png
File:Wiki.png|alt=An example image. It has flowers
File:Wiki.png|''italic caption''
Wiki.png|on page "{{PAGENAME}}"
</gallery>
</pre>
is formatted as:
<gallery>
File:Wiki.png|Item 1
File:Wiki.png|a link to [[Help:Contents]]
File:Wiki.png
File:Wiki.png|alt=An example image. It has flowers
File:Wiki.png|''italic caption''
Wiki.png|on page "{{PAGENAME}}"
</gallery>

==Mode parameter==
A mode parameter is available, taking options as follows:
* <code>traditional</code> is the original gallery type used by MediaWiki.
* <code>nolines</code> is similar to <code>traditional</code>, but with no border lines.
* <code>packed</code> causes images to have the same height but different widths, with little space between the images. The rows in this {{wp|Responsive web design|responsive}} mode organize themselves according to the width of the screen.
* <code>packed-overlay</code> shows the caption overlaid on the image, in a semi-transparent white box.
* <code>packed-hover</code> is similar to <code>packed-overlay</code>, but with the caption and box only showing up on hover.
* <code>slideshow</code> creates a slideshow of the images.

==Optional gallery attributes==
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:

<pre>
<gallery {parameters}>
{images}
</gallery>
</pre>

* <code>caption="{caption}"</code>: (caption text between double quotes for more than a word) sets a caption centered atop the gallery. Only plain text may be used in the caption; formatting, templates and the like will not work.
* <code>widths={width}px</code>: sets the (max) widths of the images; the default value is 120px. ''Note the plural: width'''s'''''.
* <code>heights={heights}px</code>: sets the (max) heights of the images; the default value is 120px.
* <code>perrow={integer}</code>: sets the number of images per row. 0 means automatically adjust based on width of screen.
* <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image (1.17+).
* <code>mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}</code>: See section above (1.22+; 1.28+ for "slideshow").
* <code>showthumbnails</code>: For "slideshow" mode only, display the strip with image thumbnails below the slideshow by default (1.29+).

==See also==
* [[mw:Help:Images#Rendering_a_gallery_of_images|Help:Images]] The MediaWiki help page on images

{{Help}}