Owl.png Wiki reading hard on the eyes? Try out our Dark Theme! Visit the preferences page while logged in and select Hydra Dark. Owl.png

Terraria Wiki:Style Guide

From Terraria Wiki
Jump to: navigation, search

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, Roman candle), groups of items should be lower-cased (e.g. bars, bullet). Note that there are edge cases where the plural of an item name is the same as the name of an item group, e.g. Chests (refers to multiple of the standard, wooden Chest item) vs. chests (refers to any chest), Seeds (refers to multiple of the Seed ammunition item) vs. seeds (refers to the group of items that are to be planted in the ground).
  • Page titles and section headings should be in sentence case. The above rule still applies.
  • The first instance of an entity name on a page should always be linked, via double brackets (e.g. [[Iron Broadsword]]). This does not apply to the page title (which should be in proper bold instead; see below). 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.