Formatting – Bohemia Interactive Community
mNo edit summary |
|||
Line 1,122: | Line 1,122: | ||
You add them by putting the template's name in <nowiki>{{double braces}}</nowiki>. It is also possible to transclude other pages by using <nowiki>{{:colon and double braces}}</nowiki>. | You add them by putting the template's name in <nowiki>{{double braces}}</nowiki>. It is also possible to transclude other pages by using <nowiki>{{:colon and double braces}}</nowiki>. | ||
There are three pairs of | There are three pairs of tags that can be used in wikitext to control how transclusion affects parts of a template or article. | ||
They determine whether or not wikitext renders, either in its own article, which we will call "'''here'''", or in another article where it is transcluded, which we will call "'''there'''". | They determine whether or not wikitext renders, either in its own article, which we will call "'''here'''", or in another article where it is transcluded, which we will call "'''there'''". | ||
* '''<nowiki><noinclude></nowiki>: ''' the content '''will not be rendered ''there'''''. These tags have no effect ''here''. | * '''<nowiki><noinclude></nowiki>: ''' the content '''will not be rendered ''there'''''. These tags have no effect ''here''. | ||
* '''<nowiki><includeonly></nowiki>: ''' the content '''will render only ''there''''', and '''will not render ''here''''' (like | * '''<nowiki><includeonly></nowiki>: ''' the content '''will render only ''there''''', and '''will not render ''here''''' (like invisible ink made visible by means of transclusion). | ||
* '''<nowiki><onlyinclude></nowiki>: ''' the content '''will render ''here''''' and '''will render ''there''''', but it will only render ''there'' what is between these tags. | * '''<nowiki><onlyinclude></nowiki>: ''' the content '''will render ''here''''' and '''will render ''there''''', but it will only render ''there'' what is between these tags. | ||
There can be several such section " | There can be several such section "elements". Also, they can be nested. All possible renderings are achievable. For example, to render ''there'' one or more sections of the page ''here'' use '''<nowiki><onlyinclude></nowiki>''' tags. To append text ''there'', wrap the addition in '''<nowiki><includeonly></nowiki>''' tags before, within, or after the section. To omit portions of the section, nest '''<nowiki><noinclude></nowiki>''' tags within it. | ||
If a page is transcluded without transclusion markup, it may cause an unintentional categorization. Any page transcluding it will contain the same category as the original page. Wrap the category markup with '''<nowiki><noinclude></nowiki>''' tags to prevent incorrect categorization. | |||
Some templates take ''parameters'', as well, which you separate with the pipe character <code>|</code>. | Some templates take ''parameters'', as well, which you separate with the pipe character <code>|</code>. |
Revision as of 00:19, 7 January 2019
You can format your text by using wiki markup. This consists of normal characters like asterisks, apostrophes or equal signs 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 pairs of apostrophes 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'' |
Small chunks of source code within a line of normal text.
Code is displayed in a monospace font. |
function <code>int m2()</code> is nice. |
function int m2() is nice.
|
Small text | Text can be made <small>smaller like this</small> |
Text can be made smaller like this |
Big text | Text can be made <big>bigger like this</big> |
Text can be made bigger like this |
Section formatting – only at the beginning of the line | ||
Section Headings of different levels | == Level 2 == === Level 3 === ==== Level 4 ==== ===== Level 5 ===== ====== Level 6 ====== |
Level 2
Level 4 Level 5 Level 6 |
Horizontal rule | Text before ---- Text after |
Text before Text after |
Line Breaks | A single newline here has no effect on the layout. But an empty line starts a new paragraph, or ends a list or an indented part. Lines can be forced to break <br> like this. |
A single newline here has no effect on the layout.
But an empty line starts a new paragraph, or ends a list or an indented part. Lines can be forced to break like this. |
Bullet list |
* Start each line * with an [[Wikipedia:asterisk|asterisk]] (*). ** More asterisks give deeper *** and deeper levels. * Line breaks <br />don't break levels. *** But jumping levels creates empty space. Any other start ends the list. * combine bullet list ** with definition ::- definition ** creates empty space * combine bullet list ** with definition *:- definition ** without empty spaces *bullet list :- definition :* sublist that doesn't create empty :* spaces after definition |
Any other start ends the list.
|
Numbered list |
# Start each line # with a [[Wikipedia:Number_sign|number sign]] (#). ## More number signs give deeper ### and deeper ### levels. # Line breaks <br />don't break levels. ### But jumping levels creates empty space. # Blank lines # end the list and start another. Any other start also ends the list. |
Any other start also ends the list. |
Definition list | ;item 1 : definition 1 ;item 2 : definition 2-1 : definition 2-2 |
|
Indent text | : Single indent :: Double indent ::::: Multiple indent
|
|
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 looks like a continuation #: and is often used #: instead <br />of <nowiki><br /></nowiki> # five ## five sub 1 ### five sub 1 sub 1 ## five sub 2 |
|
Preformatted text | Start each line with a space. Text is '''preformatted''' and ''markups'' '''''can''''' be done. |
Start each line with a space. Text is preformatted and markups can be done. |
Preformatted text blocks | <nowiki> Start with a space in the first column, (before the <tvar|1><nowiki></>). Then your block format will be maintained. This is good for copying in code blocks: def function(): """ documentation string""" if True: print True else: print False<nowiki> |
Start with a space in the first column, (before the <nowiki>). Then your block format will be maintained. This is good for copying in code blocks: def function(): """ documentation string""" if True: print True else: print False |
Paragraphs
MediaWiki ignores single line breaks. To start a new paragraph, leave an empty line. You can force a line break within a paragraph with the HTML tag <br />
.
HTML tags
Some HTML tags are allowed in MediaWiki, for example <code>
, <div>
, and <span>
. These apply anywhere you insert them.
Description | You type | You get |
---|---|---|
Inserted (Displays as underline in most browsers) |
<ins> Inserted</ins> or <u> Underline</u> |
Inserted or Underline |
Deleted (Displays as strikethrough in most browsers) |
<s> Struck out</s> or <del> Deleted</del> |
or
|
Fixed width text | <code> Source code</code> or <code> Fixed width text</code> |
or
|
Blockquotes | Text before <blockquote> Blockquote</blockquote> Text after |
Text before
Text after |
Quotes | <q> This is a quotation</q>
|
This is a quotation |
Comment | <!-- This is a comment --> Comments are visible only in the edit zone. |
Comments are visible only in the edit zone. |
Completely preformatted text | <pre> Text is '''preformatted''' and ''markups'' '''''cannot''''' be done</pre> |
Text is '''preformatted''' and ''markups'' '''''cannot''''' be done |
Customized preformatted text | <pre style="color: red"> Text is '''preformatted''' with a style and ''markups'' '''''cannot''''' be done </pre> |
Text is '''preformatted''' with a style and ''markups'' '''''cannot''''' be done |
continued:
Description | You type | You get |
---|---|---|
Default preformatted text has a CSS attribute (white-space: pre-wrap; ) to wrap the text according to available width
|
<pre> This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer. </pre> |
This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer. |
Customized preformatted text with disabled text wrapping | <pre style="white-space: pre;"> This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer. </pre> |
This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer. This additional sentence makes the text even longer. |
Inserting symbols
Symbols and other special characters not available on your keyboard can be inserted in a multitude of ways. Many Operating Systems and browsers allow you to insert special characters through a menu option or Operating System panel.
As a last resort, you can use a special sequence of characters. Those sequences are called HTML entities. For example, the following sequence (entity) → when inserted will be shown as right arrow HTML symbol → and — when inserted will be shown as an em dash HTML symbol —.
HTML symbol entities | |||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Á | á | Â | â | ´ | Æ | æ | À | à | ℵ | Α | α | & | ∧ | ∠ | Å | å | ≈ | Ã | ã | Ä | ä | „ | Β | β | ¦ | • | ∩ | Ç | ç | ¸ | ¢ |
Χ | χ | ˆ | ♣ | ≅ | © | ↵ | ∪ | ¤ | † | ‡ | ↓ | ⇓ | ° | Δ | δ | ♦ | ÷ | É | é | Ê | ê | È | è | ∅ | Ε | ε | ≡ | Η | η | ||
Ð | ð | Ë | ë | € | ∃ | ƒ | ∀ | ½ | ¼ | ¾ | ⁄ | Γ | γ | ≥ | > | ↔ | ⇔ | ♥ | … | Í | í | Î | î | ¡ | Ì | ì | ℑ | ∞ | ∫ | Ι | ι |
¿ | ∈ | Ï | ï | Κ | κ | Λ | λ | ⟨ | « | ← | ⇐ | ⌈ | “ | ≤ | ⌊ | ∗ | ◊ | | ‹ | ‘ | < | ¯ | — | µ | · | − | Μ | μ | ∇ | – | |
≠ | ∋ | ¬ | ∉ | ⊄ | Ñ | ñ | Ν | ν | Ó | ó | Ô | ô | Œ | œ | Ò | ò | ‾ | Ω | ω | Ο | ο | ⊕ | ∨ | ª | º | Ø | ø | Õ | õ | ⊗ | Ö |
ö | ¶ | ∂ | ‰ | ⊥ | Φ | φ | Π | π | ϖ | ± | £ | ′ | ″ | ∏ | ∝ | Ψ | ψ | " | √ | ⟩ | » | → | ⇒ | ⌉ | ” | ℜ | ® | ⌋ | Ρ | ρ | |
› | ’ | ‚ | Š | š | ⋅ | § | | Σ | σ | ς | ∼ | ♠ | ⊂ | ⊆ | ∑ | ⊃ | ¹ | ² | ³ | ⊇ | ß | Τ | τ | ∴ | Θ | θ | ϑ | Þ | þ | ˜ | |
× | ™ | Ú | ú | ↑ | ⇑ | Û | û | Ù | ù | ¨ | ϒ | Υ | υ | Ü | ü | ℘ | Ξ | ξ | Ý | ý | ¥ | ÿ | Ÿ | Ζ | ζ | | |
Description | You type | You get |
---|---|---|
Copyright symbol | © |
|
Greek delta letter symbol | δ |
|
Euro currency symbol | € |
|
See the list of all HTML entities on the Wikipedia article List of HTML entities. Additionally, MediaWiki supports two non-standard entity reference sequences: &רלמ;
and &رلم;
which are both considered equivalent to ‏
which is a right-to-left mark. (Used when combining right to left languages with left to right languages in the same page.)
HTML tags and symbol entities displayed themselves (with and without interpreting them)
&euro;
→ €
<span style="color: red; text-decoration: line-through;"> Typo to be corrected</span>
→ Typo to be corrected
<span style="color: red; text-decoration: line-through;">Typo to be corrected</span>
→ <span style="color: red; text-decoration: line-through;"> Typo to be corrected</span>
Nowiki for HTML
<nowiki /> can prohibit (HTML) tags:
- <<nowiki />pre> → <pre>
But not & symbol escapes:
- &<nowiki />amp; → &
To print & symbol escapes as text, use "&
" to replace the "&" character (eg. type "&nbsp;
", which results in "
")
Lists
Do not leave blank lines between items in a list unless there is a reason to do so, since this causes the MediaWiki software to interpret each item as beginning a new list.
Unordered lists
Markup | Renders as |
---|---|
* Item1 * Item2 * Item3 * Item4 ** Sub-item 4 a) *** Sub-item 4 a) 1. **** Sub-item 4 a) 1. i) **** Sub-item 4 a) 1. ii) ** Sub-item 4 b) * Item5 |
|
Ordered lists
Markup | Renders as |
---|---|
# Item1 # Item2 # Item3 # Item4 ## Sub-item 1 ### Sub-sub-item #### Sub-sub-sub-item ## Sub-item 2 # Item5 |
|
Template:AnchorDescription lists
To list terms and definitions, start a new line with a semicolon (;) followed by the term. Then, type a colon (:) followed by a definition. The format can also be used for other purposes, such as make and models of vehicles, etc.
Description lists (formerly definition lists, and a.k.a. association lists) consist of group names corresponding to values. Group names (terms) are in bold. Values (definitions) are indented. Each group must include one or more definitions. For a single or first value, the :
can be placed on the same line after ;
– but subsequent values must be placed on separate lines.
Do not use a semicolon (;) simply to bold a line without defining a value using a colon (:). This usage renders invalid HTML5 and creates issues with screen readers.
Markup | Renders as |
---|---|
; Term : Definition1 |
|
; Term : Definition1 : Definition2 : Definition3 : Definition4 |
|
HTML equivalent: Template:tag Template:tag, Template:tag Template:tag
Links
Internal Links
In most wikis, internal links are used in wikitext markup instead of regular urls to simplify linking and reading
Description | You type | You get |
---|---|---|
Internal link | Arma is made by [[Bohemia Interactive]]. |
Arma is made by Bohemia Interactive. |
Renamed link | Ylands is also made by [[Bohemia Interactive|BI]]. |
Ylands is also made by BI. |
Auto renamed links (pipe trick) | ||
Auto renamed link (pipe trick) | [[createTrigger (VBS1)|]] |
createTrigger |
Automatically hide stuff in parentheses | [[createTrigger (VBS1)|]] |
createTrigger |
Automatically hide the comma and following text | [[Seattle, Washington|]] |
Seattle |
Automatically hide namespace | [[Wikipedia:Village pump|]] |
Village pump |
Or both | [[Wikipedia:Manual of Style (headings)|]] |
Manual of Style |
Does not work for section links | [[Wikipedia:Manual of Style#Links|]] |
[[Wikipedia:Manual of Style#Links|]] |
Link to a section of a page
You can add the specific section you want to link by adding the seciton title to the link after a # (hash).
You type | You get |
---|---|
[[Wikipedia:Manual of Style#Italics]] is a link to a section within another page. |
Wikipedia:Manual of Style#Italics is a link to a section within another page. |
[[Wikipedia:Manual of Style#Italics|Italics]] is a piped link to a section within another page. |
Italics is a piped link to a section within another page. |
Blended links
Desctiption | You type | You get |
---|---|---|
Blending active | San Francisco also has [[public transport]]ation. Examples include [[bus]]es, [[taxicab]]s, and [[tram]]s. |
San Francisco also has public transportation. Examples include buses, taxicabs, and trams. |
Blending supressed | A [[micro-]]<nowiki />second. |
A micro-second. |
Redirects
Redirects are used to redirect specific pages to another page.
Description | What you type |
---|---|
Redirect to an article |
|
Redirect to a section |
|
Link to another namespace
What you type | What it looks like |
---|---|
|
See the Wikipedia:Manual of Style. |
Categories
Categories are used to categorize articles. You can add links of a category to a page to add that article. To link to a category you have to add Category:nameofcategory
.
Description | What you type | What it looks like |
---|---|---|
Add article to category | [[Category:Character sets]]
|
|
Link to a category | [[:Category:Character sets]]
|
Category:Character sets |
Without prefix. | [[:Category:Character sets|]]
|
Character sets |
External links
External links link to external websites other than the Biki. These links are in url format.
Description | What you type | What it looks like |
---|---|---|
Named link with an external link icon |
|
|
Unnamed link (Used only within article body for footnotes) |
|
|
Bare URL (Bad style) use <nowiki></nowiki> to keep this bad style from showing |
|
|
Link without arrow (Not often used) |
|
Images
Images can be put into a page using internal links in [[Image:]] or [[File:]]
format.
What you type | What it looks like |
---|---|
[[Image:image]]
|
File:image |
[[File:image]]
|
File:image |
Tables
There are 2 ways to make tables in wikitext
- Using wikitable(recommended)
- Using HTML elements:
<table>
,<tr>
,<td>
,<th>
https://en.wikipedia.org/wiki/index.php?title=Help:Table&action=edit&redlink=1
Templates and transclusions
Templates are segments of wiki markup that are meant to be copied automatically ("transcluded") into a page. You add them by putting the template's name in {{double braces}}. It is also possible to transclude other pages by using {{:colon and double braces}}.
There are three pairs of tags that can be used in wikitext to control how transclusion affects parts of a template or article. They determine whether or not wikitext renders, either in its own article, which we will call "here", or in another article where it is transcluded, which we will call "there".
- <noinclude>: the content will not be rendered there. These tags have no effect here.
- <includeonly>: the content will render only there, and will not render here (like invisible ink made visible by means of transclusion).
- <onlyinclude>: the content will render here and will render there, but it will only render there what is between these tags.
There can be several such section "elements". Also, they can be nested. All possible renderings are achievable. For example, to render there one or more sections of the page here use <onlyinclude> tags. To append text there, wrap the addition in <includeonly> tags before, within, or after the section. To omit portions of the section, nest <noinclude> tags within it.
If a page is transcluded without transclusion markup, it may cause an unintentional categorization. Any page transcluding it will contain the same category as the original page. Wrap the category markup with <noinclude> tags to prevent incorrect categorization.
Some templates take parameters, as well, which you separate with the pipe character |
.