NetHackWiki:Style guide
Wikihack has no formal style guide as of yet, but there are a few conventions in use.
Contents
Coloured NetHack glyphs
Use the 16-colour function templates for displaying individual monster symbols. They're padded, so they don't work for making ASCII screenshots. Yet.
Tables
Template:prettytable can be used like this:
{|class="prettytable"
!Header 1
!Header 2
|-
|Cell 1
|Cell 2
|-
|Cell 3
|Cell 4
|}
to make this:
| Header 1 | Header 2 |
|---|---|
| Cell 1 | Cell 2 |
| Cell 3 | Cell 4 |
Item pages
Put the templates Template:scroll, Template:potion, Template:ring, Template:wand, Template:spellbook, Template:weapon, Template:armor, and Template:tool at the top of the appropriate item page, or Template:item for any other type of item.
Caveat: these templates may not exist yet...
Each item page should also list the effects of the item, and any messages that item can generate. Tips and strategy relating to that item should go next, and if there is an entry from the nethack encyclopedia, that can go at the bottom. Use potion of object detection, scroll of amnesia and scroll of genocide as guides.
Source code
When writing a piece of factual information, you may wish to document it by linking to the source code like this:
The vibrating square level is not eligible to leave bones files <ref>[[bones.c#line32]]</ref>.
which looks like this:
The vibrating square level is not eligible to leave bones files [1].
Make sure you include a <references/> tag at the bottom of the page, to create a list of footnotes:
Annotations
If you are a source diver, you can add annotations to any source file simply by putting your comments below the relevant line. Try to limit annotations to explanations of the source code; long discussions belong on the Talk page.
Other useful templates
{{DOD}} should go at the bottom of every page which is based on a spoiler by Dylan O'Donnell.
{{disambig}} should go at the bottom of every disambiguation page, e.g. Fire
Namespaces
Anything to do with NetHack belongs in the main article space. Anything to do with Wikihack belongs in the Wikihack namespace.
User pages
You can create a vanity page in the main namespace if you want to, but unless you are famous or otherwise notable it would be a better idea to create a Wikihack account and put personal information on your own User page.
General principles
- Article pages (those in the main namespace) are not strictly NPOV (as the suitability of many strategies are a matter of opinion), but they should be broadly factual.
- If in doubt, consider Wikipedia's policies on the matter; they're pretty good.
