ConRunner:Tutorial (Formatting)

From ConRunner
Jump to: navigation, search

Most text formatting is usually done with Wiki markup, so people don't have to learn HTML.

Wiki markup

Writing for ConRunner articles is a bit different from writing on a standard word processor. Instead of a strict "what you see is what you get" approach (also known as WYSIWYG), wiki uses simple text codes for formatting. The approach is similar to that used in writing HTML for web pages, but the codes are simpler.

The wiki can accept some HTML tags directly, but most people use the built-in MediaWiki markup language, which is designed for ease of editing.

Bold and italics

The most commonly used wiki tags are bold and italics. Bolding and italicizing is done by surrounding a word or phrase with multiple apostrophes ('):

  • ''italics'' is rendered as italics. (2 apostrophes on either side)
  • '''bold''' is rendered as bold. (3 apostrophes on either side)
  • '''''bolded italics''''' is rendered as bolded italics. (2 + 3 = 5 apostrophes on either side)

It is a Wikipedia convention to boldface the subject of an article when it is first mentioned in the article. ConRunner has adopted this convention as well. For example, the article Klinefelter's syndrome at Wikipedia starts:

Klinefelter's syndrome is a condition caused by a chromosomal abnormality in males...

If there are alternatives to the title the same applies, for example Elizabeth II of the United Kingdom starts:

Her Majesty Queen Elizabeth II (Elizabeth Alexandra Mary) (born 21 April 1926), styled HM The Queen, is the queen regnant...

Another Wikipedia convention is to italicize book, movie and computer/video game titles. If the first mention of the subject of an article is also a book or movie title then bold italics is used. For example, the article The Lord of the Rings starts:

The Lord of the Rings is an epic fantasy story by J. R. R. Tolkien, a sequel to his earlier work, The Hobbit.

Headings and subheadings

Headings and subheadings are an easy way to improve the organization of an article. If you can see two or more distinct topics being discussed, you can break up the article by inserting a heading for each section.

Headings can be created like this:

  • ==Top level heading== (2 equals signs)
  • ===Subheading=== (3 equals signs)
  • ====Another level down==== (4 equals signs)

If an article has at least four headings, a table of contents will automatically be generated. Try creating a heading in this page's sandbox. It will be added automatically to the table of contents for the page, assuming three others already exist. When you're done, click below to continue.

Indenting

For instructions on how to indent, see Chapter 6 of this tutorial

Wikipedia formatting style

You can get some ideas about standard Wikipedia formatting style in this annotated article.

Continue with the tutorial.