Help:Gallery: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| (13 intermediate revisions by the same user not shown) | |||
| Line 10: | Line 10: | ||
<pre> | <pre> | ||
<gallery> | <gallery> | ||
Image name. | Image name 1.png|Caption 1 | ||
Image name 2.jpg|Caption 2 | |||
Image name 3.gif|Caption 3 | |||
</gallery> | </gallery> | ||
</pre> | </pre> | ||
| Line 21: | Line 23: | ||
</gallery> | </gallery> | ||
Here is the source code for the above gallery: | |||
<pre> | <pre> | ||
<gallery> | <gallery> | ||
| Line 31: | Line 34: | ||
== Advanced options == | == Advanced options == | ||
In | 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 <code>widths</code>, <code>heights</code>, and <code>class</code> parameters, respectively. | This can be accomplished using the <code>widths</code>, <code>heights</code>, and <code>class</code> parameters, respectively. | ||
=== Supported classes === | |||
* <code>rawsize</code> : Prevent the image from being upscaled | |||
** <code>rawsize x2</code> - <code>x10</code> : Scale the image a specific amount | |||
* <code>smooth</code> : Use a smooth rather than pixelated image upscaling algorithm | |||
* <code>blackbg</code> / <code>graybg</code> : Change the background color of the image container | |||
* <code>invert-light</code> / <code>invert-dark</code> : Invert the image in the wiki's light or dark mode | |||
==== Using rawsize ==== | |||
Start with an opening tag of <code><nowiki><gallery class="rawsize"></nowiki></code> and step up the scaling one increment at a time (e.g. <code>rawsize x2</code>, <code>rawsize x3</code>, 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 {{tem|class}} template. This could be used to reduce the scaling on just the overflowed image(s). For example: | |||
<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> | |||
Here is the source code for the above gallery: | |||
<pre> | |||
<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> | |||
</pre> | |||
=== Example === | === Example === | ||
<gallery class="blackbg | <gallery class="blackbg" widths="50" heights="50"> | ||
SM64 Asset Sprite CS Mario.png|Mario | SM64 Asset Sprite CS Mario.png|Mario | ||
SM64 Asset Sprite CS Coin.png|Yellow Coin | SM64 Asset Sprite CS Coin.png|Yellow Coin | ||
| Line 46: | Line 73: | ||
</gallery> | </gallery> | ||
Here is the source code for the above gallery: | |||
<pre> | <pre> | ||
<gallery class="blackbg | <gallery class="blackbg" widths="50" heights="50"> | ||
SM64 Asset Sprite CS Mario.png|Mario | SM64 Asset Sprite CS Mario.png|Mario | ||
SM64 Asset Sprite CS Coin.png|Yellow Coin | SM64 Asset Sprite CS Coin.png|Yellow Coin | ||
| Line 55: | Line 83: | ||
</pre> | </pre> | ||
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 == | == Galleries in articles == | ||
Latest revision as of 17:39, November 5, 2024
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 upscaledrawsize x2-x10: Scale the image a specific amount
smooth: Use a smooth rather than pixelated image upscaling algorithmblackbg/graybg: Change the background color of the image containerinvert-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:
Rat's all, folks!
I'm NOT a crusty crab!
Snake me wanna shout
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
Mario
Yellow Coin
Power Star
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.
