[go: up one dir, main page]

This help page covers how to create an image gallery.

Gallery basics

Galleries are best used in situations where many images need to be displayed. Galleries are like thumbnails boxed together in a table.

By default, galleries have a fluid width. Do not create galleries with a fixed width on any page outside of your userspace.

The basic syntax for a gallery is as follows:

<gallery>
Image name 1.png|Caption 1
Image name 2.jpg|Caption 2
Image name 3.gif|Caption 3
</gallery>

Example

Here is the source code for the above gallery:

<gallery>
MarioMP8Artwork.png|[[Mario]]
Luigi Artwork - Mario Party 7.png|[[Luigi]]
NSMBDS Bowser Artwork.png|[[Bowser]]
</gallery>

Advanced options

In some instances, it may be necessary to change the image widths, heights, and other aspects in order to display them properly in a gallery.

This can be accomplished using the widths, heights, and class parameters, respectively.

Supported classes

  • rawsize : Prevent the image from being upscaled
    • rawsize x2 - x10 : Scale the image a specific amount
  • smooth : Use a smooth rather than pixelated image upscaling algorithm
  • blackbg / graybg : Change the background color of the image container
  • invert-light / invert-dark : Invert the image in the wiki's light or dark mode

Using rawsize

Start with an opening tag of <gallery class="rawsize"> and step up the scaling one increment at a time (e.g. rawsize x2, rawsize x3, etc) until all sprites fit comfortably within their gallery container and without any images overflowing. Do not increase the size of the widths/heights value beyond the default 120px to make room for scaled images (but going smaller is fine).

It is possible to adjust the scaling on a per-image basis using the {{class}} template. This could be used to reduce the scaling on just the overflowed image(s). For example:

Here is the source code for the above gallery:

<gallery class="rawsize x4">
MouserL.gif|Rat's all, folks!
Clawgrip.gif|I'm NOT a crusty crab!
TriclydeL.gif|Snake me wanna shout{{class|x3}}
</gallery>

Example

Here is the source code for the above gallery:

<gallery class="blackbg" widths="50" heights="50">
SM64 Asset Sprite CS Mario.png|Mario
SM64 Asset Sprite CS Coin.png|Yellow Coin
SM64 Asset Sprite CS Power Star.png|Power Star
</gallery>

This example applies a class to all images in the gallery. For details on how to apply classes on a per-image basis, see Template:Class.

Galleries in articles

See MarioWiki:Galleries for details on how article gallery sections and dedicated gallery pages should be laid out.