Help:Contents

From Jtvcommunity

This page will give you some basic formatting help for the MediaWiki platform that we use here for the Justin.tv Community Wiki

Text formatting markup

''italic''

'''bold'''

'''''bold & italic'''''

<nowiki>no ''markup''</nowiki>

=level 1=
==level 2==
===level 3===
====level 4====
=====level 5=====
======level 6======

----

* one
* two
* three
** three point one
** three point two

# one
# two<br />spanning several lines<br />without breaking the numbering
# three
## three point one
## three point two

;item 1
:definition 1
;item 2
:definition 2-1
:definition 2-2

:Single indent
::Double indent
:::::Multiple indent

# one
# two
#* two point one
#* two point two
# three
#; three item one
#: three def one
# four
#: four def one
#: this rather looks like the continuation of # four
#: and thus often used instead of <br />
# five
## five sub 1
### five sub 1 sub 1
## five sub 2
;item 1
:* definition 1-1
:* definition 1-2
:
;item 2
:# definition 2-1
:# definition 2-2

 preformatted text is done with
 a '''space''' at the 
 ''beginning'' of the line

preformatted text is done with
a space at the 
beginning of the line

Links

Internal Linking

To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already it is displayed in blue, if it does not, in red. Selflinks to the current page are not transformed in URLs but displayed in bold.

The first letter of the target page is automatically capitalized, unless otherwise set by the admins, and spaces are represented as underscores (typing an underscore in the link will have a similar effect as typing a space, but is not recommended, since the underscore will also be shown in the text).

[[Main Page]]

[[Main Page|different text]]

#REDIRECT [[Main Page]]

External Links

http://mediawiki.org

[http://mediawiki.org MediaWiki]

[http://mediawiki.org]

[http://en.wikipedia.org/wiki/.avi video]
[http://en.wikipedia.org/wiki/.wav sound]
[http://en.wikipedia.org/wiki/.pdf document]

[http://{{SERVERNAME}}/pagename]

[http://google.com/search?q={{PAGENAMEE}}]

[mailto:info@example.org email me]

[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]

How to avoid auto-links

By default, when you write a URL as is, it will be transformed to an external link.

To avoid that effect, put the URL between <nowiki> tags as in:

<nowiki>http://mediawiki.org</nowiki>

Image Formatting Markup

Syntax

The full syntax for displaying an image is:

[[Image:{filename}|{options}]]

Where options can be zero or more of the following, separated by pipes:

• border, frame, thumb, or frameless: Controls how the image is formatted
• left, right, center, none: Controls the alignment of the image within a text
• baseline, sub, super, top, text-top, middle, bottom, text-bottom: Controls the vertical alignment of the image within a text
• {width}px: Resizes the image to the given width in pixels
• {width}x{height}px: Resizes the image to fit within the given width and height in pixels; it is possible to specify only the height by writing x{height}px
  • Note that the image will always retain its aspect ratio.
• link={destination}: Allows to link to an arbitrary title, URL or just nowhere
  • link=: Will display an image without link, e.g. [[File:Name.jpg|link=]].
  • Note that link cannot be used in conjunction with thumb or frame.
• alt={alternative text}: For changing the alternative text (alt="") of an image
• Special cases:
  • page=1: Displays the specified page when showing a djvu file

The options can be given in any order. If the given options conflict each other, the latter is applied, except for the format options, where the options take the priority in the order of frame, thumb, and frameless and/or border. If a given option does not match any of the other possibilities, it is assumed to be the caption text. Caption text can contain wiki links or other formatting.

For more information and examples check the MediaWiki help page on Images

Wiki table markup summary

{|

|+

|-

! 

|

|}

• The above marks must start on a new line except the double || and !! for optionally adding consecutive cells to a line. However, blank spaces at the beginning of a line are ignored.
• XHTML attributes. Each mark, except table end, optionally accepts one or more XHTML attributes. Attributes must be on the same line as the mark. Separate attributes from each other with a single space.
  • Cells and caption (| or ||, ! or !!, and |+) hold content. So separate any attributes from content with a single pipe (|). Cell content may follow on same line or on following lines.
  • Table and row marks ({| and |-) do not directly hold content. Do not add pipe (|) after their optional attributes. If you erroneously add a pipe after attributes for the table mark or row mark the parser will delete it and your final attribute if it was touching the erroneous pipe!
• Content may (a) follow its cell mark on the same line after any optional XHTML attributes or (b) on lines below the cell mark. Content that uses wiki markup that itself needs to start on a new line, such as lists, headings, or nested tables, must be on its own new line.

Basics

The following table lacks borders and good spacing but shows the simplest wiki markup table structure.

{|
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

The cells in the same row can be listed on one line separated by ||.

Extra spaces within cells in the wiki markup, as in the wiki markup below, do not affect the actual table rendering.

{|
|  Orange    ||   Apple   ||   more
|-
|   Bread    ||   Pie     ||   more
|-
|   Butter   || Ice cream ||  and more
|}

Table headers

Table headers can be created by using "!" instead of "|". Headers usually show up bold and centered by default.

{|
! Item
! Amount
! Cost
|-
|Orange
|10
|7.00
|-
|Bread
|4
|3.00
|-
|Butter
|1
|5.00
|-
!Total
|
|15.00
|}

Caption

A table caption can be added to the top of any table as follows.

{|
|+Food complements
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

XHTML attributes

You can add XHTML attributes to tables. For the authoriative source on these, see the W3C's HTML 4.01 Specification page on tables.

Attributes on tables

Placing attributes after the table start tag ({|) applies attributes to the entire table.

{| border="1"
|Orange
|Apple
|12,333.00
|-
|Bread
|Pie
|500.00
|-
|Butter
|Ice cream
|1.00
|}

Attributes on cells

You can put attributes on individual cells. For example, numbers may look better aligned right.

{| border="1"
|Orange
|Apple
|align="right" | 12,333.00
|-
|Bread
|Pie
|align="right" | 500.00
|-
|Butter
|Ice cream
|align="right" | 1.00
|}

You can also use cell attributes when you are listing multiple cells on a single line. Note that the cells are separated by ||, and within each cell the attribute(s) and value are separated by |.

{| border="1"
| Orange || Apple     || align="right" | 12,333.00
|-
| Bread  || Pie       || align="right" | 500.00
|-
| Butter || Ice cream || align="right" | 1.00
|}

Attributes on rows

You can put attributes on individual rows, too.

{| border="1"
|Orange
|Apple
|align="right"|12,333.00
|-
|Bread
|Pie
|align="right"|500.00
|- style="font-style:italic; color:green;"
|Butter
|Ice cream
|align="right"|1.00
|}

With HTML attributes and CSS styles

CSS style attributes can be added with or without other HTML attributes.

{| style="color:green; background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Attributes can be added to the caption and headers as follows.

{| border="1" cellpadding="20" cellspacing="0"
|+ align="bottom" style="color:#e76700;" |''Food complements''
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Caveat

Negative numbers

If you start a cell on a new line with a negative number with a minus sign (or a parameter that evaluates to a negative number), your table can get broken, because the characters |- will be parsed as the wiki markup for table row, not table cell. To avoid this, insert a space before the value (| -6) or use in-line cell markup (|| -6).