Editing RimWorld Wiki:Style guide
Jump to navigation
Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
+ | ==Intro== | ||
The purpose of this style guide is to describe and clarify the standards used on this wiki to promote consistency across articles. | The purpose of this style guide is to describe and clarify the standards used on this wiki to promote consistency across articles. | ||
+ | <p> | ||
* 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. | * 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. | ||
+ | <p> | ||
* Guidelines at [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Wikipedia:Manual of Style] can usually be followed as good practices. | * Guidelines at [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Wikipedia:Manual of Style] can usually be followed as good practices. | ||
+ | <p> | ||
* New content added to this page should address a persistently recurring style issue. | * New content added to this page should address a persistently recurring style issue. | ||
+ | <p> | ||
* Any substantive edit to this page should reflect consensus. When in doubt, discuss first on the talk page. | * Any substantive edit to this page should reflect consensus. When in doubt, discuss first on the talk page. | ||
− | == Language == | + | ==Language== |
* The language used on this wiki is American English. | * 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 | * Redirects with the British spelling of an existing page may be added. e.g. Armour, Defence tactics | ||
− | == Page titles == | + | ==Page titles== |
− | Plural | + | * 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 | + | * 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 | |
− | * AI storytellers, e.g. Randy Random | + | ** Stats (of items, structures, pawns), e.g. Deterioration Rate, Cover Effectiveness, Arrest Success Chance |
− | * Guides, e.g | + | ** Semantic MediaWiki properties, e.g. Lives in Boreal Forest |
− | * Groups, e.g. Spacer Weapons | + | ** Concept pages |
− | * 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 == | + | ==Page sections== |
− | * The first paragraph on a page constitutes the | + | * 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 use sentence case. | ||
− | * Sections should not also be links. Instead, either create a link using the first instance of the word or use the | + | * 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. | * 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 == | + | ==General text== |
− | + | * RimWorld vs rimworld | |
− | * Use RimWorld when referring to the game. | + | ** Use RimWorld when referring to the game. |
− | * Use rimworld when referring to a rimworld planet. | + | ** 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 [[Menus#Work type|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== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == Images == | ||
* Screenshots should be high quality, cropped to focus on the subject, and free from UI clutter. | * Screenshots should be high quality, cropped to focus on the subject, and free from UI clutter. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == Table of contents == | + | ==Table of contents== |
− | * Generally, the table of contents is floated right by use of | + | * 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 | + | * The table of contents (automatically added on pages with 4 or more sections) may be suppressed (by placing the magic word __NOTOC__ 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 | + | * 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: |
− | < | + | :<nowiki><div><li style="display: inline-table;"></nowiki></br> |
− | <div><li style="display: inline-table;"> | + | :<nowiki>table and content here to be floated</nowiki></br> |
− | table and content here to be floated | + | :<nowiki></li><div></nowiki> |
− | </li><div> | ||
− | </ | ||
− | == Properties == | + | ==Properties== |
* Guidelines here apply to SMW properties defined by infoboxes or other content pages | * Guidelines here apply to SMW properties defined by infoboxes or other content pages | ||
* Use title case. | * Use title case. | ||
* Delimit each word with a space. e.g. Milk Amount (not Milk_Amount, Milk-Amount, or MilkAmount) | * Delimit each word with a space. e.g. Milk Amount (not Milk_Amount, Milk-Amount, or MilkAmount) | ||
− | == Standard layout for pages == | + | ==Standard layout for pages== |
Articles about the same category of items share commonalities and generally use the same layout. | Articles about the same category of items share commonalities and generally use the same layout. | ||
Line 79: | Line 74: | ||
* Weapons | * Weapons | ||
− | + | ==Definitions== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == Definitions == | ||
* Title case means capitalize words as done for book/movie titles per the following: | * Title case means capitalize words as done for book/movie titles per the following: | ||
** Capitalize the first and last words. | ** Capitalize the first and last words. | ||
Line 98: | Line 80: | ||
** Capitalize prepositions and conjunctions of four letters or more. | ** Capitalize prepositions and conjunctions of four letters or more. | ||
** Lowercase the articles the, a, and an. | ** Lowercase the articles the, a, and an. | ||
+ | |||
* Sentence case means: | * Sentence case means: | ||
** Capitalize the first word. | ** Capitalize the first word. | ||
** All other words are generally lower case unless proper nouns. | ** 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. | * SMW: Semantic MediaWiki. The plugin that allows storing and querying of data by means of properties stored in the Property namespace. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |