Cosmoteer Wiki:Style Guide

From Cosmoteer Wiki
Jump to navigation Jump to search

This guide serves as a reference on how to style pages when contributing to the wiki. While only guidelines, it is essential to try to adhere to the established style to maintain consistency and create the best possible reading experience.

Language

General Guidelines

All text contributed to the wiki should follow standard formatting and grammar seen on most wikis. Since the default game language is US English, all contributions to the wiki should use US English also unless providing translations.

Capitalization

When referring to in-game entities, names should be spelled in a way that matches the in-game case.

  • Tri-Steel
  • Hyper-coils
  • Hyper-Jump Relay

Sometimes there is little consistency with in-game capitalization. For example, Manufactures guided Electromagnetic Pulse missiles and Manufactures Tactical Nuclear Missiles are both in-game tooltips yet feature different capitalizations of the word 'missile'. In these cases, it is best to consult other pages on the wiki to find if there is an already established style.

Numbers

All numbers should use standard (Arabic) numerals, which is to say 0-9. Large numbers should be separated with commas, like 1,234,567,890. Decimal numbers should be separated with periods, such as 22.7.

Buttons

Buttons, or keyboard keys, should use the {{Button}} template like as follows:

  • {{Button|F}}F
  • {{Button|Enter}}Enter
  • {{Button|Left Mouse Button}}Left Mouse Button

Page Names

Page names/article titles should follow title case rules wherever possible.

  • Processor Fabricator
  • Game Modes
  • Build a New Ship
  • Determining Ship Rotation Relative to Teapots

Media

Images

When uploading images to the wiki, try to follow these guidelines:

  • Use a simple or recognizable filename: This helps with organization and makes it easy to find your images later.
  • Categorize your images: All images uploaded to the wiki should be categorized, as this makes them easy to find and sort. Look at similar images to what you are uploading to find what categories they use, or navigate the media category tree to find the correct home.
  • Try to follow established naming conventions: This depends on what you're uploading, but often you'll find that images already uploaded onto the wiki have a set naming pattern. As an example, ship images uploaded use the following format: ShipImperiumCivilianFulmarBlueprint.png.
  • Use original game images where possible: This again depends on what you're uploading, but try to use images taken directly from the game files. For example, when uploading images of built-in ships, use the image that ships with the game instead of capturing your own in-game. When uploading images of user interface (U.I.) elements, upload them directly from the game files instead of cropping your own version.
    • Do not alter images taken from the game files unless you have a good reason.
  • Prefer JPG unless you need transparency in your image: JPGs retain a decent level of quality while having small file sizes, which makes them excellent for web use. Remember that not everyone's internet connection is as good as your own, so supplying a 300KB JPG instead of a 5MB PNG might make all the difference to them. One of the main exceptions to this rule is when uploading images directly from the game files, as these are almost always PNGs.

Unstable Content

Though Cosmoteer offers public access to unstable testing builds, using stable/mainline branch content is essential as it most accurately reflects the experience most users will have with the game. Try not to update facts and figures in articles with values taken from testing builds unless you have a good reason for doing so.