Template:Image gallery/doc: Difference between revisions

Latest revision as of 14:09, 26 August 2022

This is a documentation subpage for Template:Image gallery (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

This template shows up to 30 images in an array. The number of images per row is based upon the size specified and the width of the screen, which allows greater flexibility than the <Gallery> tag.

This template is similar to {{Gallery}}, except it does not require a "File:" or "Image:" prefix for image names, and alt text is passed in the second unnamed parameter instead of in a named "altN=" parameter, whereas {{Gallery}} requires both to be prefixed. Both templates use {{Gallery/aux}} to format individual images.

Parameters

Required

|Image|Alt text|Caption: Specify one of these lines for each image. Image is the image name (without any File: or Image: prefix). Alt is the alt text, used by visually impaired readers; it typically has little in common with the caption. Caption is the caption. If no such lines are present, a gallery with a single question-mark image is produced. There is currently a limit of 30 such lines.

Optional

title: The gallery's title.
width: (default 180) Maximum width of each image.
height: (default 180) Maximum height of each image.
lines: (default 2) The number of text lines needed for the largest caption. Blank lines are appended to smaller captions. A caption that does not fit is cut off.
align: (default left) The alignment of the gallery (left, center, or right).

Example

{{Image gallery
|title=Cultural depictions of George Washington
|lines=4
|width=160
|height=140
|Washington-george-general.jpg ||Portrait of General George Washington
|Mount Rushmore2.jpg|Profile of stone face jutting out from a mountainside. Three workers clamber over it, each about the height of the face's upper lip.|Construction on the George Washington portrait at Mount Rushmore, c. 1932.
|George Washington.JPG|George Washington Portrait. |George Washington Portrait.
|Flag of the United States (1777-1795).png||Flag of the United States 1777.
}}

Cultural depictions of George Washington

Portrait of General George Washington

Construction on the George Washington portrait at Mount Rushmore, c. 1932.

George Washington Portrait.

Flag of the United States 1777.

@@ Line 1: / Line 1: @@
 {{Documentation subpage}}
 This template shows up to 30 images in an array. The number of images per row is based upon the size specified and the width of the screen, which allows greater flexibility than the [[Help:Images#Gallery_of_images|<nowiki><Gallery></nowiki>]] tag.
 This template is similar to {{tl|Gallery}}, except it does not require a "<code>File:</code>" or "<code>Image:</code>" prefix for image names, and alt text is passed in the second unnamed parameter instead of in a named "<code>alt''N''=</code>" parameter, whereas {{tl|Gallery}} requires both to be prefixed. Both templates use {{tl|Gallery/aux}} to format individual images.
-== Parameters ==
+== Parameters  ==
-=== Required ===
+=== Required  ===
-; |''Image''|''Alt text''|''Caption'': Specify one of these lines for each image. '''''Image''''' is the image name (without any <code>File:</code> or <code>Image:</code> prefix). '''''Alt''''' is the alt text, used by visually impaired readers; it typically has little in common with the caption. '''''Caption''''' is the caption. If no such lines are present, a gallery with a single question-mark image is produced. There is currently a limit of 30 such lines.
+;|''Image''|''Alt text''|''Caption''
+:Specify one of these lines for each image. '''''Image''''' is the image name (without any <code>File:</code> or <code>Image:</code> prefix). '''''Alt''''' is the alt text, used by visually impaired readers; it typically has little in common with the caption. '''''Caption''''' is the caption. If no such lines are present, a gallery with a single question-mark image is produced. There is currently a limit of 30 such lines.
-=== Optional ===
+=== Optional  ===
-; title: The gallery's title.
+;title
-; width: (default 180) Maximum width of each image.
+:The gallery's title.
-; height: (default 180) Maximum height of each image.
+;width
-; lines: (default 2) The number of text lines needed for the largest caption. Blank lines are appended to smaller captions. A caption that does not fit is cut off.
+:(default 180) Maximum width of each image.
-; align: (default left) The alignment of the gallery (left, center, or right).
+;height
+:(default 180) Maximum height of each image.
+;lines
+:(default 2) The number of text lines needed for the largest caption. Blank lines are appended to smaller captions. A caption that does not fit is cut off.
+;align
+:(default left) The alignment of the gallery (left, center, or right).
-== Example ==
+== Example  ==
 {{pre2|scroll|<nowiki>{{Image gallery
@@ Line 26: / Line 32: @@
 |width=160
 |height=140
-|Federal Hall NYC 27.JPG|Back of statue facing a city building whose facade is Greek columns covered by a huge U.S. flag|The statue of Washington outside [[Federal Hall]] in [[New York City]], looking on [[Wall Street]].
+|Washington-george-general.jpg ||Portrait of General George Washington
-|Mount Rushmore2.jpg|Profile of stone face jutting out from a mountainside. Three workers clamber over it, each about the height of the face's upper lip.|Construction on the George Washington portrait at [[Mount Rushmore]], c. 1932.
+|Mount Rushmore2.jpg|Profile of stone face jutting out from a mountainside. Three workers clamber over it, each about the height of the face's upper lip.|Construction on the George Washington portrait at Mount Rushmore, c. 1932.
-|2006 Quarter Proof.png|Shiny silver coin with profile of Washington bust. He faces left regally and wears a colonial-style queue in his hair. "UNITED STATES OF AMERICA" is at top, "QUARTER DOLLAR" at bottom, "LIBERTY" at left, and "IN GOD WE TRUST" above "S" at right. Just below the bust is "JF uc" in tiny letters.|Washington is commemorated on the [[Quarter (United States coin)|quarter]].
+|George Washington.JPG|George Washington Portrait. |George Washington Portrait.
-|George_Washington_Presidential_$1_Coin_obverse.png|Gold coin with bust of Washington facing slightly left of but looking sternly straight at the viewer. "GEORGE WASHINGTON" is above, "1st PRESIDENT 1789–1797" below, and "JFM" in tiny letters at the bust's base.|Washington is also commemorated on some [[dollar coin (United States)|dollar coins]].
+|Flag of the United States (1777-1795).png||Flag of the United States 1777.
-}}</nowiki>}}
+}}
-{{Image gallery
+</nowiki>}} {{Image gallery
 |title=Cultural depictions of George Washington
 |lines=4
 |width=160
 |height=140
-|Federal Hall NYC 27.JPG|Back of statue facing a city building whose facade is Greek columns covered by a huge U.S. flag|The statue of Washington outside [[Federal Hall]] in [[New York City]], looking on [[Wall Street]].
+|Washington-george-general.jpg ||Portrait of General George Washington
-|Mount Rushmore2.jpg|Profile of stone face jutting out from a mountainside. Three workers clamber over it, each about the height of the face's upper lip.|Construction on the George Washington portrait at [[Mount Rushmore]], c. 1932.
+|Mount Rushmore2.jpg|Profile of stone face jutting out from a mountainside. Three workers clamber over it, each about the height of the face's upper lip.|Construction on the George Washington portrait at Mount Rushmore, c. 1932.
-|2006 Quarter Proof.png|Shiny silver coin with profile of Washington bust. He faces left regally and wears a colonial-style queue in his hair. "UNITED STATES OF AMERICA" is at top, "QUARTER DOLLAR" at bottom, "LIBERTY" at left, and "IN GOD WE TRUST" above "S" at right. Just below the bust is "JF uc" in tiny letters.|Washington is commemorated on the [[Quarter (United States coin)|quarter]].
+|George Washington.JPG|George Washington Portrait. |George Washington Portrait.
-|George_Washington_Presidential_$1_Coin_obverse.png|Gold coin with bust of Washington facing slightly left of but looking sternly straight at the viewer. "GEORGE WASHINGTON" is above, "1st PRESIDENT 1789–1797" below, and "JFM" in tiny letters at the bust's base.|Washington is also commemorated on some [[dollar coin (United States)|dollar coins]].
+|Flag of the United States (1777-1795).png||Flag of the United States 1777.
 }}
-== See also ==
+== See also  ==
-* {{tl|Cleanup-gallery}}, the template marking unencyclopedic image galleries.
-* {{tl|Scroll gallery}}, currently (2-2011) not usable on the English Wikipedia.
+*<nowiki>{{tl|Cleanup-gallery}}</nowiki>, the template marking unencyclopedic image galleries.
+*<nowiki>{{tl|Scroll gallery}}</nowiki>, currently (2-2011) not usable on the English Wikipedia.
 ‎<includeonly>
 [[Category:Graphic templates|{{PAGENAME}}]]
 </includeonly>