Brighter Shores:Style guide/Layout

From Brighter Shores Wiki
Revision as of 03:28, 25 November 2024 by Mudscape (talk | contribs) (→‎Section order)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This style guide on page layout is a style guide used to determine the overall layout and ordering of pages.

Writing style

Imperative form

Always use the imperative (command) form when possible. This allows the guide to use neither the first nor third person tenses.

Incorrect:
You must now talk to Captain Jal Degreene to continue the quest. She is located in Captain Degreene's Office.

Correct:
Talk to Captain Jal Degreene to continue the quest. She is located in Captain Degreene's Office.

Layout

Use common sense when needed, but the following section outline describes how an article should be structured. This does not include everything, but it is an indicator of how an item article could look like. This default was made to create more consistency between articles. Although it is meant to provide a general structure, it may be deviated from if necessary.

Header

Header templates (see Brighter Shores:Style guide/Wiki code#Orders for an example)

  • Line type header templates
  • Bar type header templates

Body

Entity Examples Notes
Main infobox {{Infobox Item}}

{{Infobox Monster}}

See this category for an exhaustive list.
Article introduction A bucket is container ... The subject should be emboldened and include the most relevant information about the item in the first sentence.
Article-specific sections Analysis

Effects

For articles about an equipped item, place the Combat stats section before the article-specific sections.

Section order

Sections should be level 2 headings and adhere to the order outlined below. Some sections may not be relevant to the article and thus should not be included.

Section name Must include Notes
Combat stats {{Infobox equipment}}/{{Infobox weapon}}
Creation {{Infobox Recipe}}
Products {{Products}}
Item sources {{ItemSources}}
Shop locations {{ShopList}} Should be a subsection if the "Item sources" section is present.
History
Transcript
Dialogue
{{HasTranscript}}
Gallery <gallery></gallery>
Update history {{UH}} and {{UL}} One or more update list item ({{UL}}) must be passed as an argument to the update history template ({{UH}}). See the documentation for more information on formatting.
Trivia Bulleted list
See also
References {{Reflist}}
External links

Images

Images should complement the article and occasionally should supplement the article (in the case of maps, etc). Images should be right-aligned. However, centre-alignment can be used for some images in the articles, such as maps or left-aligned when the right side is cluttered or when it is more fitting.

Footer