Veloren Wiki Veloren Wiki:Style guide

Veloren Wiki:Style guide

From Veloren Wiki

This style guide has the simple purpose of making the Veloren Wiki easy to read by establishing a certain format. One way is often as good as another, but if everyone does things the same way, the articles will be easier to read and use, along with being easier to write and edit. Reading the style guide is important to ensure that each user's edits will be consistent with those of other users.

Article titles[edit source]

Pages must have appropriate titles. Page names should always be exactly the same as in-game name of the subject.

  • Names, locations and titles should all be capitalised appropriately. Capitilisation rarely appiles to every word in the article title.
  • A rule of thumb for article titles is that they should follow how they are displayed in game. If both words are capitalised then do that.
  • Block capitals should not be used in titles. 'Article titles', not 'ARTICLE TITLES'.
  • Words such as articles (a,an, and the) and short prepositions (e.g. in, of, from) should all be left uncapitalised, unless the first word of a title.

Sometimes technical restrictions of MediaWiki prevent editors naming pages after their in-game names.

Section and headings[edit source]

Separating articles into sections makes them easy to read and navigate. Headings are used to split articles into sections.

Markup[edit source]

Use two equal signs (==) style markup for headings. Start with ==, add the heading title, then end with ==.

This section's heading was created with the markup:

== Sections and headings ==

This subsection's heading was created with the markup:

=== Markup ===

Wording[edit source]

  • In a heading, capitalise only the first letter of the first word and the first letter of any proper nouns, and leave all of the other letters in lowercase. Quest titles, skills, names, cities, and so on should all have the first letter capitalised.
  • Avoid putting links in headings.
  • Make sure that the heading has an appropriate and accurate title, as this is important to help readers navigate the article.
  • Keep headings short.

Lead sections[edit source]

A lead (introduction) summarises the most important points of an article, creating interest in the topic. Thus, it should be limited to a few paragraphs. Certain information, such as strategies and trivia, should be in a separate section instead of in the lead. This applies only to articles that are of sufficient length to incorporate a lead.

Text elements[edit source]

Internal links[edit source]

  • Every time an article is mentioned on the page, you don't have to link to every single one. For example, apple may be mentioned five times. You only have to link to apple once. You can link to articles more than once if the page is very long.
  • Piped link formats for simple plurals are generally unnecessary. For example, use [[apple]]s instead of [[apple|apples]].
  • On the other hand, use [[wolf|wolves]] instead of [[wolf]]s when appropriate. Don't be afraid to use a piped link when necessary, particularly if avoiding them contorts the language unnecessarily or introduces spelling or grammatical errors into the article. Piped links have legitimate uses in an article.