View source for Template:Gallery/Aesthetic/doc

==Usage==
Puts a template that closely mimics the appearance of a '''<nowiki><gallery></nowiki>''' on a page. It should force consistent file naming and provides users with a faster loading time and the ability to easily access animations of items they might wish to see in detail.

It should be used on individual costume and accessory pages - hence "aesthetic." Other gallery mimic templates used for other items can be found [[:Category:Gallery Templates|here]].

==Code==
The simplest form of the template takes advantage of many defaults:
<pre>
{{Gallery/Aesthetic
|news          =
|news link     =
}}
</pre>

==Parameters==
===Required===
None, though many defaults will not make sense when used in junction. Most items have one or more unique conditions that should be considered.

===Optional===
*'''name'''
:defaults to PAGENAME
::Use sparingly, usually only if there are disambiguation issues

====News Panel====
*'''news'''
Enter the filename of the news image, minus the filetype at the end (forces png - try to upload actual pngs whenever possible). Please use the "big" version (like [[:File:SpiralKnights News 103-big.png]] vs [[:File:SpiralKnights News 103.png]]) whenever possible. Watch the hyphen and capital letters. "big" news images should be full versions of visuals used on the [[news]] page. 

:no news link
::Use if there is no news link

:variable 
::use if there are many different items with different release dates, like with [[recolor]]s

*'''news image'''
:defaults through '''news''' parameter but can be adjusted for wording with:

:no news image
::Use if there is no news link

:variable
::if more than one variation of the item has been released over time. There are a few specific "variable" options:
:::recolor (if the item has been [[recolor|recolored]])
:::rose regalia

*'''news link'''
:defaults to a uniform phrase. Same conditions as '''news'''.
:enter the full address of the location of the news - usually an admin forum post, like so: http://forums.spiralknights.com/en/node/107935

====Panel 2,3,4 Visuals====
Use these only if:
<br>- images have already been uploaded to decent filenames
<br>- the items seem to be extra special
<br>- the items have an unusual naming convention that doesn't work with PAGENAME
<br>- if there are disambiguation issues (another PAGENAME issue)

Pick an item that you feel best represents the type of item. It would be best if that item's coloration were different from the others in the gallery per image.

Image filetype is .png

An example of usage can be found [[Anti-Spikes|here]].

*'''panel 2 image''' 
:Defaults through '''name''' to PAGENAME
::Use the full name of the item as seen in-game that you wish to specify
::Panel 2 images for this gallery are tooltip animations

*'''panel 3 image'''
:Defaults through '''name''' to PAGENAME
::Use the full name of the item as seen in-game that you wish to specify
::panel 3 images for this gallery are preview images for accessories and costumes, unless costumes are in a set, then the image is of the item in its set. See below for details.

*'''panel 4 image'''
:Defaults through '''name''' to PAGENAME
::Use the full name of the item as seen in-game that you wish to specify
::panel 4 images for this gallery are overworld animations

====Panel 3: Sets====
This only pertains to several costume items. If the item is in a [[List of sets|set]], sharing a similar name and coloration to either a helmet or armor costume, then simply add "set" to the code like so:

<pre>
{{Gallery/Aesthetic
|news      = blah
|news link = blah
|set       = FILENAME
}}
</pre> 

This will take care of the panel 3 image field with ease. Make sure to name the file properly. Pick a set you feel is a good representative of the rest of the sets if the costumes have several recolored sets. Not all costumes do - the [[Plasmatech Demo Suit|Plasmatech]] items are unique, while the [[Warden Helm|Warden]] items have several colors.

this is always a .png, so don't include ".png" (or "File:" in the filename - just use the file's name.

==Examples==
<pre>
{{Gallery/Aesthetic
|news          = variable
|panel 2 image = Anti-Hazard Spikes
|panel 3 image = Anti-Personnel Spikes
|panel 4 image = Anti-Hazard Spikes
}}
</pre>

;Produces

{{Gallery/Aesthetic
|news          = variable
|panel 2 image = Anti-Hazard Spikes
|panel 3 image = Anti-Personnel Spikes
|panel 4 image = Anti-Hazard Spikes
}}

If used on the relevant page (notice the editor has chosen to not upload the same file twice for both helmet and suit, and chooses to use suit for both overworld pics - not usually something you should do but it is possibly desired if uniform changes occur to a set):

<pre>
{{Gallery/Aesthetic
|news             = SpiralKnights News 142-big
|news link        = http://forums.spiralknights.com/en/node/107935
|set              = Voltaic Radical
|panel 4 image    = Voltaic Radical Suit
}}
</pre>

;Produces

{{Gallery/Aesthetic
|news             = SpiralKnights News 142-big
|news link        = http://forums.spiralknights.com/en/node/107935
|set              = Voltaic Radical
|panel 2 image    = Voltaic Radical Suit
|panel 4 image    = Voltaic Radical Suit
}}

==Notes==
This template uses many switches and will likely explode if you try to touch it. Be especially careful when uploading new images. If you know an image you want to use exists already, do not upload that image to another name - tweak your data entries until the image shows up, take a good look at the code, or ask for help on the [http://forums.spiralknights.com/en/forum/14 Wiki Editors' Forums] if it refuses to work.

There are several animation and caption options in the template code in case we ever need to tweak certain things regarding APNGs - they are used very sparingly, if at all.