Aurora is on version 2.5.0 C#, available at the Aurora Forums.
Contact Erik on the forum for a wiki account.
Difference between revisions of "Help:Formatting"
m (1 revision: import help files) |
|||
Line 1: | Line 1: | ||
{{PD Help Page}} | {{PD Help Page}} | ||
− | You can format your text using wiki markup. This consists of normal characters like asterisks, single quotes or equation marks which have a special function in the wiki, sometimes depending on their position. For example, to format a word in ''italic'', you include it in two single quotes like <code><nowiki>''this''</nowiki></code> | + | You can format your text using wiki markup. This consists of normal characters like asterisks, single quotes or equation marks which have a special function in the wiki, sometimes depending on their position. For example, to format a word in ''italic'', you include it in two single quotes like <code><nowiki>''this''</nowiki></code>. |
== Text formatting markup == | == Text formatting markup == | ||
+ | |||
{| class="wikitable" | {| class="wikitable" | ||
− | ! | + | ! Description !! You type !! You get |
− | ! | ||
− | ! | ||
|- | |- | ||
− | ! colspan="3" | + | ! colspan="3" style="background:#ABE" | character (inline) formatting – ''applies anywhere'' |
|- | |- | ||
|Italic text | |Italic text | ||
− | |< | + | | <code><nowiki>''italic''</nowiki></code> |
|''italic'' | |''italic'' | ||
|- | |- | ||
| Bold text | | Bold text | ||
− | |< | + | | <code><nowiki>'''bold'''</nowiki></code> |
|'''bold''' | |'''bold''' | ||
|- | |- | ||
| Bold and italic | | Bold and italic | ||
− | |< | + | | <code><nowiki>'''''bold & italic'''''</nowiki></code> |
|'''''bold & italic''''' | |'''''bold & italic''''' | ||
|- | |- | ||
|Escape wiki markup | |Escape wiki markup | ||
− | | | + | | <code><nowiki><nowiki>no ''markup''</nowiki></nowiki></code> |
− | < | ||
|<nowiki>no ''markup''</nowiki> | |<nowiki>no ''markup''</nowiki> | ||
|- | |- | ||
− | ! colspan="3" | + | ! colspan="3" style="background:#ABE" | section formatting – ''only at the beginning of the line'' |
|- | |- | ||
|Headings of different levels | |Headings of different levels | ||
− | | | + | | <pre>=level 1= |
− | <pre>=level 1= | ||
==level 2== | ==level 2== | ||
===level 3=== | ===level 3=== | ||
Line 37: | Line 34: | ||
=====level 5===== | =====level 5===== | ||
======level 6======</pre> | ======level 6======</pre> | ||
− | An article with | + | An article with 4 or more headings automatically creates a [[wikipedia:Wikipedia:Section#Table of contents (TOC)|table of contents]]. |
− | + | |<!-- hack to prevent TOC viewing for h1 - h6 elements: their style is hardcopied here --> | |
− | | | + | <div style="font-size: 188%; margin: 0; padding-top: .5em; padding-bottom: .17em; border-bottom: 1px solid #aaa">Level 1</div> |
− | <!-- | + | <div style="font-size: 150%; margin: 0; padding-top: .5em; padding-bottom: .17em; border-bottom: 1px solid #aaa">Level 2</div> |
− | <div style="font-size: 188%; margin: 0; padding-top: .5em; padding-bottom: .17em; border-bottom: 1px solid #aaa | + | <div style="font-size: 132%; font-weight: bold">Level 3</div><!-- |
− | <div style="font-size: 150%; margin: 0; padding-top: .5em; padding-bottom: .17em; border-bottom: 1px solid #aaa | + | --><b>Level 4</b><!-- |
− | <div style="font-size: 132% | + | --><div style="font-size: 86%; font-weight: bold">Level 5</div><!-- |
− | < | + | --><b style="font-size: 80%">Level 6</b> |
− | <div style="font-size: 86% | ||
− | < | ||
|- | |- | ||
|Horizontal rule | |Horizontal rule | ||
− | | | + | | <code>----</code> |
− | < | ||
| | | | ||
---- | ---- | ||
Line 76: | Line 70: | ||
<pre> | <pre> | ||
# one | # one | ||
− | # two<br />spanning | + | # two<br />spanning more lines<br />doesn't break numbering |
# three | # three | ||
## three point one | ## three point one | ||
Line 83: | Line 77: | ||
| | | | ||
# one | # one | ||
− | # two<br />spanning | + | # two<br />spanning more lines<br />doesn't break numbering |
# three | # three | ||
## three point one | ## three point one | ||
Line 89: | Line 83: | ||
|- | |- | ||
|Definition list | |Definition list | ||
− | | | + | |<pre> |
− | <pre> | ||
;item 1 | ;item 1 | ||
− | :definition 1 | + | : definition 1 |
;item 2 | ;item 2 | ||
− | :definition 2-1 | + | : definition 2-1 |
− | :definition 2-2 | + | : definition 2-2 |
</pre> | </pre> | ||
| | | | ||
;item 1 | ;item 1 | ||
− | :definition 1 | + | : definition 1 |
;item 2 | ;item 2 | ||
− | :definition 2-1 | + | : definition 2-1 |
− | :definition 2-2 | + | : definition 2-2 |
|- | |- | ||
| Adopting definition list to indent text | | Adopting definition list to indent text | ||
| | | | ||
− | <pre>:Single indent | + | <pre>: Single indent |
− | ::Double indent | + | :: Double indent |
− | :::::Multiple indent</pre> | + | ::::: Multiple indent</pre> |
− | This | + | This workaround may be controversial from the viewpoint of accessibility. |
| | | | ||
− | :Single indent | + | : Single indent |
− | ::Double indent | + | :: Double indent |
− | :::::Multiple indent | + | ::::: Multiple indent |
|- | |- | ||
| Mixture of different types of list | | Mixture of different types of list | ||
Line 123: | Line 116: | ||
#* two point two | #* two point two | ||
# three | # three | ||
− | #; three | + | #; three item one |
− | #: three | + | #: three def one |
# four | # four | ||
− | #: four | + | #: four def one |
#: this rather looks like the continuation of # four | #: this rather looks like the continuation of # four | ||
#: and thus often used instead of <br /> | #: and thus often used instead of <br /> | ||
+ | # five | ||
+ | ## five sub 1 | ||
+ | ### five sub 1 sub 1 | ||
+ | ## five sub 2 | ||
+ | |||
;item 1 | ;item 1 | ||
:* definition 1-1 | :* definition 1-1 | ||
Line 137: | Line 135: | ||
:# definition 2-2 | :# definition 2-2 | ||
</pre> | </pre> | ||
− | The usage of <code>#:</code> and | + | The usage of <code>#:</code> and <code>*:</code> for breaking a line within an item may also be controversial. |
| | | | ||
# one | # one | ||
Line 144: | Line 142: | ||
#* two point two | #* two point two | ||
# three | # three | ||
− | #; three | + | #; three item one |
− | #: three | + | #: three def one |
# four | # four | ||
− | #: four | + | #: four def one |
#: this rather looks like the continuation of <code># four</code> | #: this rather looks like the continuation of <code># four</code> | ||
− | #: | + | #: often used instead of <code><br /></code> |
+ | # five | ||
+ | ## five sub 1 | ||
+ | ### five sub 1 sub 1 | ||
+ | ## five sub 2 | ||
;item 1 | ;item 1 | ||
:* definition 1-1 | :* definition 1-1 | ||
Line 174: | Line 176: | ||
== Paragraphs == | == Paragraphs == | ||
− | MediaWiki ignores normal line breaks. To start a new paragraph, leave an empty line. You can force | + | MediaWiki ignores normal line breaks. To start a new paragraph, leave an empty line. You can force a line break within a paragraph with the HTML tags <code><br /></code>. |
== HTML == | == HTML == | ||
− | Some [[wikipedia:HTML|HTML]] tags are allowed in MediaWiki, for example <code> | + | Some [[wikipedia:HTML|HTML]] tags are allowed in MediaWiki, for example <code><code></code>, <code><div></code>, <code><nowiki><span></nowiki></code> and <code><nowiki><font></nowiki></code>. These apply anywhere you insert them. |
{| class="wikitable" | {| class="wikitable" | ||
Line 184: | Line 186: | ||
!You get | !You get | ||
|- | |- | ||
+ | | Strikethrough | ||
+ | | <code><del>Strikethrough</del></code> or <code><s>Strikethrough</s></code> | ||
+ | |<del>Strikethrough</del> | ||
+ | |- style="white-space:nowrap" | ||
|Fixed width text | |Fixed width text | ||
− | | | + | | <code><tt>Fixed width text</tt></code> or <code><code>source code</code></code> |
− | < | + | | <tt>Fixed width text</tt> |
− | | | ||
− | <tt>Fixed width text</tt> | ||
|- | |- | ||
|Blockquotes | |Blockquotes | ||
− | | | + | | <code> |
− | < | ||
text text text text text text text text text text text text | text text text text text text text text text text text text | ||
text text text text text text text text text text text text | text text text text text text text text text text text text | ||
− | + | <blockquote> quote quote quote quote quote quote </blockquote> | |
text text text text text text text text text text text text | text text text text text text text text text text text text | ||
− | </ | + | </code> |
+ | | text text text text text text text text text text text text text text text text text text text text text text text text <blockquote> quote quote quote quote quote quote </blockquote> text text text text text text text text text text text text | ||
+ | |- | ||
+ | |Comment | ||
+ | | <code><!-- This is a comment --></code> | ||
+ | Text can only be viewed in the edit window. | ||
| | | | ||
− | + | <!-- This is a real invisible comment --> | |
− | |||
− | < | ||
− | |||
|- | |- | ||
− | | | + | |Completely preformatted text |
| | | | ||
− | <pre>< | + | <code><nowiki><pre>this way, all markups are '''ignored'''</pre></nowiki></code> |
| | | | ||
− | < | + | <pre> this way, all markups are '''ignored'''.</pre> |
|- | |- | ||
− | | | + | |'''Customised''' preformatted text |
| | | | ||
− | < | + | <code><nowiki><pre style="CSS text">this way, all markups are '''ignored''' and formatted with a CSS text</pre></nowiki></code> |
| | | | ||
− | <pre> | + | <pre style="white-space:pre-wrap;white-space:-moz-pre-wrap;white-space:-pre-wrap;white-space:-o-pre-wrap;word-wrap:break-word;overflow:auto;"> |
− | this way, all | + | this way for instance, all '''ignored''' markups take into account the navigator size, by automatically adding some carriage returns dynamically to it.</pre> |
|} | |} | ||
+ | |||
{{Admin tip|tip=If you trust your users you can allow full HTML by setting <code>{{mediawiki|Manual:$wgRawHtml|$wgRawHtml}} = true;</code> in {{mediawiki|Manual:LocalSettings.php|LocalSettings.php}}.}} | {{Admin tip|tip=If you trust your users you can allow full HTML by setting <code>{{mediawiki|Manual:$wgRawHtml|$wgRawHtml}} = true;</code> in {{mediawiki|Manual:LocalSettings.php|LocalSettings.php}}.}} | ||
== Other formatting == | == Other formatting == | ||
Beyond the text formatting markup shown above, here are some other formatting references: | Beyond the text formatting markup shown above, here are some other formatting references: | ||
+ | |||
*[[Help:Links|Links]] | *[[Help:Links|Links]] | ||
− | *[[Help:Images|Images]] | + | * [[Help:Images|Images]] |
− | *[[Help:Tables|Tables]] | + | * [[Help:Tables|Tables]] |
{{Languages}} | {{Languages}} | ||
[[Category:Help|Formatting]] | [[Category:Help|Formatting]] |
Revision as of 23:09, 29 December 2009
Important note: When you edit this page, you agree to release your contribution into the public domain. If you don't want this or can't do this because of license restrictions, please don't edit. This page is one of the Public Domain Help Pages, which can be freely copied into fresh wiki installations and/or distributed with MediaWiki software; see Help:Contents for an overview of all pages. See Project:PD help/Copying for instructions. |
You can format your text using wiki markup. This consists of normal characters like asterisks, single quotes or equation marks which have a special function in the wiki, sometimes depending on their position. For example, to format a word in italic, you include it in two single quotes like ''this''
.
Text formatting markup
Description | You type | You get |
---|---|---|
character (inline) formatting – applies anywhere | ||
Italic text | ''italic''
|
italic |
Bold text | '''bold'''
|
bold |
Bold and italic | '''''bold & italic'''''
|
bold & italic |
Escape wiki markup | <nowiki>no ''markup''</nowiki>
|
no ''markup'' |
section formatting – only at the beginning of the line | ||
Headings of different levels | =level 1= ==level 2== ===level 3=== ====level 4==== =====level 5===== ======level 6====== An article with 4 or more headings automatically creates a table of contents. |
Level 1
Level 2
Level 3 Level 4Level 5 Level 6
|
Horizontal rule | ----
|
|
Bullet list |
* one * two * three ** three point one ** three point two Inserting a blank line will end the first list and start another. |
|
Numbered list |
# one # two<br />spanning more lines<br />doesn't break numbering # three ## three point one ## three point two |
|
Definition list | ;item 1 : definition 1 ;item 2 : definition 2-1 : definition 2-2 |
|
Adopting definition list to indent text |
: Single indent :: Double indent ::::: Multiple indent This workaround may be controversial from the viewpoint of accessibility. |
|
Mixture of different types of list |
# 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 The usage of |
|
Preformatted text |
preformatted text is done with a '''space''' at the ''beginning'' of the line This way of preformatting only applies to section formatting, and character formatting markups are still effective. |
preformatted text is done with a space at the beginning of the line |
Paragraphs
MediaWiki ignores normal line breaks. To start a new paragraph, leave an empty line. You can force a line break within a paragraph with the HTML tags <br />
.
HTML
Some HTML tags are allowed in MediaWiki, for example <code>
, <div>
, <span>
and <font>
. These apply anywhere you insert them.
Description | You type | You get |
---|---|---|
Strikethrough | <del>Strikethrough</del> or <s>Strikethrough</s>
|
|
Fixed width text | <tt>Fixed width text</tt> or <code>source code</code>
|
Fixed width text |
Blockquotes |
|
text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text |
Comment | <!-- This is a comment -->
Text can only be viewed in the edit window. |
|
Completely preformatted text |
|
this way, all markups are '''ignored'''. |
Customised preformatted text |
|
this way for instance, all '''ignored''' markups take into account the navigator size, by automatically adding some carriage returns dynamically to it. |
Tip for wiki admins: If you trust your users you can allow full HTML by setting $wgRawHtml = true; in LocalSettings.php.
|
Other formatting
Beyond the text formatting markup shown above, here are some other formatting references:
Language: | English |
---|