Difference between revisions of "Help:Style guide"

From SpiralKnights

Jump to: navigation, search
m (Videos)
m (added, and this needs to be updated in general.)
Line 1: Line 1:
 +
{{update|General guidelines and more useful links coming soon.}}
 +
 
Defer questions of style to [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style The Wikipedia Manual of Style].
 
Defer questions of style to [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style The Wikipedia Manual of Style].
  
== Article Names ==
+
==Wiki Navigation==
 +
===Redirects===
 +
[[SpiralKnights:Redirect]] - list of reasons to redirect, and how to tag them.
 +
 
 +
===Categories===
 +
Whenever fitting, articles should be categorized.
 +
See [[Special:Categories]] for a list of categories.
 +
 
 +
==Naming Convention==
 +
===Articles===
  
 
Here are some guidelines for general pages:
 
Here are some guidelines for general pages:
Line 9: Line 20:
 
As a game, Spiral Knights has its own special names, so the Wikipedia guidelines will not always be appropriate.
 
As a game, Spiral Knights has its own special names, so the Wikipedia guidelines will not always be appropriate.
  
== File Names ==
+
===Files (Images)===
  
Uploaded files should be named clearly and plainly. All images should have the appropriate [[SpiralKnights:Image_tags|image tag]] included in the file description.  The preferred image format is PNG.  For images created by the Spiral Knights community, please follow the following naming conventions:
+
Uploaded files should be named clearly and plainly. All images should have the appropriate [[SpiralKnights:Image_tags|image tag]] included in the file description.  The preferred image format is PNG.  For images created by the Spiral Knights community, please follow the following naming conventions:
  
 
* '''''Bomb_Name''_blast_radius.png''' - Used for bomb radius images
 
* '''''Bomb_Name''_blast_radius.png''' - Used for bomb radius images
Line 22: Line 33:
 
* '''''Vendor_Name''-Mugshot.png''' - Used for vendors
 
* '''''Vendor_Name''-Mugshot.png''' - Used for vendors
  
== Templates ==
+
==Templates==
 
+
 
=== Infoboxes ===
 
=== Infoboxes ===
 
:'''Gear''':
 
:'''Gear''':
Line 40: Line 50:
 
* {{tlist|Monster}} - For [[Monster]]s
 
* {{tlist|Monster}} - For [[Monster]]s
  
=== Table of Contents ===
+
===Table of Contents===
 
* {{tlist|TOCright}} - For moving the TOC to the right
 
* {{tlist|TOCright}} - For moving the TOC to the right
 
* {{tlist|CompactTOC}} - For an ABC type TOC to replace the standard type.  Used for alphabetical lists.
 
* {{tlist|CompactTOC}} - For an ABC type TOC to replace the standard type.  Used for alphabetical lists.
  
=== Other ===
+
===Other===
 
* {{tlist|SKLink}} - For making links visible in tables with dark backgrounds
 
* {{tlist|SKLink}} - For making links visible in tables with dark backgrounds
 
* {{tlist|Star}} - For showing the star rating graphically
 
* {{tlist|Star}} - For showing the star rating graphically
  
== Screenshots and Images ==
+
==Images (How they should look)==
 +
===Tooltips===
 
*An "Item equipped" image in an infobox represents an item as it appears in the tool-tip rotation in-game. Images should generally be the first clear frame of the tool-tip unless the item is obscured (as with certain accessories). Alternate angles should be shown in a gallery elsewhere on the page.  
 
*An "Item equipped" image in an infobox represents an item as it appears in the tool-tip rotation in-game. Images should generally be the first clear frame of the tool-tip unless the item is obscured (as with certain accessories). Alternate angles should be shown in a gallery elsewhere on the page.  
  
 
:Due to how the game has changed overtime, filenames might seem to be...inaccurate. Images were uploaded (for quite a long time) to file destinations that had "equipped" in the name, because being "worn" or "equipped" was the only consistent view available at the time. Later on, tool-tip rotations were introduced. Since it would require a large chunk of time to change existing filenames (either by moving or reuploading), and nobody actually sees these filenames on published pages, the "inaccurate" naming convention remains.
 
:Due to how the game has changed overtime, filenames might seem to be...inaccurate. Images were uploaded (for quite a long time) to file destinations that had "equipped" in the name, because being "worn" or "equipped" was the only consistent view available at the time. Later on, tool-tip rotations were introduced. Since it would require a large chunk of time to change existing filenames (either by moving or reuploading), and nobody actually sees these filenames on published pages, the "inaccurate" naming convention remains.
  
 +
===Weapons===
 
*Bomb blast radius images are usually taken in a standard reference location, to facilitate comparisons between different bombs.  
 
*Bomb blast radius images are usually taken in a standard reference location, to facilitate comparisons between different bombs.  
 
:The preferred location is the depth 4 Clockworks Terminal, please see the current radius screenshots for the specific square (to the left of one with a spiral).
 
:The preferred location is the depth 4 Clockworks Terminal, please see the current radius screenshots for the specific square (to the left of one with a spiral).
 
:The image usually shows the white circles that appear before the bomb detonates - this keeps the image from being obscured by complex animations. "Shard" bombs (such as the crystal bomb) have a very small "blast radius", and may be better represented by an image showing the distance that shards travel.
 
:The image usually shows the white circles that appear before the bomb detonates - this keeps the image from being obscured by complex animations. "Shard" bombs (such as the crystal bomb) have a very small "blast radius", and may be better represented by an image showing the distance that shards travel.
  
 +
===Spiral Spy===
 
Spiral Spy images should never be uploaded to the wiki, no matter the circumstances.
 
Spiral Spy images should never be uploaded to the wiki, no matter the circumstances.
 
== Categories ==
 
Whenever fitting, articles should be categorized.
 
See [[Special:Categories]] for a list of categories.
 
  
 
==Videos==
 
==Videos==

Revision as of 20:51, 14 March 2015

Pencil.gif This article needs to be updated.
Parts of this article are inaccurate and/or no longer up to date. Please update it to reflect recent events, and remove this template when finished.

Reason(s): General guidelines and more useful links coming soon.

Defer questions of style to The Wikipedia Manual of Style.

Wiki Navigation

Redirects

SpiralKnights:Redirect - list of reasons to redirect, and how to tag them.

Categories

Whenever fitting, articles should be categorized. See Special:Categories for a list of categories.

Naming Convention

Articles

Here are some guidelines for general pages:

As a game, Spiral Knights has its own special names, so the Wikipedia guidelines will not always be appropriate.

Files (Images)

Uploaded files should be named clearly and plainly. All images should have the appropriate image tag included in the file description. The preferred image format is PNG. For images created by the Spiral Knights community, please follow the following naming conventions:

  • Bomb_Name_blast_radius.png - Used for bomb radius images
  • Crafting-Item_Name.png - Used for crafting item icons
  • Equipment-Item_Name icon.png - Used for equipment item icons (armor, helmets, shields, weapons)
  • Equipment-Item_Name Stats.png- Used for equipment stats (armor, helmets, shields, weapons)
  • Item_Name-Equipped.png - Used for equipped items (armor, helmets, shields, weapons)
  • Item_Name-Equipped 2.png - Used for alternate angles (armor, helmets)
  • Monster-Monster_Name.png - Used for monsters (128x128px)
  • Vendor_Name-Mugshot.png - Used for vendors

Templates

Infoboxes

Gear:
Aesthetics:
Other:

Table of Contents

  • {{TOCright}} (Usage) - For moving the TOC to the right
  • {{CompactTOC}} (Usage) - For an ABC type TOC to replace the standard type. Used for alphabetical lists.

Other

  • {{SKLink}} (Usage) - For making links visible in tables with dark backgrounds
  • {{Star}} (Usage) - For showing the star rating graphically

Images (How they should look)

Tooltips

  • An "Item equipped" image in an infobox represents an item as it appears in the tool-tip rotation in-game. Images should generally be the first clear frame of the tool-tip unless the item is obscured (as with certain accessories). Alternate angles should be shown in a gallery elsewhere on the page.
Due to how the game has changed overtime, filenames might seem to be...inaccurate. Images were uploaded (for quite a long time) to file destinations that had "equipped" in the name, because being "worn" or "equipped" was the only consistent view available at the time. Later on, tool-tip rotations were introduced. Since it would require a large chunk of time to change existing filenames (either by moving or reuploading), and nobody actually sees these filenames on published pages, the "inaccurate" naming convention remains.

Weapons

  • Bomb blast radius images are usually taken in a standard reference location, to facilitate comparisons between different bombs.
The preferred location is the depth 4 Clockworks Terminal, please see the current radius screenshots for the specific square (to the left of one with a spiral).
The image usually shows the white circles that appear before the bomb detonates - this keeps the image from being obscured by complex animations. "Shard" bombs (such as the crystal bomb) have a very small "blast radius", and may be better represented by an image showing the distance that shards travel.

Spiral Spy

Spiral Spy images should never be uploaded to the wiki, no matter the circumstances.

Videos

"You may post videos in the "external links" section of a wiki page, or on your own user page, provided that the video does not contain material that violates our Terms of Service. It's fine if the video you're linking is monetized, but the YouTube description must credit SEGA and Three Rings, and must provide a link back to our game." - Spiral Knights Support, 09 March 2015

Wikipedia MoS regarding "external links." Importantly:

Do not include the external link in the body of the article.
Keep the list short (on this wiki, it will usually be one demonstrative video).

Embedding videos seems to currently have technical issues.

Personal tools