Actions

Project Rebearth

Project Rebearth:Manual of Style

From Project Rebearth

The Project Rebearth Wiki Manual of Style is the style guide for all articles on the Project Rebearth Wiki. It covers grammar, formatting, linking, template usage, and other conventions that keep articles consistent and readable. For article structure and section ordering, see the Layout Guide.

All articles should follow these guidelines and when in doubt, editors should consult each other on the wiki channel in our Discord server.

Perspective and tone

[edit]

All articles are written in present tense and from a game-mechanics perspective. Articles should describe the current state of the game as it exists now. For example, editors should write like "The Bakery produces Food" rather than "The Bakery produced Food."

Articles should be factual and neutral. Editors shouldn't editorialize about game balance, and avoid subjective judgments such as calling a building "the best" or "overpowered." Gameplay advice and optimization tips belong in the optional Strategy section.

As the game's lore is revealed over time, lore-related content should be kept softly separated from mechanical descriptions. Use distinct sections or paragraphs for narrative context versus gameplay data.

Numbers

[edit]

Always write numbers as digits, never spelled out:

Correct Incorrect
provides housing for 4 people provides housing for four people
costs 35 Wood costs thirty-five Wood
produces 2.5 Food per day produces two and a half Food per day
Programmatical approach for game data
When talking about how much resource a building produces, don't detail it with numbers, but use the {{BuildingData}} template. See the BuildingData section for more details

Always include units and signs with numerical values: +50/day, -2.0/day, -0.1/day.

For large numbers (1,000 or more), use the {{formatnum:}} template to add comma separators: {{formatnum:10000}} renders as 10,000.

Capitalization

[edit]

Headings

[edit]

Use sentence case for all headings. Only capitalize the first word and proper nouns:

Correct Incorrect
== Resource production == == Resource Production ==
== Housing upkeep == == Housing Upkeep ==
== Affected by == == Affected By ==

Game terms

[edit]

Always capitalize the names of resources, buildings, biomes, and other named game concepts when referring to them specifically:

  • Resources: Wood, Stone, Earth, Food, Grain, Flour, Milk, Wool, Drinks, Clothes, Scrap, Tools, Glass, Ore, Metal, Coin, Knowledge
  • Buildings: Bakery, Town Hall, Woodcutter, Iron Mine, etc.
  • Biomes: Wood Biome, Stone Biome, Earth Biome, Arctic Biome
  • Other game concepts: Happiness, Trade, Expeditions, etc.

Follow standard English capitalization rules for everything else.

Formatting

[edit]

Bold

[edit]
  • Bold the article subject on its first mention in the intro paragraph using three single quotes: '''Tavern'''.
  • Bold key statistics in Overview sections to make them easy to scan: "The Tavern costs 50 of the biome's primary resource."
  • Do not use bold for general emphasis elsewhere in the article.

Whitespace

[edit]

Never leave an empty line directly below a heading before the section content begins:

Correct Incorrect
== Overview ==
The Tavern costs 50 of the biome's...
== Overview ==

The Tavern costs 50 of the biome's...

Other formatting rules

[edit]
  • Prefer wiki markup over raw HTML wherever possible.
  • Never use code-style formatting in articles: no backticks, no <code> tags, and no config file key names (e.g. write "Bakery" not "bakery" or bakery_1).
  • Write in prose paragraphs, not bullet-point lists, for article body sections.

Linking

[edit]

Resource icons

[edit]

All mentions of resources in article text must use the {{Icon}} template, which displays a 15px icon alongside a wikilink:

Correct Incorrect
consumes {{Icon|Wood}} and {{Icon|Food}} consumes [[Wood]] and [[Food]]

Supported resources are Wood, Stone, Earth, Food, Grain, Flour, Milk, Wool, Drinks, Clothes, Scrap, Tools, Glass, Ore, Metal, Coin, Knowledge.

[edit]

Use [[wikilinks]] for game terms such as building names, biome names, and game systems on first mention. Use piped links when the display text differs from the page title: [[Wood Biome|Wood]].

Images

[edit]

Building images follow the naming convention BuildingNameBiome, where the biome suffix matches the biome type:

  • Wood biome: BakeryWood.png
  • Stone biome: BakeryStone.png
  • Earth biome: BakeryClay.png

No Arctic biome images currently exist for any building.

Tables

[edit]

Article tables

[edit]

All data tables in articles use the themed rb-table style, which matches the wiki's brown and gold visual identity. Wrap the table in two <div> layers and use class="rb-table" instead of class="wikitable":

<div class="rb-table-frame"><div class="rb-table-inner">
{| class="rb-table"
|-
! Column 1 !! Column 2
|-
| Data 1 || Data 2
|}
</div></div>

The outer rb-table-frame provides the gold border, rb-table-inner provides the cream background, and rb-table styles the table itself with dark brown headers, zebra-striped rows, and themed link colors.

Section rows

[edit]

Use the rb-section class on a table row to create a medium-brown sub-header that groups related rows:

|- class="rb-section"
| colspan="4" | Food Production

Value styling

[edit]

Use these CSS classes inside table cells to color-code values:

  • rb-buff for positive values (green, bold): <span class="rb-buff">+3.0</span>
  • rb-nerf for negative values (red, bold): <span class="rb-nerf">-1.0</span>
  • rb-center on a <td> or cell to center-align its contents

Cell alignment

[edit]

To center a cell that spans multiple columns, use inline style on the cell:

| colspan="4" style="text-align:center;" | +2.5/day

Infobox subtables

[edit]

Standard wikitable syntax (using {| and |}) breaks inside template parameters. When a table is needed inside an infobox template, use HTML tables with the rb-ib-subtable class instead:

| cost = <table class="rb-ib-subtable">
  <tr><th>Biome</th><th>Cost</th></tr>
  <tr><td>[[Wood Biome|Wood]]</td><td>50 {{Icon|Wood}}</td></tr>
  <tr><td>[[Stone Biome|Stone]]</td><td>50 {{Icon|Stone}}</td></tr>
  <tr><td>[[Earth Biome|Earth]]</td><td>50 {{Icon|Earth}}</td></tr>
  <tr><td>[[Arctic Biome|Arctic]]</td><td>50 {{Icon|Wood}}</td></tr>
</table>

Infobox subtables use rb-ib-buff and rb-ib-nerf for value styling (same as rb-buff/rb-nerf but scoped to the infobox CSS).

Templates

[edit]

The wiki provides several templates to keep articles accurate and consistent. Editors should familiarize themselves with these before writing.

{{Icon}}

[edit]

Displays a 15px resource icon alongside a wikilink to the resource article. Required for all resource mentions in article text. See Resource icons above.

Pulls live game data directly into article text, keeping values in sync with the game automatically. Always use this template instead of typing numbers manually for any building-related statistic (costs, production rates, storage, population).

Parameters:

  • name: the building's config key (e.g. woodcutter, house_1, bakery)
  • data: the type of data to pull (cost, rate, balance, storage, marketStorage)
  • biome: which biome's value to display (wood, stone, earth, arctic)
  • resource: which resource within that data set (e.g. wood, food, tools)
  • section: for non-building data, use choices to pull from the choices config
  • crop: for Field crop types

Example:

The Woodcutter produces +{{BuildingData|name=woodcutter|data=rate|biome=wood|resource=wood}} Wood per day.
Correct Incorrect
costs '''{{BuildingData|name=house_1|data=cost|biome=wood|resource=wood}}''' {{Icon|Wood}} costs '''35''' {{Icon|Wood}}

{{Chain}}

[edit]

Renders a visual production chain diagram. Provide alternating resource and building names. Supports up to 15 items.

{{Chain|Wood|Tools Workshop|Tools|title=Tools chain}}

Optional parameters:

  • title: a title for the chain diagram
  • direction: horizontal (default) or vertical

Automatically detects and displays relevant changelog entries for the current page. Place inside a == Changelog == section.

Renders a comparison table of production rates across all biomes. The highlight parameter (wood, stone, earth, or arctic) bolds the column for that biome.

The site-wide navigation box. Placed at the bottom of every article, after the last section and before categories.

{{formatnum:}}

[edit]

MediaWiki built-in template that formats numbers with comma separators. Use for values of 1,000 or greater: {{formatnum:10000}} renders as 10,000.

Infobox templates

[edit]

Each article type has its own infobox template. See the Layout Guide for which template to use and how articles of each type should be structured:

  • {{Building}} for building articles
  • {{Resource}} for resource articles
  • {{Biome}} for biome articles
  • {{Choice}} for choice and policy articles

Used for disambiguation notices at the top of articles when a term could refer to multiple pages. See the Layout Guide for placement rules.

Game updates

[edit]

Articles should describe only the current state of the game. Do not document historical changes in article prose (e.g. "Prior to version 1.2, the Bakery cost 50 Wood"). Version history is handled automatically by the {{Changelog}} template, which should be included in every article.

Prohibited content

[edit]

The following are not permitted in any article:

  • Speculation or unverified claims. All information must reflect the current game.
  • First or second person ("you", "we", "I"). Write in third person.
  • Exclamation marks.
  • Casual or colloquial language ("awesome", "insane", "totally").
  • Code-style references (backticks, <code> tags, config key names like bakery_1).
  • Editorializing ("the best building", "overpowered", "a must-have").
  • Strategy advice in factual sections. Gameplay tips belong in the optional Strategy section only.
  • Hardcoded game numbers. Use {{BuildingData}} to pull values dynamically wherever possible.