Help:Style manual: Difference between revisions

Character articles use the character's full name (first name and last name), without any titles, aliases or nicknames. Titles and aliases can be described in the text of the article. If a title or alias is very frequently used in-game, consider adding a redirect for it.  

# Notices: {{t link|Priority}}, {{t link|Stub}},  {{t link|Under construction}}, {{t link|Rewrite}}.

# Content and spoiler warnings

# Infoboxes: {{t link|Infobox character}}, {{t link|Infobox statistics}}, {{t link|relative location}}

# Images

# Gallery: A section with a <nowiki><gallery></nowiki>.

# Footnotes: A section with a {{t link|notelist}} template (see [[Help:Style manual#Footnotes and references|below]]).

# References: A section with {{t link|reflist}} templates (see [[Help:Style manual#Footnotes and references|below]]).

Character articles typically have a {{t link|Infobox character}} template, {{t link|Infobox statistics}} template, and a {{t link|Companion tab}} or {{t link|Combat tab}} template.

# Overview: A brief summary of the article as a whole for quick access to specific information.

## Background: A brief introduction to the character and their role in the game.

## Gameplay: A bulleted list of the character's gameplay role (vendor, boss, where they are found, etc.).

## Quests: Any quests that the character is involved in.

# History: The character's backstory before the events of the game. Particularly long history sections can be broken down into relevant subsections.

## Spells and abilities: Abilities and spells used by the character in combat.

## Loot: Any items that can be looted from the character.

# A description of the location of the item - or the source, if it's a quest reward or sold by a vendor

#* Include both {{em|broad}} and {{em|specific}} information in this description, as needed (e.g. "Found in Act One in the Underdark. The sword is near the [[Selûnite Outpost]], embedded in a rock (X:116, Y:-192).")

# Map coordinates of the item, if applicable, in the format ''(X:123, Y:123)''

#* This can be done in the form of the {{t link|coords}} template: <nowiki>{{Coords|123|123}}</nowiki>

Lengthy instructions can be formatted with sublists, as necessary:

* Can be found near the sign that says "Here Lies Our Dear Leader", after solving the Torch Puzzle.

When an item can be found in multiple places, list '''all''' known locations. ''Exception:'' For common and very plentiful items, don't worry about documenting every location via text. Instead, consider working with other wiki editors to generate a map of all locations or include a link to an external map resource.

{{hatnote|See the [[BG3Wiki:Glossary|glossary]] for common examples of abbreviations used on BG3Wiki.}}

Capitalise proper nouns and adjectives when appropriate, but avoid unnecessary capitalisation.

Specific in-game items, spells, characters and locations should also inherit the game's capitalisation.

Do not generally capitalise game concepts, mechanics, terminology or rules.

The following abbreviations should always be capitalised: AC, DC, NPC and abbreviation of abilities (STR, DEX, CON etc).

* Classifications of weapons and armour (Longsword, Light armour).

** Exceptions: These terms should not be capitalised when the terms are used descriptively (eg. with no mechanical significance).

* The item categories Consumables, Miscellaneous and Valuables are capitalised when used standalone.

* Specific actions (Attack action, Hide action)

** Subclasses are considered class features, and are therefore also capitalised (Champion, Wildheart)

Do {{em|not}} capitalise the following terms:

* Names of classes (barbarian, fighter).

* Spell schools (abjuration, necromancy).

 

** This includes specific individual creatures, which may have identical names to their race (which is not capitalised) – eg. the creature Mind Flayer Leader is a mind flayer.

Names of articles should be capitalised on other pages when they referred to as an article, but not when they are simply linked to.

* Names of vessels and ships, but not the nautiloid ship.

Use {{code|<nowiki>{{em}}</nowiki>}} or {{code|<nowiki><em>...</em></nowiki>}} for emphasis, for example to place emphasis (stress) on a certain word in a sentence, or to clarify the meaning of a sentence. In most cases, you should only use emphasis one <em>one</em> word per sentence. Never use apostrophes for emphasis.

When writing sections of articles that make frequent or confusing use of terminology such as ''the player'', second-person perspective should be used instead, for consistency and readability:

* {{SmallIcon|greencheck.png}} You cannot enter this location if in a multiplayer session with another player that is controlling Astarion, unless you have the key as well.

** {{SmallIcon|redx.png}} The player cannot enter this location if in a multiplayer session with another player that is controlling Astarion, unless they have the key as well.

* {{SmallIcon|greencheck.png}} The player will always enter this location from the east entrance.

** {{SmallIcon|redx.png}} You will always enter this location from the east entrance.

''Never use first-person perspective in the main wiki namespace'', even when making conjectures. If a statement is tentative and needs to be verified, that's okay - simply include the {{code|<nowiki>{{Verify}}</nowiki>}} template to let readers and other wiki editors know.

* {{SmallIcon|greencheck.png}} This is also dropped by John Baldursgate.{{Verify}} ({{SmallIcon|redx.png}}I think this is also dropped by John Baldursgate.)

''Exception for guides:'' When writing content for the [[:Category:Guides|Guide:]] namespace, feel free to write subjectively and from any perspective. This namespace is your place to interject your opinions and recommendations for players. Additional guidelines tailored for this namespace may be added at a later date.  

* Creatures deal damage..

* Creatures have proficiency/ are proficient in skills and saves.

==== Spells ====

Use the term ''region'' to refer to multi-location areas that have their own map (e.g. [[Wilderness]]), and the term ''location'' to refer to named places within those regions that appear on the minimap or the name of the save file, (e.g. [[Goblin Camp]], [[Sacred Pool]]), even if they themselves contain smaller locations (eg. [[Emerald Grove]]).

==== Acts ====

* Act 1 begins when the party arrives on the [[Ravaged Beach]] at the start of the game. While the game labels the [[Mountain Pass]] as 1b, the wiki includes it under Act 1.

* Act 2 begins when the party enters the [[Shadow-Cursed Lands]].

* Act 3 begins when the player exits the [[Shadow-Cursed Lands]] and takes a [[Long Rest|long rest]].

* Do not refer the positioning of images in textual contents (eg. "in the image to the left" or "the image at the top".

* Images should never use pixels for scaling, and should instead use the use the {{code|upright}} parameter (<nowiki>upright=scaling_factor</nowiki>), where scaling_factor is a number, usually 1.0, that uses the user's own image size preferences to scale the images. This value should never be above 1.3, and most of the time should be 1.0.

Link to other articles when they have relevant additional information. Be careful not to underlink or overlink on the wiki. Only use links when they're helpful to the reader – every word that has an article does not need to be linked.

Generally, a link to a specific target should only appear once per article, when the relevant word is first mentioned.

Exceptions to this include infoboxes, navboxes, tables, lists and, in some cases, the description of spells or special abilities. In these cases, multiple links per article may be appropriate.

In very long or technical articles, it may sometimes it may also be appropriate to link to a subject introduced at the start of a section, even if the target article has already been linked to previously in that article.

The [[Template:FRWiki|FRWiki]] template should be used to link to the FRWiki when appropriate.

; Hit points : Determines how much damage a creature can take before being Downed.

; Hit points : Determines how much damage a creature can take before being Downed.

; Hit points : Determines how much damage a creature can take before being Downed.

; Hit points : Determines how much damage a creature can take before being Downed.

** Icons can be used at the start of flowing text (such as before the first word of a paragraph or immediately before the word it is describing) the first time a term is mentioned in an article, and the icon serves an important illustrative purpose.

** Some icons, primarily those readily identified by an icon (such as conditions and features) can be used in full sentences of technical descriptions of item, action or feature properties when they serve as a useful visual cue to the reader. Repeat icons may be acceptable in this case.

BG3Wiki employs the use of spoiler and content warnings at the top of articles or sections.

=== Spoiler warnings ===

When creating an article that includes spoilers, you should add a {{tlink|spoiler warning}} to the top of the page or section, if no spoilers appear above that section in the article.

Specify which act the spoiler applies to, per the example. For recurring characters who appear in more than one act, it may make more sense to use the general act-agnostic spoiler warning:

<pre>{{SpoilerWarning}}</pre>

{{SpoilerWarning}}

 

Content warnings are indicated with {{tlink|cw}}.