ထႅမ်းပလဵတ်ႉ:Multiplemaps/doc

ဢၼ်ၼႆႉ မၼ်းပဵၼ် ၽိုၼ်လိၵ်ႈၽႄ တွၼ်ႈတႃႇ ထႅမ်းပလဵတ်ႉ:Multiplemaps။
မၼ်းၶဝ်ႈပႃး လွၼ်ႉၶၢဝ်ႇ လွင်ႈၸႂ်ႉတိုဝ်း၊ ပိူင်ထၢၼ်ႈ လႄႈ လမ်းၼႂ်းတၢင်ႇၸိူဝ်း ဢၼ်ဢမ်ႇၸႂ်ႈ ပွတ်းတွၼ်ႈ ၶွင်ငဝ်ႈတိုၼ်း ထႅမ်းပလဵတ်ႉ ၼႃႈလိၵ်ႈ။

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. It should be used only when there is a clear need to juxtapose two maps (example). Rarely, it might find another use, but keep in mind that Wikivoyage recommends a minimal use of images, and does not therefore allow image galleries.

Usage

align defaults to "right"
direction defaults to "horizontal"
header_align defaults to "center"
caption_align defaults to "left"
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. 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.
background color defines the background color between the border of the box and the images.
header, footer, background color and captions are optional.

{{Multiple image
<!-- Essential parameters -->
| align     = <!-- left/right/center/none --> 
| direction = <!-- horizontal/vertical -->
| width     = <!-- Digits only; no "px" suffix, please -->

<!-- Image 1 -->
| image1    = <!-- Filename only; no "File:" or "Image:" prefix, please -->
| width1    = 
| alt1      = 
| caption1  = 

<!-- Image 2 -->
| image2    = <!-- Filename only; no "File:" or "Image:" prefix, please -->
| width2    = 
| alt2      = 
| caption2  = 

<!-- Image 3 -->
| image3    = <!-- Filename only; no "File:" or "Image:" prefix, please -->
| width3    = 
| alt3      = 
| caption3  =

<!-- up to |image10 is accepted -->

<!-- Extra parameters -->
| header            = 
| header_align      = <!-- left/right/center -->
| header_background = 
| footer            = 
| footer_align      = <!-- left/right/center -->
| footer_background = 
| background color  = 
| image_gap         =
}}

Examples

Players are cautioned with a yellow card and sent off with a red card.

{{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
}}

—

PNG transparency demonstration

A PNG image with an 8-bit transparency layer...

...here overlaid onto a checkered background.

{{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.
}}

—

Example with background color

Adoxa (Adoxa moschatellina)

{{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
}}

—

Example with links

A mule
骡子, luózi

A donkey
驴子, lǘzi

A fish
鱼, yú

The mule links to Mule, the donkey does not link anywhere, and the trout links to its image description page as usual.

{{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
| caption_align = center

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

| image2    = Donkey in Clovelly, North Devon, England.jpg
| width2    = 150
| alt2      = A donkey
| caption2  = A donkey<br />驴子, lǘzi
| link2     =

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

—

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):

vertical

horizontal

— 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.

This trick is not required if all images have the same aspect ratio, where |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 in Clovelly, North Devon, England.jpg shows "Donkey in Clovelly, North Devon, England.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 |widthn= parameters, of the form:
- {{#expr: (dh * ow / oh) round 0}}
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 |widthn= to be the desired height. If all are square, only |width= needs to be set.

A donkey, not square and originally 536 pixels high

A fish, square and originally 300 pixels high

The two images are both rendered 100 pixels high

{{Multiple image
| footer    = The two images are both rendered 100 pixels high
| align     = right

| image1    = Donkey in Clovelly, North Devon, England.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
}}