Template:Auto images/doc

This template is a simplified version of Multiple images. It can be used to arrange two to six images in a horizontal row. They will automatically be scaled so that they are all of the same height and together have specified total width. Each image can have its own caption; the complete row can have a title.

Any number of horizontal rows of images can be placed underneath one another to form a combined set.

Usage
produces

Parameters
Four parameters apply to the set of images as whole.


 * title – specifies an optional title placed at the top of the set of images.
 * total_width – optionally specifies the total width of the set of images. The default is 600 (pixels), which is good for a screen width of 800 and for printing.
 * align – a value of left aligns the set of images to the left of the page; a value of right aligns them to the right of the page. The default is to centre the images on the page. Note: text does not flow around the sides of the images, regardless of the alignment. For this effect, see below.
 * cont – any nonblank value (e.g. yes) is used to combine a row of images produced by this template with the one above – see below.

Each image is described by five parameters. "N" below takes the values 1, 2, ..., 6 for the maximum of six images.


 * widthN – this is the width in pixels of the full resolution version of the image in Commons or CorporisPublica. Examine the individual image page to obtain the full resolution.
 * heightN</tt> – this is the height in pixels of the full resolution version of the image in Commons or CorporisPublica.
 * imageN</tt> – the name of the image in Commons or CorporisPublica (do not precede by "File:" or "Image:").
 * captionN</tt> – an optional caption for the image.
 * altN</tt> – alternative text. See CP:ALT.

Examples
The great advantage of this template over Multiple image is that if you decide to add or remove an image or change the total width of the row of images, you don't have to recalculate the widths. Thus: produces

produces

Combining rows of images
To produce multiple horizontal rows of images, the template can be repeated any number of times, using the same value of total_width</tt> each time. Specifying cont = yes</tt> (or any other nonblank value) on the second and subsequent uses ensures that there is only a single line between the two rows; without it there will be a double line.

produces

Embedding images in text
This template does not allow text to flow around it, i.e. it does not allow images to be embedded in text. For maximum flexibility, use the more advanced template Multiple image.

Images displayed by this template can be embedded in text to the left or right by enclosing uses of the template in an appropriate HTML div.
 * To display embedded images to the left, enclose the template(s) in  ... </tt>.
 * To display embedded images to the right, enclose the template(s) in  ... </tt>.

Thus the following produces the images to the right:

Limitations, debugging

 * Only a maximum of six images are allowed in a row. Unless the total width is made large, which is undesirable for printing and for readers with smaller screens, more than this number of images means that they are likely to be rather small.


 * Regardless of the alignment of the images, text does not flow around them. For this feature, see above.


 * If the displayed images are not all of the same height, then the widthN</tt> and heightN</tt> parameters have been omitted or set incorrectly for one or more images. Recall that they should be the width and height of the highest resolution version of the image in Commons or CorporisPublica.


 * A long title can force a row of images to be wider than the specified value of total_width</tt>.