Difference between revisions of "RimWorld Wiki:Style guide"

From RimWorld Wiki
Jump to navigation Jump to search
(Added category.)
Line 20: Line 20:
 
** General topics, e.g. Defense tactics, World generation
 
** General topics, e.g. Defense tactics, World generation
  
* Capitalization - Title case | Pages names that use title case:
+
* Capitalization - title case | Pages names that use title case:
 
** AI storytellers, e.g. Randy Random
 
** AI storytellers, e.g. Randy Random
 
** Guides, e.g Extreme Heat Guide
 
** Guides, e.g Extreme Heat Guide

Revision as of 07:28, 7 March 2021

Intro

The purpose of this style guide is to describe and clarify the standards used on this wiki to promote consistency across articles.

  • This style guide is meant to make things easier for editors, not harder; and is not meant to impose personal preferences or extensive policies that would inhibit constructive edits and improvements.

  • New content added to this page should address a persistently recurring style issue.

  • Any substantive edit to this page should reflect consensus. When in doubt, discuss first on the talk page.

Language

  • The language used on this wiki is American English.
  • Redirects with the British spelling of an existing page may be added. e.g. Armour, Defence tactics

Page titles

  • Plural - Pages should be singular unless plural in-game (e.g. Frag grenades) or refer to a group of similar things (e.g. Trees, ).
  • Capitalization - sentence case | Page names that use sentence case:
    • In-game items and features, e.g. Wood, Steel helmet, Muscle parasites, Advanced component, Learning helper
    • General topics, e.g. Defense tactics, World generation
  • Capitalization - title case | Pages names that use title case:
    • AI storytellers, e.g. Randy Random
    • Guides, e.g Extreme Heat Guide
    • Groups, e.g. Spacer Weapons
    • Modding tutorials
    • Stats (of items, structures, pawns), e.g. Deterioration Rate, Cover Effectiveness, Arrest Success Chance
    • Semantic MediaWiki properties, e.g. Lives in Boreal Forest
    • Concept pages

Page sections

  • The first paragraph on a page constitutes the ‘lead section’. The lead section should not have a section header.
  • Sections should use sentence case.
  • Sections should not also be links. Instead, either create a link using the first instance of the word or use the ‘Main’ template.
  • In the edit view, a section header should be immediately followed by content; no blank lines between the section header and its first line of content.

General text

  • RimWorld vs rimworld
    • Use RimWorld when referring to the game.
    • Use rimworld when referring to a rimworld planet.
  • Links and formatting
    • The first instance of text referring to the page’s topic may be bolded. Otherwise, generally avoid the use of bold text.
    • Use italics to emphasize text instead of bolding and underlining.
    • Make links that are relevant to the context. Only the first instance should be linked.
  • Capitalization
    • In most cases capitalization should follow the capitalization used in-game.
    • Capitalize words only as needed. Mid-sentence page links use appropriate case. e.g. Bluefur is a type of leather produced when a cook butchers a muffalo at a butcher table.
    • Use sentence case for thoughts. e.g. Eating raw food will cause the 'Ate raw food' thought.

Images

  • Screenshots should be high quality, cropped to focus on the subject, and free from UI clutter.

Table of contents

  • Generally, the table of contents is floated right by use of template ‘TOCRight’.
  • The table of contents (automatically added on pages with 4 or more sections) may be suppressed (by placing the magic word at the top of the page or at least before the main content. Suppressing the TOC is usually desirable on pages that are short enough that most or all of the sections are visible.
  • On tables with a TOC a table or section might inadvertently be pushed below the TOC. Currently the following is used to remove the white space and make the content flow alongside the TOC:
<div><li style="display: inline-table;">
table and content here to be floated
</li><div>

Properties

  • Guidelines here apply to SMW properties defined by infoboxes or other content pages
  • Use title case.
  • Delimit each word with a space. e.g. Milk Amount (not Milk_Amount, Milk-Amount, or MilkAmount)

Standard layout for pages

Articles about the same category of items share commonalities and generally use the same layout.

  • The following pages aim to provide consistency across pages that are alike. The format is a guideline that will apply to most but not all pages.

<to be determined, the following is a rough list. these pages to be created and linked as needed>

  • Animals
  • Drugs
  • Plants
  • Weapons

Definitions

  • Title case means capitalize words as done for book/movie titles per the following:
    • Capitalize the first and last words.
    • Capitalize the "principal" words.
    • Capitalize prepositions and conjunctions of four letters or more.
    • Lowercase the articles the, a, and an.
  • Sentence case means:
    • Capitalize the first word.
    • All other words are generally lower case unless proper nouns.
  • SMW: Semantic MediaWiki. The plugin that allows storing and querying of data by means of properties stored in the Property namespace.