Template:G/doc

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:G.

---

Displays a gallery of files, using just the conventional <gallery> tag,
but with shorter parametrizing and some useful defaults.

Such a gallery can contain one file or more, up to an unlimited number:

• with just {{ G | filename }} a 'gallery' of a single file can be shown,
  
  
• with e.g. {{ G | filename1 | filename2 | ... }} more files are displayed.
  
  

The display format can be influenced by several additional options.

Usage

{{G |1= }}

Template parameters

Parameter	Description		Default	Status
1	(list of) file(s) to be displayed, can be in different ⇒ notations		empty	suggested
f format	one of three values to specify the ⇒ format: 0 or 1 or 2 whether or how the displayed image(s) should be captioned		10(or 2)	optional
m mode	gallery mode, can be specified with t or traditional n or nolines, p or packed, h or packed-hover, o or packed-overlay, s or slideshow when parameter format is not specified, nolines is defaulted		empty nolines	optional
c caption	gallery caption		empty	optional
p perrow	pictures per row		empty	optional
s style	style attributes, e.g. s=float:right		empty	optional
a attr, class	class attributes: any wikimedia class; or the special code "c" (a=c) for a global <center> tag		empty	optional
w widths	width for the displays		empty	optional
h heights	height for the displays		empty	optional
d display	display size; can specify widths and heights		empty	optional
t text	text size; can specify a tag like e.g. "small" or "big"		empty	optional

Additional information

The template is intended to be used in the following namespaces: the File namespace

The template is intended to be used by the following user groups: all users

See also

The (reduced) Gallery Function of Template:{{F}}
Another solution: Template:{{Gallery}}
On meta: m:Help:Images and other uploaded files#Gallery

Localization

This template is not intended to be localized.

The parameter "w", "d", "h"

The display size can be specified with either widths and/or heights, or with display.
While "w" and "h" can specify the number of the pixels, "d" consists of three optional parts: [w] [xh] [px].
"d" is only checked when "w" as well as "h" are not specified.

The parameter "format"

can specify one of three options how naming captions for the single files are displayed:

0. no naming
1. naming with the "showfilename" option
2. naming with the second value of parameter pairs

Note: While options like "showfilename" or "mode=slideshow" are deprecated in namespaces as e.g. articles or galleries, they can be very useful in e.g. file descriptions, or talk pages.

Defaulting the "format"

This parameter is a necessary addition to the parameters used by <gallery>.
When the most frequent invocation form for <gallery> is used, i.e.

• the first parameter is preceded by a linefeed,

• and the second parameter exists,

• and it is separated from the first one by a pipe,

• and it does not also specify a file name

then no format must be specified, "f=2" is assumed, and
the display with {{G| ... }} is the almost same as with <gallery> ... </gallery>.
When not all these requirements are fulfilled, the parameter needs to be specified!
Otherwise a missing format parameter is defaulted with "f=1".

File list notations

The list of the files ("items") for the gallery can be specified in the notation

List 1

{{ G | file1.ext | file2.ext | ... | file_n.ext | more parameters }}

or as a list separated by mandatory linefeeds

List 2

{{ G | 
file1.ext
file2.ext
...
file_n.ext
| more parameters }}

Also a mixture of both notations is possible.

The file names ("items") are specified with unnamed parameters.

With 1=, 2=, 3= up to n= an unlimited number of items can be specified.
Each unnamed parameter (p₁ to p_∞) can contain an unlimited number of linefeed-separated items.

(See also the overview).

For format=2 parameter pairs of file + description must be specified:

List 3

{{ G | file1.ext | description1 | file2.ext | description2 | ... | file_n.ext | description_n |  f = 2 | more parameters }}

This format needs always parameter pairs, but the description may be without value (just a pipe or an empty new line).
When the description is empty, the name of the file is displayed instead; but a description as e.g. &nbsp; will be used!

For format=2 care should be taken when defining the items;

it does not matter whether they are pipe-separated or linefeed-separated, but file names are defined with item₁, item₃, item₅, ... while descriptions are defined with the corresponding item₂, item₄, item₆, ...

Description items can be specified empty, but file name items ought to contain a value.

A good idea for an easy way to read input will be (with the possibility not to need the 'format' parameter)

{{ G | 
file1.ext | name1
file2.ext | name2
...
| more parameters }}

Examples

Shows different parametrizings, and item notations (separation with "pipes" and linefeeds).

Example.png	0 just one file without option parameters {{G| Example.png}} That image can as well be obtained with <gallery mode="nolines" showfilename="yes"> Example.png</gallery>
Example ba.svg Example bn.svg Example de.svg Example en.svg Example ru.svg Example lt.svg Example ro.svg Example tr.svg	0 some files, without option parameters {{G|Example ba.svg|Example de.svg|Example bn.svg|Example de.svg|Example en.svg|Example ru.svg|Example lt.svg|Example ro.svg|Example tr.svg}}
eight smileys	{{G|Day-template.svg Emojione 1F642.svg Emojione BW 1F642.svg Laughing-smiley.svg Noto Emoji Oreo 1f642.svg Noto Emoji Pie 1f642.svg Line-style-icons-happy.svg Nuvola emoticon - happy.svg |c=eight smileys|f=0|w=48|m=n}}
	0 globally centered with a=c {{G|Blue king.svg|Chess kgt45.svg |Chess krt45.svg|Chess kyt45.svg |Green king.svg|Red king.svg |Yellow king.svg|Chess kdt45.svg |f=0|w=80|p=4|a=c}}
pink purple olive yellow blue Black check.svg white green Red check.svg orange green	0 Some descriptions are missing {{G| File:Pink check.svg|pink Purple check.svg|purple Olive green check.svg|{{W|olive}} image:Yellow check.svg|yellow Cornflower blue check.svg|blue Black check.svg| White check.svg|white Green check.svg|green File:Red_check.svg| Orange check.svg|{{W|orange}} Light green check.svg|green |w=96}} 0 the input is easy to read this way 0 (and does not need the 'format' parameter) 0 namespace ("file" or "image") won't disturb
Austria Bulgaria Cyprus Czech Germany Denmark Belgium Estonia Finland Greece Irland Slovenia	0 but not so easy to read that way: {{G|EU-section-with-A.svg|{{W|Austria}}|EU-section-with-BG.svg|{{W|Bulgaria}}|EU-section-with-CY.svg|{{W|Cyprus}} |EU-section-with-CZ.svg|{{W|Czech}}|EU-section-with-D.svg|{{W|Germany}}|EU-section-with-DK.svg|{{W|Denmark}} |EU-section-with-B.svg|{{W|Belgium}}|EU-section-with-EST.svg|{{W|Estonia}}|EU-section-with-FIN.svg|{{W|Finland}} |EU-section-with-GR.svg|{{W|Greece}}|EU-section-with-IRL.svg|{{W|Irland}}|EU-section-with-SLO.svg|{{W|Slovenia}}|f=2|h=80|m=n|t=small}}

URL 1 čeština NRHP 日本語

0 the description can also contain an URL {{G| Structural-Iceberg-ca.svg|{{Plainlinks|http://lightningvolt.com/Image%20Gallery/imagegallery.htm|URL 1}} Structural-Iceberg-cs.svg|{{W|{{#language:cs}}}} Structural-Iceberg.svg|{{Plainlinks|1=https://npgallery.nps.gov/AssetDetail/NRIS/1111|2=NRHP}} Structural-Iceberg-ja.svg|{{#language:ja}} |w=48|m=n}}