Project Gorgon Wiki:Formatting

From Project: Gorgon Wiki
Revision as of 11:05, 26 October 2014 by Gorgonzola (talk | contribs) (Expanded a little bit)
Jump to: navigation, search

This page and the associated talk page is to help editors agree on conventions for standardized formatting of the articles. This should helps us reduce the number of edits, avoid arguments, and have a really good wiki on the long run.

It's the early days of the wiki during alpha. Much of this is still up for discussion (Talk:Project Gorgon Wiki:Formatting).

Please note as of writing some of the wiki content does not follow the guidelines. Whether it makes sense to rename articles and categories I don't know. The idea is to try to be consistent from here on.

General formatting

As some of these conventions can be considered preferences, which style we agree to is not very important, but I think consistency is good. If you don't like some of these conventions make suggestions in the talk page.

Capitalization

Capitalize only proper nouns as a general rule (a noun describing a unique entity). This includes: named creatures (bosses), unique items, zones, dungeons, etc.

Headings: use normal sentence case (eg. "How to learn"), except for proper nouns mentioned in the heading.

Categories: likewise use capitalization only for proper nouns (eg. "Kur Mountains NPCs"), and not for common nouns (eg. "Skill trainers").

Article names

Use the exact in-game spelling for skills, locations, quests, items, etc (all proper nouns of in-game unique entities).

Use the same name as the in-game "label", with the exact same punctuation and capitalization, generally in singular.

Categories

Category names in general should use the plural form, eg. "Zones", "Bosses".

Anatomy-related categories (Arthropod, Goblin, Orc, etc.) currently use the singular form.

Category structure

(this may move to a new page if it becomes too complex)

Category:Zones
Category:Dungeons
Category:Bosses
Category:Elite (Elite Bosses)
Category:NPCs
Category:Serbule NPCs
Category:Eltibule NPCs
Category:Kur Mountains NPCs
etc.
Category:Skills
Category:Beast Forms
Category:Combat Skills
Category:Other Skills
Category:Trade Skills

Article guide pages

The following pages have been created to ducment the desired structure of the articles. Note that not every section of the page needs to be in the articles. They are an example page in which we can discuss what the structure of the articles should look like. These should be used as a guide for creating new articles. For now I recommend to "watch" the pages below (click the star icon). It helps, as we otherwise don't get notifications when commenting in the talk pages.

Templates

See Category:Template demos for examples. See Formatting templates category for a full list of templates you can use.

If you have some template ideas, or something you'd like, drop me a message at User talk:Gorgonzola.

Template Demos Description
Quote Demos Quote in-game text (NPC talk, lore items, etc) and official sources.
Hint - Hides light spoilers inside a tooltip. This helps keep the layout nice as these fit "inline". Keep these hints short because they appear as a tooltip. You can not use double quotes inside, use single quotes 'like this'.
Spoiler - Hide big spoilers in a collapsible block. Unfortunately we can not format a table inside those! Consider using lists (bullet lists, definition lists).
ItemT Demos This is a fun template that gives the appearance of an in-game item description. Its goal is to liven up the pages with some visuals. As for all templates, its value is that we can change the appearance later for many pages just by editing the template, so if the in-game appearance change, that is not a problem. Icons are not yet supported until the Wiki has better Extensions installed (a default "empty" icon is used).
MOB infobox - Create an attractive "infobox" (as is commonly used in Wikipedia) for enemies and bosses. This is another way to liven up the pages. The info card does not document everything as that is in the body of the article. TODO More parameters will be added but are limited atm due to lack of proper Wiki Extensions.
MAP infobox - Create an attractive "info card" for dungeons and sub-areas (do not use for zones yet, may use a different template).

Quotation

For developer text, please use Template:Quote and specify the source URL. See Quote Template Demos for examples.

In-game text in general should be "quoted and italicized". Use the Quote template if it fits.