Difference between revisions of "Template:FurnitureTable/doc"

From SpiralKnights

Jump to: navigation, search
m (fixing "placed" to be "overworld" to be consistent with the rest of the wiki.)
m (Added {{documentation subpage}})
 
(3 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 day 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. If there are no specific requirements, leave it blank.
 
'''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? If there are no specific costs, 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.
 
'''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
 +
 
 +
Indicates the cardinal directions a furniture can be rotated. Perhaps this is not extremely important information, but it is desired by several users.
 +
 
 +
'''<nowiki>{{Table/end}}</nowiki>''' - ends template.
  
 
{{clearleft}}
 
{{clearleft}}
Line 28: Line 42:
  
 
===Optional===
 
===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.
+
'''<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.
 
+
"Overworld:"
+
 
+
|tooltip name = Blue Lazy Snipe-Overworld
+
 
+
|tooltip name = Green Winterfest Tree
+
 
+
''"Overworld"'' simply means that the image is of the item in the overworld. We usually want the "Overworld" 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.
+
  
 
==Usage==
 
==Usage==
Line 48: Line 54:
  
  
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.
+
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.
  
  
If the table seems to be messing with the page alignment/organization, stick <nowiki>{{clearleft}}</nowiki> after <nowiki>{{Table/end}}</nowiki>.
+
If the table seems to be messing with the page alignment/organization, stick '''<nowiki>{{clearleft}}</nowiki>''' after '''<nowiki>{{Table/end}}</nowiki>'''.
 +
 
 +
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:'''
 
'''Example:'''
 
 
  
 
<nowiki>
 
<nowiki>
{{FurnitureTable/start}}
+
{{FurnitureTable/start}}</nowiki><br/><nowiki>
</nowiki><br/><br/><nowiki>
+
</nowiki><br/><nowiki>
 
{{FurnitureTable</nowiki><br/><nowiki>
 
{{FurnitureTable</nowiki><br/><nowiki>
|icon name = Spiral Blue Bed</nowiki><br/><nowiki>
+
|name = Spiral Blue Bed</nowiki><br/><nowiki>
|official name = Spiral Blue Bed</nowiki><br/><nowiki>
+
|image = tooltip</nowiki><br/><nowiki>
|tooltip name = Spiral Blue Bed</nowiki><br/><nowiki>
+
 
|description = A comfy cot that's better than bunking in a bedroll.</nowiki><br/><nowiki>
 
|description = A comfy cot that's better than bunking in a bedroll.</nowiki><br/><nowiki>
|DoR = This item was introduced in November 2012. </nowiki><br/><nowiki>
+
|DoR = This item was introduced in November 2012.</nowiki><br/><nowiki>
 
|notes = </nowiki><br/><nowiki>
 
|notes = </nowiki><br/><nowiki>
 +
|acquisition = Birdsong Emporium </nowiki><br/><nowiki>
 
|requirements = Requires:<br/>[[Expansion (Guild Hall)|Either 1F Wing]]</nowiki><br/><nowiki>
 
|requirements = Requires:<br/>[[Expansion (Guild Hall)|Either 1F Wing]]</nowiki><br/><nowiki>
|acquisition = Birdsong Emporium  </nowiki><br/><nowiki>
 
 
|cost = 20,515 Crowns</nowiki><br/><nowiki>
 
|cost = 20,515 Crowns</nowiki><br/><nowiki>
 
|rotation = NSWE</nowiki><br/><nowiki>
 
|rotation = NSWE</nowiki><br/><nowiki>
Line 81: Line 86:
  
 
'''Produces:'''
 
'''Produces:'''
 
 
  
  
Line 88: Line 91:
  
 
{{FurnitureTable
 
{{FurnitureTable
|icon name = Spiral Blue Bed
+
|name = Spiral Blue Bed
|official name = Spiral Blue Bed
+
|image = tooltip
|tooltip name = Spiral Blue Bed
+
 
|description = A comfy cot that's better than bunking in a bedroll.
 
|description = A comfy cot that's better than bunking in a bedroll.
|DoR = This item was introduced in November 2012.  
+
|DoR = This item was introduced in November 2012.
 
|notes =  
 
|notes =  
 +
|acquisition = Birdsong Emporium
 
|requirements = Requires:<br/>[[Expansion (Guild Hall)|Either 1F Wing]]
 
|requirements = Requires:<br/>[[Expansion (Guild Hall)|Either 1F Wing]]
|acquisition = Birdsong Emporium 
 
 
|cost = 20,515 Crowns
 
|cost = 20,515 Crowns
 
|rotation = NSWE
 
|rotation = NSWE
Line 103: Line 105:
  
 
{{clearleft}}
 
{{clearleft}}
----
 
'''Another Example:''' emphasizing an overworld view:
 
 
 
<nowiki>
 
{{FurnitureTable/start}}
 
</nowiki><br/><br/><nowiki>
 
{{FurnitureTable</nowiki><br/><nowiki>
 
|icon name = Cursed Nature Sprite</nowiki><br/><nowiki>
 
|official name = Cursed Nature Sprite</nowiki><br/><nowiki>
 
|tooltip name = Cursed Nature Sprite-Overworld</nowiki><br/><nowiki>
 
|description = A spirit of nature willing to wander rather than follow the guide of the Spirit Mother.</nowiki><br/><nowiki>
 
|DoR = This item was introduced in July 2014.</nowiki><br/><nowiki>
 
|notes = It is a wandering [[Nature Sprite]].</nowiki><br/><nowiki>
 
|acquisition = [[Prize Box#Almire Furniture Box|Almire Furniture Box]]</nowiki><br/><nowiki>
 
|requirements =</nowiki><br/><nowiki>
 
|cost = </nowiki><br/><nowiki>
 
|rotation = WANDERING</nowiki><br/><nowiki>
 
}}</nowiki><br/><nowiki>
 
</nowiki><br/><nowiki>
 
{{Table/end}}</nowiki><br/><nowiki>
 
</nowiki>
 
{{clearleft}}
 
 
 
'''Produces:'''
 
 
{{FurnitureTable/start}}
 
 
{{FurnitureTable
 
|icon name = Cursed Nature Sprite
 
|official name = Cursed Nature Sprite
 
|tooltip name = Cursed Nature Sprite-Overworld
 
|description = A spirit of nature willing to wander rather than follow the guide of the Spirit Mother.
 
|DoR = This item was introduced in July 2014.
 
|notes = It is a wandering [[Nature Sprite]].
 
|acquisition = [[Prize Box#Almire Furniture Box|Almire Furniture Box]]
 
|requirements =
 
|cost =
 
|rotation = WANDERING
 
}}
 
 
{{Table/End}}
 
 
{{clearleft}}
 
 
----
 
'''Visual:''' where the <nowiki>{{{...}}}</nowiki> are generally positioned:
 
{{FurnitureTable/start}}
 
 
{{FurnitureTable
 
 
}}
 
  
{{Table/End}}
+
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