Template:Multiple image/doc - Revision history

Tonisant: /* Usage */ minor cleanup

2013-08-14T14:08:53Z

Usage: minor cleanup

← Older revision		Revision as of 14:08, 14 August 2013
Line 11:		Line 11:
	* '''width1''' is width of first image. Similarly for '''width2''', etc.		* '''width1''' is width of first image. Similarly for '''width2''', etc.
	** '''width''' overrides width1, width2, width3, etc. If you want the images to be different sizes, do not provide the width parameter.		** '''width''' overrides width1, width2, width3, etc. If you want the images to be different sizes, do not provide the width parameter.
	* '''alt1''' is [[alt text]] of first image (see [[WP:ALT]]). Similarly for '''alt2''', etc.		* '''alt1''' is alt text of first image (see [http://en.wikipedia.org/wiki/Wikipedia:ALT WP:ALT]). Similarly for '''alt2''', etc.
	* '''caption1''' is caption of first image. Similarly for '''caption2''', etc.		* '''caption1''' is caption of first image. Similarly for '''caption2''', etc.
	* '''link1''' is where the first page links to. Similarly for '''link2''', etc. If not specified, image links to the image description page as usual. If specified to the empty value, the image does not link anywhere; this should be used for purely decorative images as per [[WP:ALT]].<br />'''Important''': If the image is under a free license like the GFDL or a CC license, you '''must not''' use this parameter as the terms of those licenses require the license, or a link to it, to be reproduced with the image. The image must, therefore, link to its image page. Public domain and (theoretically) fair use images are not subject to this restriction.		* '''link1''' is where the first page links to. Similarly for '''link2''', etc. If not specified, image links to the image description page as usual. If specified to the empty value, the image does not link anywhere; this should be used for purely decorative images as per [http://en.wikipedia.org/wiki/Wikipedia:ALT WP:ALT].<br />'''Important''': If the image is under a free license like the GFDL or a CC license, you '''must not''' use this parameter as the terms of those licenses require the license, or a link to it, to be reproduced with the image. The image must, therefore, link to its image page. Public domain and (theoretically) fair use images are not subject to this restriction.
	* '''background color''' defines the ~~[[List of colors\|~~background color]] between the border of the box and the images.		* '''background color''' defines the background color between the border of the box and the images.
	* header, footer, background color and captions are optional.		* header, footer, background color and captions are optional.

Tonisant: /* Horizontal placement */ replaced images

2013-08-14T13:45:04Z

Horizontal placement: replaced images

← Older revision		Revision as of 13:45, 14 August 2013
Line 227:		Line 227:
	\| direction = vertical		\| direction = vertical
	\| header = vertical		\| header = vertical
	\| width = 60		\| width = 150

	\| image1 = ~~Ribbon numeral 2~~.~~png~~		\| image1 = CarmeloMuscatCaptainAlbumCover.jpg

	\| image2 = ~~Ribbon numeral 3~~.~~png~~		\| image2 = Athelstone-QuietBeforeTheStorm-coverart2011.jpg

	\| image3 = ~~Ribbon numeral 4~~.~~png~~		\| image3 = Sandro Zerafa-Urban Poetics-cd cover.jpg
	}}		}}
	{{multiple image		{{multiple image
Line 239:		Line 239:
	\| direction = horizontal		\| direction = horizontal
	\| header = horizontal		\| header = horizontal
	\| width = 60		\| width = 150

	\| image1 = ~~Ribbon numeral 2~~.~~png~~		\| image1 = CarmeloMuscatCaptainAlbumCover.jpg

	\| image2 = ~~Ribbon numeral 3~~.~~png~~		\| image2 = Athelstone-QuietBeforeTheStorm-coverart2011.jpg

	\| image3 = ~~Ribbon numeral 4~~.~~png~~		\| image3 = Sandro Zerafa-Urban Poetics-cd cover.jpg
	}}		}}
	~~{{-}}~~
			<br style="clear:both;" />

	However, this will not be apparent if only two images are used, as the template with "direction = horizontal" will place both images on different lines (rows), creating a blank space. Thus [[Template:Double image]] must be used. Similarly, if one wishes to display three images side-by-side on one line, [[Template:Triple image]] must be used.		However, this will not be apparent if only two images are used, as the template with "direction = horizontal" will place both images on different lines (rows), creating a blank space. Thus [[Template:Double image]] must be used. Similarly, if one wishes to display three images side-by-side on one line, [[Template:Triple image]] must be used.

Line 294:		Line 296:
	}}		}}
	</pre>		</pre>
	{{clear}}
			<br style="clear:both;" />

	=== See also ===		=== See also ===

Tonisant: /* Examples */ cleanup and horizonal example

2013-08-14T13:41:11Z

Examples: cleanup and horizonal example

← Older revision		Revision as of 13:41, 14 August 2013
Line 76:		Line 76:
	\| alt2 = Red cartouche		\| alt2 = Red cartouche
	}}</pre>		}}</pre>
	~~{{-}}~~
			<br style="clear:both;" />

	{{multiple image		{{multiple image
Line 107:		Line 108:
	\| caption2 = ...here overlaid onto a checkered background.		\| caption2 = ...here overlaid onto a checkered background.
	}}</pre>		}}</pre>
	~~{{-}}~~
			<br style="clear:both;" />

	{{multiple image		{{multiple image
	\| footer = ~~When a user has many~~ of ~~one type of [[WP:BARN\|barnstar]],~~		\| footer = Here is an eclectic selection of Maltese album covers.
	~~they can represent them with [[WP:RIBBON\|ribbons]]~~		\| width = 150
	~~and these numerals to indicate the count~~.
	\| width = 60

	\| image1 = ~~Ribbon numeral 2~~.~~png~~		\| image1 = CarmeloMuscatCaptainAlbumCover.jpg
	\| alt1 = 2		\| alt1 = The Captain Album by Carmelo Muscat il-Captain

	\| image2 = ~~Ribbon numeral 3~~.~~png~~		\| image2 = Athelstone-QuietBeforeTheStorm-coverart2011.jpg
	\| alt2 = 3		\| alt2 = Quiet Before the Storm by Athelstone

	\| image3 = ~~Ribbon numeral 4~~.~~png~~		\| image3 = Sandro Zerafa-Urban Poetics-cd cover.jpg
	\| alt3 = 4		\| alt3 = Urban Poetics by Sandro Zerafa
	}}		}}
	<pre style="overflow: auto;">		<pre style="overflow: auto;">
	{{multiple image		{{multiple image
	\| footer = ~~When a user has many~~ of ~~one type of [[WP:BARN\|barnstar]],~~		\| footer = Here is an eclectic selection of Maltese album covers.
	~~they can represent them with [[WP:RIBBON\|ribbons]]~~		\| width = 150
	~~and these numerals to indicate the count~~.
	\| width = 60

	\| image1 = ~~Ribbon numeral 2~~.~~png~~		\| image1 = CarmeloMuscatCaptainAlbumCover.jpg
	\| alt1 = 2		\| alt1 = The Captain Album by Carmelo Muscat il-Captain

	\| image2 = ~~Ribbon numeral 3~~.~~png~~		\| image2 = Athelstone-QuietBeforeTheStorm-coverart2011.jpg
	\| alt2 = 3		\| alt2 = Quiet Before the Storm by Athelstone

	\| image3 = ~~Ribbon numeral 4~~.~~png~~		\| image3 = Sandro Zerafa-Urban Poetics-cd cover.jpg
	\| alt3 = 4		\| alt3 = Urban Poetics by Sandro Zerafa
	}}</pre>		}}</pre>
	~~{{-}}~~
			<br style="clear:both;" />

	=== Example with background color ===		=== Example with background color ===

Tonisant: /* Example with background color */ better caption

2013-08-14T13:20:30Z

Example with background color: better caption

← Older revision		Revision as of 13:20, 14 August 2013
Line 150:		Line 150:
	\| alt2=Renato		\| alt2=Renato

	\| footer=Malta's Eurovision Song Contest ~~singers from~~ the 1970s		\| footer=Singer for [[Malta at the Eurovision Song Contest]] in the 1970s
	\| footer_background=#BBDD99		\| footer_background=#BBDD99
	\| background color=#BBDD99		\| background color=#BBDD99
Line 164:		Line 164:
	\| alt2=Renato		\| alt2=Renato

	\| footer=Malta's Eurovision Song Contest ~~singers from~~ the 1970s		\| footer=Singer for [[Malta at the Eurovision Song Contest]] in the 1970s
	\| footer_background=#BBDD99		\| footer_background=#BBDD99
	\| background color=#BBDD99		\| background color=#BBDD99

Tonisant: /* Example with background color */ changed images etc.

2013-08-14T13:16:41Z

Example with background color: changed images etc.

← Older revision		Revision as of 13:16, 14 August 2013
Line 144:		Line 144:
	=== Example with background color ===		=== Example with background color ===
	{{multiple image		{{multiple image
	\| image1=~~Adoxa_moschatellina_210406~~.jpg		\| image1=Joe_Grech.jpg
	\| alt1=~~Green herb with a few tiny yellow-white flowers~~		\| alt1=Joe Grech

	\| image2=~~Adoxa_moschatellina_210406a~~.jpg		\| image2=Renato_Micallef_c1982.jpg
	\| alt2=~~Three small white and yellow flowers before green-leaf background~~		\| alt2=Renato

	~~\| image3=adoxa_moschatellina_blatt.jpeg~~		\| footer=Malta's Eurovision Song Contest singers from the 1970s
	~~\| alt3=Leaves of a plant. They are in groups of three, each with three lobes.~~

	\| footer=~~[[Adoxa]] (''Adoxa moschatellina'~~')
	\| footer_background=#BBDD99		\| footer_background=#BBDD99
	\| background color=#BBDD99		\| background color=#BBDD99
Line 161:		Line 158:
	<pre style="overflow: auto;">		<pre style="overflow: auto;">
	{{multiple image		{{multiple image
	\| image1=~~Adoxa_moschatellina_210406~~.jpg		\| image1=Joe_Grech.jpg
	\| alt1=~~Green herb with a few tiny yellow-white flowers~~		\| alt1=Joe Grech

	~~\| image2=Adoxa_moschatellina_210406a.jpg~~
	~~\| alt2=Three small white and yellow flowers before green-leaf background~~

	\| ~~image3~~=~~adoxa_moschatellina_blatt~~.~~jpeg~~		\| image2=Renato_Micallef_c1982.jpg
	\| ~~alt3~~=~~Leaves of a plant. They are in groups of three, each with three lobes.~~		\| alt2=Renato

	\| footer=~~[[Adoxa]] (~~'~~'Adoxa moschatellina'')~~		\| footer=Malta's Eurovision Song Contest singers from the 1970s
	\| footer_background=#BBDD99		\| footer_background=#BBDD99
	\| background color=#BBDD99		\| background color=#BBDD99

Tonisant: Protected "Template:Multiple image/doc" (‎[edit=sysop] (indefinite) ‎[move=sysop] (indefinite))

2013-07-14T11:42:10Z

Protected "Template:Multiple image/doc" (‎[edit=sysop] (indefinite) ‎[move=sysop] (indefinite))

← Older revision	Revision as of 11:42, 14 July 2013
(No difference)

Tonisant: Created page with "{{Documentation subpage}} This template creates a box with two to ten images arranged vertically or h..."

2013-07-14T11:25:02Z

Created page with "{{Documentation subpage}}  This template creates a box with two to ten images arranged vertically or h..."

New page

{{Documentation subpage}}

This template creates a box with two to ten images arranged vertically or horizontally with captions for the entire box and/or for each images.

=== Usage ===
* '''align''' defaults to "right"
* '''direction''' defaults to "horizontal"
* '''header_align''' defaults to "center"
* '''footer_align''' defaults to "left"
* '''image1''' is name of first image. Similarly for '''image2''', etc.
* '''width1''' is width of first image. Similarly for '''width2''', etc.
** '''width''' overrides width1, width2, width3, etc. If you want the images to be different sizes, do not provide the width parameter.
* '''alt1''' is [[alt text]] of first image (see [[WP:ALT]]). Similarly for '''alt2''', etc.
* '''caption1''' is caption of first image. Similarly for '''caption2''', etc.
* '''link1''' is where the first page links to. Similarly for '''link2''', etc. If not specified, image links to the image description page as usual. If specified to the empty value, the image does not link anywhere; this should be used for purely decorative images as per [[WP:ALT]]. '''Important''': If the image is under a free license like the GFDL or a CC license, you '''must not''' use this parameter as the terms of those licenses require the license, or a link to it, to be reproduced with the image. The image must, therefore, link to its image page. Public domain and (theoretically) fair use images are not subject to this restriction.
* '''background color''' defines the [[List of colors|background color]] between the border of the box and the images.
* header, footer, background color and captions are optional.

<pre style="width: 85%; overflow:auto">
{{multiple image

| align = 
| direction = 
| width = 


| image1 = 
| width1 =
| alt1 =
| caption1 =


| image2 = 
| width2 =
| alt2 =
| caption2 =


| image3 = 
| width3 =
| alt3 =
| caption3 =




| header =
| header_align = 
| header_background =
| footer =
| footer_align = 
| footer_background =
| background color =
}}</pre>

=== Examples ===
{{multiple image
| footer = Players are cautioned with a yellow card and sent off with a red card.
| width = 60

| image1 = Yellow card.svg
| alt1 = Yellow cartouche

| image2 = Red card.svg
| alt2 = Red cartouche
}}
<pre style="overflow: auto;">
{{multiple image
| footer = Players are cautioned with a yellow card and sent off with a red card.
| width = 60

| image1 = Yellow card.svg
| alt1 = Yellow cartouche

| image2 = Red card.svg
| alt2 = Red cartouche
}}</pre>
{{-}}

{{multiple image
| align = left
| direction = vertical
| header = [[PNG]] transparency demonstration
| width = 200

| image1 = PNG transparency demonstration 1.png
| alt1 = Colored dice with white background
| caption1 = A PNG image with an 8-bit transparency layer...

| image2 = PNG transparency demonstration 2.png
| alt2 = Colored dice with checkered background
| caption2 = ...here overlaid onto a checkered background.
}}
<pre style="overflow: auto;">
{{multiple image
| align = left
| direction = vertical
| header = [[PNG]] transparency demonstration
| width = 200

| image1 = PNG transparency demonstration 1.png
| alt1 = Colored dice with white background
| caption1 = A PNG image with an 8-bit transparency layer...

| image2 = PNG transparency demonstration 2.png
| alt2 = Colored dice with checkered background
| caption2 = ...here overlaid onto a checkered background.
}}</pre>
{{-}}

{{multiple image
| footer = When a user has many of one type of [[WP:BARN|barnstar]],
they can represent them with [[WP:RIBBON|ribbons]]
and these numerals to indicate the count.
| width = 60

| image1 = Ribbon numeral 2.png
| alt1 = 2

| image2 = Ribbon numeral 3.png
| alt2 = 3

| image3 = Ribbon numeral 4.png
| alt3 = 4
}}
<pre style="overflow: auto;">
{{multiple image
| footer = When a user has many of one type of [[WP:BARN|barnstar]],
they can represent them with [[WP:RIBBON|ribbons]]
and these numerals to indicate the count.
| width = 60

| image1 = Ribbon numeral 2.png
| alt1 = 2

| image2 = Ribbon numeral 3.png
| alt2 = 3

| image3 = Ribbon numeral 4.png
| alt3 = 4
}}</pre>
{{-}}

=== Example with background color ===
{{multiple image
| image1=Adoxa_moschatellina_210406.jpg
| alt1=Green herb with a few tiny yellow-white flowers

| image2=Adoxa_moschatellina_210406a.jpg
| alt2=Three small white and yellow flowers before green-leaf background

| image3=adoxa_moschatellina_blatt.jpeg
| alt3=Leaves of a plant. They are in groups of three, each with three lobes.

| footer=[[Adoxa]] (''Adoxa moschatellina'')
| footer_background=#BBDD99
| background color=#BBDD99
| footer_align=center
| width=160
}}
<pre style="overflow: auto;">
{{multiple image
| image1=Adoxa_moschatellina_210406.jpg
| alt1=Green herb with a few tiny yellow-white flowers

| image2=Adoxa_moschatellina_210406a.jpg
| alt2=Three small white and yellow flowers before green-leaf background

| image3=adoxa_moschatellina_blatt.jpeg
| alt3=Leaves of a plant. They are in groups of three, each with three lobes.

| footer=[[Adoxa]] (''Adoxa moschatellina'')
| footer_background=#BBDD99
| background color=#BBDD99
| footer_align=center
| width=160
}}
</pre>
{{-}}

=== Example with links ===
{{multiple image
| footer = The mule links to ''[[Mule]]'', the donkey does not link anywhere, and the trout links to its image description page as usual.
| align = left

| image1 = Frecklesmule.jpg
| width1 = 143
| alt1 = A mule
| caption1 = <center>A mule 骡子, ''luózi''</center>
| link1 = Mule

| image2 = Donkey 1 arp 750px.jpg
| width2 = 150
| alt2 = A donkey
| caption2 = <center>A donkey 驴子, lǘzi</center>
| link2 =

| image3 = Rainbow_trout.png
| width3 = 91
| alt3 = A trout
| caption3 = <center>A fish 
{{lang|zh|2=鱼}}, ''yú''</center>
}}
<pre style="overflow: auto;">
{{multiple image
| footer = The mule links to ''[[Mule]]'', the donkey does not link anywhere, and the trout links to its image description page as usual.
| align = left

| image1 = Frecklesmule.jpg
| width1 = 143
| alt1 = A mule
| caption1 = <center>A mule 骡子, ''luózi''</center>
| link1 = Mule

| image2 = Donkey 1 arp 750px.jpg
| width2 = 150
| alt2 = A donkey
| caption2 = <center>A donkey 驴子, lǘzi</center>
| link2 =

| image3 = Rainbow_trout.png
| width3 = 91
| alt3 = A trout
| caption3 = <center>A fish 
{{lang|zh|2=鱼}}, ''yú''</center>
}}
</pre>
{{-}}

=== Horizontal placement ===
Vertical direction places the images on ''one'' straight line (column) downwards from the first image, while horizontal direction places the images left to right on multiple lines (rows):
{{multiple image
| align = left
| direction = vertical
| header = vertical
| width = 60

| image1 = Ribbon numeral 2.png

| image2 = Ribbon numeral 3.png

| image3 = Ribbon numeral 4.png
}}
{{multiple image
| align = right
| direction = horizontal
| header = horizontal
| width = 60

| image1 = Ribbon numeral 2.png

| image2 = Ribbon numeral 3.png

| image3 = Ribbon numeral 4.png
}}
{{-}}
However, this will not be apparent if only two images are used, as the template with "direction = horizontal" will place both images on different lines (rows), creating a blank space. Thus [[Template:Double image]] must be used. Similarly, if one wishes to display three images side-by-side on one line, [[Template:Triple image]] must be used.

==== Matching image heights ====
: ''This trick is not required if all images have the same [[Aspect ratio (image)|aspect ratio]], where ''{{para|width}}'' suffices''
* Decide on a common height for the images, say 100 pixels.
* Examine the individual image pages to obtain the full resolution. For example:
** [[:File:Donkey 1 arp 750px.jpg]] shows "Donkey_1_arp_750px.jpg (750 × 536 pixels, file size: 125 KB, MIME type: image/jpeg)"
** [[:File:Rainbow trout.png]] shows "Rainbow_trout.png (300 × 300 pixels, file size: 158 KB, MIME type: image/png)"
* For non-square images, use these figures to construct an expression for the {{para|width''n''}} parameters, of the form:
** <code><nowiki>
{{#expr:</nowiki> (''dh'' * ''ow'' / ''oh'') round 0<nowiki>}}</nowiki></code>
* where
** ''dh'' is the desired height in pixels (100)
** ''ow'' is the original width in pixels (750 or 300)
** ''oh'' is the original height in pixels (536 or 300)
* For ''square'' images, simply set the appropriate {{para|width''n''}} to be the desired height. If all are square, only {{para|width}} needs to be set.
{{multiple image
| footer = The two images are both rendered 100 pixels high
| align = right

| image1 = Donkey 1 arp 750px.jpg
| width1 = {{#expr: (100 * 750 / 536) round 0}}
| alt1 = A donkey
| caption1 = A donkey, not square and originally 536 pixels high

| image2 = Rainbow_trout.png
| width2 = 100
| alt2 = A trout
| caption2 = A fish, square and originally 300 pixels high
}}
<pre style="overflow: auto;">
{{multiple image
| footer = The two images are both rendered 100 pixels high
| align = right

| image1 = Donkey 1 arp 750px.jpg
| width1 = {{#expr: (100 * 750 / 536) round 0}}
| alt1 = A donkey
| caption1 = A donkey, not square and originally 536 pixels high

| image2 = Rainbow_trout.png
| width2 = 100
| alt2 = A trout
| caption2 = A fish, square and originally 300 pixels high
}}
</pre>
{{clear}}

=== See also ===

* {{tl|Auto images}} – automatically sizes a set of horizontal images
* {{tl|Double image}}
* {{tl|Triple image}}
* {{tl|Gallery}}

<includeonly>

[[Category:Graphic templates|{{PAGENAME}}]]

</includeonly>

<includeonly>
[[it:Template:Immagine multipla]]
</includeonly>