Difference between revisions of "Template:FurnitureTable/doc"

From SpiralKnights

Jump to: navigation, search
m (Parameters: more added.)
m (Added {{documentation subpage}})
 
(19 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
<noinclude>{{documentation subpage}}</noinclude>
 
==Parameters==
 
==Parameters==
 
===Required===
 
===Required===
'''icon name''' = the filename of the item's icon image
+
'''<nowiki>{{FurnitureTable/start}}</nowiki>''' - starts template.
 +
 
 +
'''name''' = the official name of the item, in full, no slang, as seen in-game.
  
 
'''official name''' = the full name of the entity as seen in-game
 
'''official name''' = the full name of the entity as seen in-game
  
'''tooltip name''' = the filename of the item's tooltip (or in the case of creatures, overworld) image
+
'''image''' =  
 +
:''overworld'' - shows an overworld image of the item. This is preferred for Creature type furniture items, because their tooltip image is a cage.
 +
:''tooltip'' - shows a tooltip image of the item. This is generally preferable because it shows dimensions and scale of the item.
  
 
'''description''' = the official description of the item as seen in the tooltip in-game.
 
'''description''' = the official description of the item as seen in the tooltip in-game.
  
'''DoR''' = Date of Release. We only use month and year for these, that's informative and takes up less space. Extra curious users can find information via the box info or patch notes.
+
'''DoR''' = Date of Release. Only using month and year for these, that's informative and takes up less space. Extra curious users can find day information via the box info or patch notes.
  
'''notes''' = miscellaneous information such as date of release.
+
'''notes''' = miscellaneous information such as audio aspects or what the item is a mimic of (like a "Curious Mewkat" is a wandering [[Mewkat]] and so on).
  
'''requirements''' = what [[Expansion (Guild Hall)|Guild Hall Wing Expansions]], [[Player Rank]], etc. are needed to get the item.
+
'''requirements''' = what [[Expansion (Guild Hall)|Guild Hall Wing Expansions]], [[Player Rank]], etc. are needed to get the item. If there are no specific requirements, leave it blank.
  
 
'''acquisition''' = where to get the item from. Birdsong Emporium? A specific box? Supply Depot, during an event?
 
'''acquisition''' = where to get the item from. Birdsong Emporium? A specific box? Supply Depot, during an event?
Line 19: Line 24:
 
'''cost''' = cost to obtain in crowns, energy, tokens, etc. or just leave it blank if it's randomly from a box.
 
'''cost''' = cost to obtain in crowns, energy, tokens, etc. or just leave it blank if it's randomly from a box.
  
'''rotation''' = a value such as S, SWE, NSWE, ALL, or WANDERING. Indicates the cardinal directions a furniture can be rotated. Perhaps this is not extremely important information, but it is desired by several users.
+
'''rotation''' = a value such as:
 +
:''S
 +
:''SWE
 +
:''NSWE
 +
:''ALL
 +
:''MOVING
  
Feel free to adjust these parameters into different sortable columns if users desire that anytime in the future.
+
Indicates the cardinal directions a furniture can be rotated. Perhaps this is not extremely important information, but it is desired by several users.
  
===Optional===
+
'''<nowiki>{{Table/end}}</nowiki>''' - ends template.
<nowiki> <br/> </nowiki> puts in line breaks without breaking template or page. So does putting space into the entry field, but neither of these are recommended.  
+
  
"placed:"
+
{{clearleft}}
  
|tooltip name = Blue Lazy Snipe-Placed
+
Feel free to adjust these parameters into different sortable columns if users desire that anytime in the future.
  
|tooltip name = Green Winterfest Tree
+
{{clearleft}}
  
"placed" simply means that the image is of the item in the overworld. We usually want the "placed" version for Creatures, since the tooltip view for creatures is a cage, and that's not very informative. Other furniture items use the tooltip. This is useful because information about the scale of the item is incorporated into the tooltip images of furniture.
+
===Optional===
 +
'''<nowiki><br/></nowiki>''' puts in line breaks without breaking template or page. So does putting space into the entry field, but neither of these are recommended.
  
 
==Usage==
 
==Usage==
Line 38: Line 48:
  
  
 +
Notice that you get the description when you mouseover the icon or the image, giving a more in-game feel to the table, while saving space. Some item descriptions are very lengthy
 +
and make the table ugly, as with the obsidian obelisk items.
  
Example:
+
Same goes for the [[File:WikiTable-Rotation NSWE icon.png|36px]] image that is a wikiimage for this template, from incorporation of the [http://wiki.spiralknights.com/Template:FurnitureRotation FurnitureRotation] template.
  
  
 +
You can easily add in links with '''<nowiki>[[page title|text that appears]]</nowiki>''' or '''<nowiki>[URL|text that appears]</nowiki>''' without breaking the table.
  
<nowiki>
 
{{FurnitureTable/start}}
 
{{FurnitureTable
 
|icon name = Blue Lazy Snipe
 
|official name = Blue Lazy Snipe
 
|tooltip name = Blue Lazy Snipe-Placed
 
|description = A quietly resting snipe that will stay where it's placed.
 
|notes = This item was introduced in November 2012.
 
|acquisition = Birdsong Emporium <br/><br/> Must have at least one of the 5F wings installed.
 
|cost = 293,730 Crowns
 
}}
 
  
{{Table/end}}
+
If the table seems to be messing with the page alignment/organization, stick '''<nowiki>{{clearleft}}</nowiki>''' after '''<nowiki>{{Table/end}}</nowiki>'''.
</nowiki>
+
{{clearleft}}
+
 
+
 
+
 
+
Produces:
+
 
+
 
+
 
+
{{FurnitureTable/start}}
+
{{FurnitureTable
+
|icon name = Blue Lazy Snipe
+
|official name = Blue Lazy Snipe
+
|tooltip name = Blue Lazy Snipe-Placed
+
|description = A quietly resting snipe that will stay where it's placed.
+
|notes = This item was introduced in November 2012.
+
|acquisition = Birdsong Emporium <br/><br/> Must have at least one of the 5F wings installed.
+
|cost = 293,730 Crowns
+
}}
+
 
+
{{Table/end}}
+
 
+
{{clearleft}}
+
 
+
 
+
 
+
Another Example:
+
  
 +
The template is configured to show the general [[File:Icon-furniture.png|36px]] arsenal furniture icon if an icon hasn't been uploaded. Simply click that general icon, if it shows up in a table somewhere, to upload an official icon for that item.
  
 +
----
 +
'''Example:'''
  
 
<nowiki>
 
<nowiki>
 
+
{{FurnitureTable/start}}</nowiki><br/><nowiki>
{{FurnitureTable/start}}
+
</nowiki><br/><nowiki>
 
+
{{FurnitureTable</nowiki><br/><nowiki>
{{FurnitureTable
+
|name = Spiral Blue Bed</nowiki><br/><nowiki>
|icon name = Blue Tall Gaslamp
+
|image = tooltip</nowiki><br/><nowiki>
|official name = Blue Tall Gaslamp
+
|description = A comfy cot that's better than bunking in a bedroll.</nowiki><br/><nowiki>
|tooltip name = Blue Tall Gaslamp
+
|DoR = This item was introduced in November 2012.</nowiki><br/><nowiki>
|description = A tall, elegant street lamp that emits a blue glow with a gentle hiss.
+
|notes = </nowiki><br/><nowiki>
|notes = This item was introduced in January 2013.
+
|acquisition = Birdsong Emporium </nowiki><br/><nowiki>
|acquisition = [[Prize Box#Moorcroft Prize Box|Moorcroft Prize Box]]
+
|requirements = Requires:<br/>[[Expansion (Guild Hall)|Either 1F Wing]]</nowiki><br/><nowiki>
|cost = N/A
+
|cost = 20,515 Crowns</nowiki><br/><nowiki>
}}
+
|rotation = NSWE</nowiki><br/><nowiki>
 
+
}}</nowiki><br/><nowiki>
{{Table/end}}
+
</nowiki><br/><nowiki>
 
+
{{Table/end}}</nowiki><br/><nowiki>
 
</nowiki>
 
</nowiki>
 
 
{{clearleft}}
 
{{clearleft}}
  
  
  
Produces:
+
'''Produces:'''
 
+
  
  
Line 115: Line 91:
  
 
{{FurnitureTable
 
{{FurnitureTable
|icon name = Blue Tall Gaslamp
+
|name = Spiral Blue Bed
|official name = Blue Tall Gaslamp
+
|image = tooltip
|tooltip name = Blue Tall Gaslamp
+
|description = A comfy cot that's better than bunking in a bedroll.
|description = A tall, elegant street lamp that emits a blue glow with a gentle hiss.
+
|DoR = This item was introduced in November 2012.
|notes = This item was introduced in January 2013.
+
|notes =
|acquisition = [[Prize Box#Moorcroft Prize Box|Moorcroft Prize Box]]
+
|acquisition = Birdsong Emporium
|cost = N/A 
+
|requirements = Requires:<br/>[[Expansion (Guild Hall)|Either 1F Wing]]
 +
|cost = 20,515 Crowns
 +
|rotation = NSWE
 
}}
 
}}
  
Line 127: Line 105:
  
 
{{clearleft}}
 
{{clearleft}}
 +
 +
And so on.

Latest revision as of 08:36, 11 September 2015

Parameters

Required

{{FurnitureTable/start}} - starts template.

name = the official name of the item, in full, no slang, as seen in-game.

official name = the full name of the entity as seen in-game

image =

overworld - shows an overworld image of the item. This is preferred for Creature type furniture items, because their tooltip image is a cage.
tooltip - shows a tooltip image of the item. This is generally preferable because it shows dimensions and scale of the item.

description = the official description of the item as seen in the tooltip in-game.

DoR = Date of Release. Only using month and year for these, that's informative and takes up less space. Extra curious users can find day information via the box info or patch notes.

notes = miscellaneous information such as audio aspects or what the item is a mimic of (like a "Curious Mewkat" is a wandering Mewkat and so on).

requirements = what Guild Hall Wing Expansions, Player Rank, etc. are needed to get the item. If there are no specific requirements, leave it blank.

acquisition = where to get the item from. Birdsong Emporium? A specific box? Supply Depot, during an event?

cost = cost to obtain in crowns, energy, tokens, etc. or just leave it blank if it's randomly from a box.

rotation = a value such as:

S
SWE
NSWE
ALL
MOVING

Indicates the cardinal directions a furniture can be rotated. Perhaps this is not extremely important information, but it is desired by several users.

{{Table/end}} - ends template.


Feel free to adjust these parameters into different sortable columns if users desire that anytime in the future.


Optional

<br/> puts in line breaks without breaking template or page. So does putting space into the entry field, but neither of these are recommended.

Usage

For pages of furniture families. Keeps things neat, organized, and informative. The number of variable plug-n-chug aspects is due to the large number of disambiguation pages in relation to furniture and other token/gear/etc. items, as well as whether or not the editor wishes to show a tooltip or overworld view, officially.


Notice that you get the description when you mouseover the icon or the image, giving a more in-game feel to the table, while saving space. Some item descriptions are very lengthy and make the table ugly, as with the obsidian obelisk items.

Same goes for the WikiTable-Rotation NSWE icon.png image that is a wikiimage for this template, from incorporation of the FurnitureRotation template.


You can easily add in links with [[page title|text that appears]] or [URL|text that appears] without breaking the table.


If the table seems to be messing with the page alignment/organization, stick {{clearleft}} after {{Table/end}}.

The template is configured to show the general Icon-furniture.png arsenal furniture icon if an icon hasn't been uploaded. Simply click that general icon, if it shows up in a table somewhere, to upload an official icon for that item.


Example:

{{FurnitureTable/start}}

{{FurnitureTable
|name = Spiral Blue Bed
|image = tooltip
|description = A comfy cot that's better than bunking in a bedroll.
|DoR = This item was introduced in November 2012.
|notes =
|acquisition = Birdsong Emporium
|requirements = Requires:<br/>[[Expansion (Guild Hall)|Either 1F Wing]]
|cost = 20,515 Crowns
|rotation = NSWE
}}

{{Table/end}}


Produces:


Name Visual Rotation Acquisition Description & Notes
A comfy cot that's better than bunking in a bedroll.
Spiral Blue Bed
A comfy cot that's better than bunking in a bedroll.
This item can only be rotated to the North, South, West, or East. Requires:
Either 1F Wing

Birdsong Emporium

20,515 Crowns
This item was introduced in November 2012.

Description: A comfy cot that's better than bunking in a bedroll.


And so on.

Personal tools