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, uses just the gallery tag, with shorter parametrizing and some useful defaults.

Such a gallery can contain one ore more (up to an unlimited number) files.
The display format is supported by several options.

Usage

{{G |1= }}

Template parameters

Parameter	Description		Default	Status
1	(list of) file(s) to be displayed, can be in different notations		empty	optional
f format	one of three values to specify the format, 0 or 1 or 2		1	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	possible style attribute		empty	optional
a attr class	attribute (class)		empty	optional
w widths	width for the displays		empty	optional
h heights	height for the displays		empty	optional
t text	e.g. "small" for lower text size		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}}

Localization

This template is not intended to be localized.

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 (f=1 is also the default)
2. naming with the second value of parameter pairs

File list notations

The list of the files for the gallery can be specified in the format

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 formats 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 newline-separated items.

For format=2 only a variation of the first format ist possible, with parameter pairs of file + description

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 second parameter 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.

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

it does not matter whether they are pipe-separated or newline-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.

Examples

Example.png	just one file without parameters {{G| Example.svg}}
Example ba.svg Example bn.svg Example de.svg Example en.svg Example ru.svg Example lt.svg Example ro.svg Example tr.svg	some files, without 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}}
	{{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 |f=0|w=48|m=n}}
	{{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}}
pink purple olive yellow blue Black check.svg white green Red check.svg orange green	Some descriptions are missing Purple check.svg|purple Olive green check.svg|olive File: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 |f=2|w=96}}
Austria Bulgaria Cyprus Czech Germany Denmark Belgium Estonia Finland Greece Irland Slovenia	{{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=s}}