Difference between revisions of "Template:ArmorList/doc"

From SpiralKnights

Jump to: navigation, search
m (prep for "mother template")
m (Replaced content with '{{delete}} - relevant template has been replaced by Template:GearList/Defensive and its documentation.')
 
(48 intermediate revisions by the same user not shown)
Line 1: Line 1:
This template is a complex, yet simplistic table meant to be used by both new and old users. It's a compressed way to find and compare gear items via sorting. It utilizes visual icons, sorting cells, tooltips, and show/hide coding in a way that hasn't been seen on the wiki until now, so take careful note of the following documentation, as the template is touchy, sensitive, and requires lots of love!
+
{{delete}} - relevant template has been replaced by [[:Template:GearList/Defensive]] and its documentation.
 
+
==Parameters==
+
===Required===
+
'''<nowiki>{{List/Window/NoHeader</nowiki><br/><nowiki>
+
|width=100%</nowiki><br/><nowiki>
+
|body=</nowiki><br/><nowiki>
+
</nowiki><br/><nowiki>
+
{{ArmorList/start}}
+
</nowiki>'''
+
 
+
:starts the template
+
 
+
'''<br/><nowiki>
+
{{ArmorList</nowiki><br/><nowiki>
+
| name =</nowiki><br/>
+
:The true, full name of the item as seen in-game, no shortcuts or abbreviations. All five miles of the name. Yep!
+
<nowiki>
+
| OPTIONAL PARAMETER =</nowiki><br/><nowiki>
+
| OPTIONAL PARAMETER = </nowiki><br/><nowiki>
+
(etc)</nowiki><br/>'''<nowiki>
+
}}</nowiki><br/><nowiki>
+
</nowiki>'''
+
 
+
:Body segment of template
+
 
+
 
+
'''<nowiki>
+
}}</nowiki><br/><nowiki>
+
{{Table/End}}</nowiki><br/><nowiki>
+
</nowiki>'''
+
 
+
:Ends the template (yes, for the encompassing background cell that keeps everything in line, the '''}}''' in addition to the '''<nowiki>{{Table/end}}</nowiki>''' is needed).
+
:Editors: Feel free to tidy this part up if you can, I tried, but it's a very sensitive template. Best of luck if you take on this endeavor!
+
 
+
===Optional===
+
The following all have "blank" as an option - in other words, you type in nothing. And I don't mean the word "nothing" haha! Actually nothing. Zip. Nada.
+
 
+
In fact, if the armor doesn't have one of these variables, it's best not to include it at all. You can, but the sheer number of items makes for very long pages, and empty parameters just means more data, even if they are empty. See examples in the [[#Usage|usage]] section below.
+
 
+
To see all options for these parameters, I've made a show/hide list below. In general, you'll be able to see what's available and how to word things based on this template's published presence in other pages, but for the sake of documentation done properly, I've put them here too.
+
 
+
;normal
+
:a value above 0, but no greater than 9.
+
;elemental
+
:a value above 0, but no greater than 9.
+
;piercing
+
:a value above 0, but no greater than 9.
+
;shadow
+
:a value above 0, but no greater than 9.
+
;curse=
+
:a value at or above -4, but no greater than +4.
+
;fire=
+
:a value at or above -4, but no greater than +4.
+
;freeze=
+
:a value at or above -4, but no greater than +4.
+
;poison=
+
:a value at or above -4, but no greater than +4.
+
;shock=
+
:a value at or above -4, but no greater than +4.
+
;sleep=
+
:a value at or above -4, but no greater than +4.
+
;stun=
+
:a value at or above -4, but no greater than +4.
+
;ability 1 =
+
:a line of text as appropriate
+
;ability 2 =
+
:a line of text as appropriate
+
;ability 3 =
+
:a line of text as appropriate
+
;penalty =
+
:a line of text as appropriate
+
 
+
== Usage ==
+
To organize gear into a sortable table so players old and new can find and compare item statistics regarding the following variables:
+
*Defenses (normal, elemental, piercing, shadow) - for helmets, armor, and shields
+
*Offenses (normal, elemental, piercing, shadow) - for bombs, handguns, and swords
+
*Health - for shields
+
*Attack Speed - for weapons
+
*Status Resistances and Weaknesses - for helmets and armors, with shields only being resistant
+
*Abilities - all gear item types
+
*Penalties - all gear item types
+
 
+
Additional information (such as recipe, where to get, and so on) can be found on individual pages of linked-to items.
+
 
+
See "templates used on this page" to modify entries for the following:
+
 
+
==General Data Entry==
+
 
+
 
+
==Future==
+
I've tried to design this template to be flexible, because Spiral Knights is a dynamic game that is somewhat like biology - it has rules, and then it breaks its own patterns. And we editors have a fun time dealing with that, don't we! To change variables, use the "replace" function in a simple program such as notepad - like icon size? Just REPLACE 36px with #px, and so on. This can be applied with varying levels of complexity (like with file names, replace "liquifier" with "slime killer" or whatever, just an example) as needed without breaking the numbering system of the template, so long as you don't forget those pesky brackets.
+
 
+
If more numbers than the following are ever seen (So far, the only defense (normal, elemental, piercing, shadow) bar values we see after quantifying via pixel counting are):
+
<br/>
+
<br/>
+
00.05<br/>
+
00.07<br/>
+
00.10<br/>
+
00.12<br/><br/>
+
01.07<br/>
+
01.11<br/>
+
01.12<br/>
+
01.14<br/><br/>
+
02.00<br/>
+
02.02<br/><br/>
+
04.00<br/>
+
04.04<br/>
+
04.05<br/>
+
04.06<br/><br/>
+
05.01<br/>
+
05.05<br/>
+
05.07<br/>
+
05.08<br/><br/>
+
06.05<br/>
+
06.13<br/><br/>
+
07.11<br/><br/>
+
08.13<br/><br/>
+
0 should never be entered and remain a blank space.
+
<br/><br/>
+
9 is used as a noteholder about how the stats image might not be fully informative about the item's performance, if the bar is completely full.
+
<br/><br/>
+
----
+
I have number values in this template and associated templates in a decimal place-holding system, so editors can add in new values without disrupting an entire numerically ordered column. Sometimes we get new stat bar values, so this flexibility is needed. But having the flexibility actively taking up space in the template all the time is not.
+
 
+
Remember that the '''class="sortable"''' type of table puts the least value near the top, unless specified with a <nowiki><span></nowiki> function like we've done. I worked with several other editors, namely Icytea, to get this table under control for both new and old player use. If looking at that wad of text in the template doesn't make sense and needs updating, take a gander at [http://en.wikipedia.org/wiki/Help:Sorting Wikipedia's Help Page for Sortable Coding].
+
 
+
If more abilities (or more levels of intensity of existing abilities) show up, add them to [[:Template:ListAbilities]] as well as the '''GEARTYPEList''' template - one is a text value translated into an icon (listabilities), the other is a text value translated into a sortable number (gearlist).
+
 
+
Finally, thanks for helping and reading this novel about this template! If you're still having trouble getting changes to work, or input values to work, then notify editors on the [http://forums.spiralknights.com/en/forum/14 Spiral Knights Wiki Editors Forums].
+

Latest revision as of 00:41, 17 June 2015

- relevant template has been replaced by Template:GearList/Defensive and its documentation.
Personal tools