GuildWiki

GuildWiki has been locked down: anonymous editing and account creation are disabled. Current registered users are unaffected. Leave any comments on the Community Portal.

READ MORE

GuildWiki
Register
(Replacing page with 'weeeeeeeeee')
m (Undo revision 1108908 by 67.159.47.202 (Talk))
Line 1: Line 1:
  +
{{style and formatting|[[GW:S&F]]<br/>[[GW:FORMAT]]}}
weeeeeeeeee
 
  +
This article covers information on proper '''style and formatting''' rules. For formatting of individual sections please see the links below.
  +
  +
The GuildWiki is a project to document and organize the world of Guild Wars as effectively as possible in the form of a [[Wikipedia:wiki|wiki]]. Everyone is welcome to contribute! An important part of creating such an exhaustive source of information is ensuring that the content is delivered in a pleasing and consistent manner. In order to achieve this, the GuildWiki community has worked to produce some standards on the format of the wiki. As they currently stand these standards are not set in stone, but they are considered 'good policy' and are recommended guidelines. If you have any suggestions for improving the standards please discuss them on the [[GuildWiki_talk:Style and formatting|talk page]] before implementing them.
  +
  +
==Getting started==
  +
Articles can generally describe
  +
*an object, such as an item or weapon
  +
*a [[Non-Player Character]], either friendly or hostile
  +
*a location
  +
*a guide on how to do something, such as a quest or mission
  +
*a collection of all of the above in a category
  +
  +
All are welcome to update the wiki. But before you write your article, it's best to double check that an article does not already exist on the subject. You can do so by making use of the search bar on the left. If you are unsure, make use of the discussion link that appears at the top of every article, allowing you to discuss that article.
  +
  +
If you click on a red link you will be prompted with the choice to start writing a new article on the subject. You can also start a new article by clicking on the "edit" link at the top of an article with no content. For an understanding of the wiki code necessary to format a page please read the [[GuildWiki:editing guide]].
  +
  +
===Unknown information===
  +
In some cases, you won't have all the information at hand. If this is the case, please do not fill in information with guesses or approximations. No information at all is better than inaccurate information! This is especially true for numerical details, such as damage ranges, but might not always apply to descriptions. If you can only remember an approximate description then in most cases this may suffice, but please use your discretion.
  +
  +
Please '''omit''' sections that you do not have the information about. For example, most skills should have an "Acquisition" section. If you don't know how to acquire a given skill, then please do not fill in this section with "to be completed" or "unknown". Instead, simply leave the section out and readers will understand that this information is not yet known.
  +
  +
== Article naming ==
  +
Whenever applicable, the exact wording and capitalization should match whatever is used by the game. If it is more common among players to use a different name than the official in-game name, make the player-slang a redirect.
  +
  +
=== Disambiguating article names ===
  +
When multiple things have the same name but are to be placed in different articles, use disambiguation tags, like this: '''Name (disambiguation tag)'''. The disambiguation tags should be sufficiently specific to distinguish each article sharing the same name, but no more specific than necessary.
  +
  +
If the popularity/usage/commonality of one of the things that compete for the same name overwhelmingly dominates the others, its article may simply be named as '''Name''' without disambiguation.
  +
  +
In all cases, the '''Name''' article should contain, at the very top of the page, links to all the '''Name (disambiguation tag)''' articles.
  +
  +
==Format and style==
  +
The following sections are brief summaries of some common formatting and styling issues.
  +
  +
===General notes===
  +
When working on an article, there are some points to consider. Try to think about whether this article topic is too generic. If the topic of the article you are working on is too generic then it is likely to grow extremely large. To avoid this try splitting the article up into its constituent parts. For example, an article on [[human]]s in Guild Wars doesn't need to contain details of every human in the game. Looking at the headings of sections in an article is a good indication of how the article can be split up.
  +
  +
===Linking===
  +
When writing an article, linking ''to'' the current article from itself will embolden the text within the link. For example <nowiki>[[GuildWiki:Style and formatting]]</nowiki> in any other article will produce a link, but in this article it will appear bolded like this: [[GuildWiki:Style and formatting]]. After discussion, it has been decided that linking to articles from within articles is preferable, as it produces semantically accurate documents.
  +
  +
When making links to other articles, it's best to only link the first instance of a word for each section or portion of the article. So if you are talking about [[skill]]s, then don't link to that page every time you repeat the word 'skills'. Only repeat the link in a different section that's considerably further down the page from the initial link. This also applies when making 'recursive' links, or links from the current article to the current article, as in the above example.
  +
  +
===Upper and lower case===
  +
When in doubt, [[GuildWiki:use lower case|use lower case]]. This includes in article headings, article titles, and category names.
  +
  +
===Boxes===
  +
Many articles that discuss an object or character in the game make use of boxes. At the moment only the skill box had been rigorously standardised, but items, weapons and creatures are currently undergoing a similar process. In order to avoid confusion, the following colors should be used:
  +
  +
{| border=1 width=50%
  +
|-
  +
! Article Type !! Color
  +
|- align="center"
  +
| Creatures, Monsters and Characters
  +
|style="background: gold" | gold &#42;
  +
|- align="center"
  +
| Items (other than Weapons and Armor)
  +
|style="background: lightblue" | lightblue
  +
|- align="center"
  +
| Locations
  +
|style="background: thistle" | thistle &#42;
  +
|- align="center"
  +
| Skills
  +
|style="background: lightgreen" | lightgreen
  +
|- align="center"
  +
| Weapons and Armor
  +
|style="background: #F99;" | #F99
  +
|}
  +
  +
&#42; These colors are suggested.
  +
  +
When designing new boxes, try to pick colors that differ as much as possible from those already in place, but are still light enough that you can read black text on top of it. Try to keep to the list of [[Wikipedia:X11_color_names|accepted X11 color names]].
  +
  +
==Structure and organization==
  +
The following sections provides general guidelines on the structure and organization of an article.
  +
  +
=== Introductory text ===
  +
Articles should not begin with a subsection containing general descriptions. Such introductory text should be in "section 0" of the article, that is, the top of the article before any section headings. Such text will be displayed at the top of an article, before the table of contents (if there is one). Articles should generally not begin with sections.
  +
  +
===Categorization===
  +
Category links should be placed at the end of an article. Since actual category links appear at the bottom of a page, it is more logical for the category links to be located at the bottom. Consult each of the separate guidelines pages for more guidelines regarding categorization. Having the category links at the top of an article has the side effect of causing unnecessary white spaces (i.e. blanks) when spaced incorrectly.
  +
  +
===Ordering===
  +
The order of different elements within a article help maintain consistency across articles of the same nature.
  +
*'''Sections:''' Follow the order and names specified in the appropriate guidelines.
  +
*'''Professions:''' [[Warrior]], [[ranger]], [[monk]], [[necromancer]], [[mesmer]], [[elementalist]], [[assassin]], [[ritualist]], [[paragon]], [[dervish]]. ''(in the order they appear on the character creation screen)''
  +
  +
==Other notes==
  +
*When archiving keep to '''Page_name/Archive_X''', X being the number
  +
*When documenting availability (of quests, items, skills etc), use the name of the [[campaign]] ([[Prophecies]], [[Factions]], etc.) instead of the name of the [[continent]] that most/all of the Campaign take place on. Use continent names only when discussing lore or geography.
  +
  +
[[Category:Helping out]]

Revision as of 02:47, 8 December 2007

Style guides



Blue check

This page is a style and formatting guideline on GuildWiki.

It has general acceptance among editors and is considered a standard to which articles should adhere. However, it is not set in stone and should be treated with common sense and the occasional exception.

Shortcut:
GW:S&F
GW:FORMAT

This article covers information on proper style and formatting rules. For formatting of individual sections please see the links below.

The GuildWiki is a project to document and organize the world of Guild Wars as effectively as possible in the form of a wiki. Everyone is welcome to contribute! An important part of creating such an exhaustive source of information is ensuring that the content is delivered in a pleasing and consistent manner. In order to achieve this, the GuildWiki community has worked to produce some standards on the format of the wiki. As they currently stand these standards are not set in stone, but they are considered 'good policy' and are recommended guidelines. If you have any suggestions for improving the standards please discuss them on the talk page before implementing them.

Getting started

Articles can generally describe

  • an object, such as an item or weapon
  • a Non-Player Character, either friendly or hostile
  • a location
  • a guide on how to do something, such as a quest or mission
  • a collection of all of the above in a category

All are welcome to update the wiki. But before you write your article, it's best to double check that an article does not already exist on the subject. You can do so by making use of the search bar on the left. If you are unsure, make use of the discussion link that appears at the top of every article, allowing you to discuss that article.

If you click on a red link you will be prompted with the choice to start writing a new article on the subject. You can also start a new article by clicking on the "edit" link at the top of an article with no content. For an understanding of the wiki code necessary to format a page please read the GuildWiki:editing guide.

Unknown information

In some cases, you won't have all the information at hand. If this is the case, please do not fill in information with guesses or approximations. No information at all is better than inaccurate information! This is especially true for numerical details, such as damage ranges, but might not always apply to descriptions. If you can only remember an approximate description then in most cases this may suffice, but please use your discretion.

Please omit sections that you do not have the information about. For example, most skills should have an "Acquisition" section. If you don't know how to acquire a given skill, then please do not fill in this section with "to be completed" or "unknown". Instead, simply leave the section out and readers will understand that this information is not yet known.

Article naming

Whenever applicable, the exact wording and capitalization should match whatever is used by the game. If it is more common among players to use a different name than the official in-game name, make the player-slang a redirect.

Disambiguating article names

When multiple things have the same name but are to be placed in different articles, use disambiguation tags, like this: Name (disambiguation tag). The disambiguation tags should be sufficiently specific to distinguish each article sharing the same name, but no more specific than necessary.

If the popularity/usage/commonality of one of the things that compete for the same name overwhelmingly dominates the others, its article may simply be named as Name without disambiguation.

In all cases, the Name article should contain, at the very top of the page, links to all the Name (disambiguation tag) articles.

Format and style

The following sections are brief summaries of some common formatting and styling issues.

General notes

When working on an article, there are some points to consider. Try to think about whether this article topic is too generic. If the topic of the article you are working on is too generic then it is likely to grow extremely large. To avoid this try splitting the article up into its constituent parts. For example, an article on humans in Guild Wars doesn't need to contain details of every human in the game. Looking at the headings of sections in an article is a good indication of how the article can be split up.

Linking

When writing an article, linking to the current article from itself will embolden the text within the link. For example [[GuildWiki:Style and formatting]] in any other article will produce a link, but in this article it will appear bolded like this: GuildWiki:Style and formatting. After discussion, it has been decided that linking to articles from within articles is preferable, as it produces semantically accurate documents.

When making links to other articles, it's best to only link the first instance of a word for each section or portion of the article. So if you are talking about skills, then don't link to that page every time you repeat the word 'skills'. Only repeat the link in a different section that's considerably further down the page from the initial link. This also applies when making 'recursive' links, or links from the current article to the current article, as in the above example.

Upper and lower case

When in doubt, use lower case. This includes in article headings, article titles, and category names.

Boxes

Many articles that discuss an object or character in the game make use of boxes. At the moment only the skill box had been rigorously standardised, but items, weapons and creatures are currently undergoing a similar process. In order to avoid confusion, the following colors should be used:

Article Type Color
Creatures, Monsters and Characters gold *
Items (other than Weapons and Armor) lightblue
Locations thistle *
Skills lightgreen
Weapons and Armor #F99

* These colors are suggested.

When designing new boxes, try to pick colors that differ as much as possible from those already in place, but are still light enough that you can read black text on top of it. Try to keep to the list of accepted X11 color names.

Structure and organization

The following sections provides general guidelines on the structure and organization of an article.

Introductory text

Articles should not begin with a subsection containing general descriptions. Such introductory text should be in "section 0" of the article, that is, the top of the article before any section headings. Such text will be displayed at the top of an article, before the table of contents (if there is one). Articles should generally not begin with sections.

Categorization

Category links should be placed at the end of an article. Since actual category links appear at the bottom of a page, it is more logical for the category links to be located at the bottom. Consult each of the separate guidelines pages for more guidelines regarding categorization. Having the category links at the top of an article has the side effect of causing unnecessary white spaces (i.e. blanks) when spaced incorrectly.

Ordering

The order of different elements within a article help maintain consistency across articles of the same nature.

Other notes

  • When archiving keep to Page_name/Archive_X, X being the number
  • When documenting availability (of quests, items, skills etc), use the name of the campaign (Prophecies, Factions, etc.) instead of the name of the continent that most/all of the Campaign take place on. Use continent names only when discussing lore or geography.