Terraria Wiki:Style Guide

From Terraria Wiki
Jump to: navigation, search
See also Terraria Wiki:Rules.

The following is a guide to creating or editing mainspace pages at Terraria Wiki in accordance with the established article style. It describes accepted and established practices at Terraria Wiki, and should not be used to impose changes to the wiki. These guidelines are not set in stone, but they should generally be followed in order to maintain consistency across pages, unless there is a good reason to make an exception.

Page types

Different page types require different page formats. See the following examples:

General guidelines

  • The name of the page should be plural if it is a list of entities which are named differently (e.g. Work Benches), otherwise, it should be singular (e.g. Armored Skeleton).
  • All entity names should be capitalized as in-game (e.g. Iron Broadsword).
  • The first instance of an entity name on a page should always be linked, via double brackets (eg. [[Iron Broadsword]]). Further mentions of the same entity should generally not be linked, though multiple identical links can exist if they occur far from each other and would be helpful to readers. An example might be one link in the introductory section along with an identical link in a section, table, or template occurring further down. Duplicate links may be especially helpful on larger pages that would require scrolling to find an entity's first mention.
  • Be sure to read the page before editing. Editors frequently add notes, tips, and trivia items that duplicate information already contained in the article's paragraphs above.

Formatting guidelines

  • The first instance of the page title should be bold. This should usually be in the first sentence of the article. No other instance of the page title should be bold. To make a word or phrase bold, place three apostrophes (') on each side. For example: '''bold'''. Bold print should usually be avoided for emphasis on other words. Instead, italic print (two apostrophes) is preferred.
  • Template calls should be lower-cased (i.e. {{item}} instead of {{Item}}). Navigational templates, however, are to be called upper-cased (i.e. {{Biomes}} instead of {{biomes}}). This facilitates distinguishing these two types of templates in the source code.
  • Times of day are to be formatted as in-game, i.e., in a 12-hour clock hh:mm{{nbsp}}AM/PM format. Hours do not have a leading zero.
  • When displaying dimensions, multiplication in formulas, etc. the multiplication sign × is the proper operator. The letter x is mathematically not correct.

Standard sections

Here is a simple rundown of sections an article can include. For examples based on the article type, see Page types above.

The lead (or intro) section of a page should describe the article topic. For instance, for items, describe the item and state how it is acquired.

Any or all of the following additional sections can be included in an article. They should generally be in the order they are presented in below. Sections are added via == Section Title ==. For example, == Notes == would add a "Notes" section.

  • Notes: Bulleted list of short facts about the article topic.
  • Tips: Bulleted list of helpful hints regarding effective practices and what to avoid.
  • Trivia: Bulleted list of facts relating to the article topic, which may be interesting but have no bearing on the game. Explaining the etymology of an item name could be one example. See trivia rules for an expanded guide to Trivia sections.
  • See also: Bulleted list of related articles. Pages which are already linked to should not be mentioned here another time.
  • History: List of changes to the article topic from various game updates, with each item using the {{history}} template. A history section should almost always be included, with at least one item stating which update introduced the game element. Should also be the only location acknowledging game updates that have caused introductions or modifications of page content.
  • References/Footnotes: Put {{reflist}} here, if necessary. If there is no actual reference (i.e. link to a source) among the <ref>s, "Footnotes" is the more appropriate section title.

Guides

Guides can cover a wide array of subject matter, so a single blanket template cannot be applied to all of them. Nevertheless, do see Terraria Wiki:Rules#Guides for guidelines concerning these pages.

Trivia

See the trivia rules for guidance on trivia sections.