Changes
Nordic Larp Wiki:Tutorial/Formatting (view source)
Revision as of 21:55, 25 February 2018
, 6 years agoWiki markup
{{pp-semi-indef}}{{pp-move-indef}}
__NOEDITSECTION__
{{Wikipedia:Tutorial/TabsHeader|This=3}}
<div style="border: 2px solid #A3B1BF; padding: .5em 1em 1em 1em; border-top: none; background-color: #fff; color: #000;">
{{TOCright}}
'''Formatting a Wikipedia article''' is different from writing in a standard [[word processor]] or in Wikipedia's [[Special:Preferences#mw-prefsection-betafeatures|opt-in]], alternative editing environment, [[Wikipedia:VisualEditor|VisualEditor]]. Instead of a strict [[WYSIWYG]] approach ("What You See Is What You Get"), Wikipedia uses text codes called '''wiki tags''' to create particular elements of the page (e.g. headings). This [[lightweight markup language|markup language]] is known as '''[[Wiki markup|wikitext]]''' (or '''wiki-markup''') and is designed for ease of editing. See the [[WP:CHEAT|cheatsheet]] for a quick reference list of wikitext codes. Complicated articles may be best modeled on the layout of an existing article of appropriate structure and topic.
==Basic markup==
===Bold and italics ===
The most commonly used wiki tags are '''bold''' and ''italics''. '''Bolding''' and ''italicizing'' are done by surrounding a word or phrase with multiple apostrophes (<tt>'</tt>):
[[File:Boldness and links tutorial.ogv|thumb|250px|A tutorial video explaining how to make bold text and wikilinks]]
[[File:Wiki_markup_cheatsheet_EN.pdf|thumb|Wiki markup quick reference (PDF download)]]
{| style="border:none; text-align:left; padding:0.3em;"
|-<!-- COLUMN HEADINGS -->
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You type'''
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You get'''
|-<!-- 1ST ROW -->
|<tt><nowiki>''italic''</nowiki></tt>
|''italic''
|-<!-- 2ND ROW -->
|
<tt><nowiki>'''bold'''</nowiki></tt>
|
'''bold'''
|-<!-- 3RD ROW -->
|
<tt><nowiki>'''''bold italic'''''</nowiki></tt>
|
'''''bold italic'''''
|}
On Wikipedia, the names of an article's subject are written in '''bold''' when they are first mentioned in the article. For example, the article [[Elizabeth II]] begins:
:'''Elizabeth II''' (Elizabeth Alexandra Mary, born 21 April 1926) is the constitutional monarch of 16 sovereign states, known as the Commonwealth realms, and their territories and dependencies, and head of the 53-member Commonwealth of Nations. ...
''Italics'' may be used for the names of books, movies, albums, and computer or video game titles. If the first mention of the subject of an article is also a book or movie title, then '''''bold italic''''' is used.
===Headings and subheadings===
Headings and subheadings are a way to organize an article. If an article discusses several topics and dedicates more than a couple of paragraphs to each, you can make the article more readable by inserting a heading for each topic ā that is, creating a '''[[Help:Section|section]]''' for each topic.
You can also create sections within sections (i.e., subsections) by using subheadings:
==Subheading example==
You create headings surrounding the heading text with several '=' wiki tags. The more '=' symbols in the wiki tag, the more nested the heading is:
{| style="border:none; text-align:left; padding:0.3em;"
|-<!-- COLUMN HEADINGS -->
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You type'''
| width="50%" style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You get'''
|-
|
<tt><nowiki>== Elizabeth II hats ==</nowiki></tt> <br/>
|
== Elizabeth II hats ==
|-
|
<tt><nowiki>=== Straw hats ===</nowiki></tt> <br />
|
=== Straw hats ===
|}
If an article has at least four headings, a table of contents is automatically 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.
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Help:Wiki markup]]'''</div>{{-}}
==Using the editor toolbars ==
===Wiki markup===
The Wikipedia editor has two toolbars with buttons that help with the use of wikimarkup. For instance, if you want to type a text in bold, instead of manually typing the <code><nowiki>'''</nowiki></code> tags, you can just press the '''Bold''' button and then type the text in bold directly.
If your toolbar looks like this:
{| class="wikitable"
|+ Enhanced toolbar: main selections
|-
| colspan="4" style="text-align: center;" |[[File:RefToolbar 2.0a.png|Enhanced editing toolbar|link=]]
|-
! Icon !! Function !! What it shows when editing !! What it shows on the page
|-
|[[File:Vector toolbar bold B button.png|Bold text|link=]]
|Bold
|<code><nowiki>'''Bold text'''</nowiki></code>
|'''Bold text'''
|-
|[[File:Vector toolbar italic I button.png|Italic text|link=]]
|Italic
|<code><nowiki>''Italic text''</nowiki></code>
|''Italic text''
|-
|[[File:Vector toolbar insert external link button.png|External link|link=]]
|External link
|<code><nowiki>[http://www.example.com link title]</nowiki></code>
| [http://www.example.com link title]
|-
|[[File:Vector toolbar insert internal link button.png|Internal link|link=]]
|Internal link
|<code><nowiki>[[Link title]]</nowiki></code>
|[[Link title]]
|-
|[[File:Vector toolbar insert image button.png|Embedded file|link=]]
|Insert image
|<code><nowiki>[[File:Example.jpg|thumbnail]]</nowiki></code>
| [[File:Example.jpg|90px|thumbnail]]
|-
| [[File:Vector toolbar insert reference button.png|link=]]
| Insert {{fnote}}
| <code><nowiki><ref>Insert footnote text here</ref></nowiki></code>
| <ref>Insert footnote text here</ref>
|-
|[[File:Vector toolbar signature button.png|40px|Your signature with timestamp|link=]]
|Sign talk comments<br />(with time stamp)
|<code><nowiki>--~~~~</nowiki></code>
|[[Special:Mypage|Username]] ([[Special:Mytalk|talk]]) {{CURRENTTIME}}, {{CURRENTDAY}} {{CURRENTMONTHNAME}} {{CURRENTYEAR}} (UTC)
|-
|}
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Help:Edit toolbar]] '''</div><br>
{{-}}
===VisualEditor===
The '''[[Wikipedia:VisualEditor/User guide#Getting started: the VisualEditor toolbar|VisualEditor toolbar]]''' appears at the top of the screen when you begin editing.
<div class="overflowbugx" style="overflow:auto; width: 90%;">
[[File:VisualEditor toolbar-en.png|frameless|center|1200px|alt=Screenshot of the VisualEditor toolbar]]</div>
[[File:VisualEditor Toolbar Headings-en.png|frameless|border|300px|center]]
'''Headings''' pull-down menu: allows you to change how the paragraph is formatted. To change the style of a paragraph, put your cursor in the paragraph and select an item in this menu (you don't have to highlight any text). Section titles are formatted "{{int:visualeditor-formatdropdown-format-mw-heading2}}", and subsections are "{{int:visualeditor-formatdropdown-format-heading2}}", "{{int:visualeditor-formatdropdown-format-heading3}}", and so on. The normal format for text is "{{int:visualeditor-formatdropdown-format-paragraph}}".
[[File:VisualEditor Toolbar Formatting-en.png|frameless|border|300px|center]]
'''Formatting:''' Clicking the "<u>'''''A'''''</u>" opens a menu.
* The "{{int:visualeditor-annotationbutton-bold-tooltip}}" item ('''B''') bolds the selected text.
* The "{{int:visualeditor-annotationbutton-italic-tooltip}}" item (''I'') italicizes the selected text.
* The "{{int:visualeditor-annotationbutton-superscript-tooltip}}" item (x<sup>2</sup>) causes the selected text to appear smaller than surrounding text and to be slightly higher than the surrounding text.
* The "{{int:visualeditor-annotationbutton-subscript-tooltip}}" item (x<sub>2</sub>) causes the selected text to appear smaller than surrounding text and slightly lower than the surrounding text.
* The "{{int:visualeditor-annotationbutton-strikethrough-tooltip}}" item (<s>S</s>) adds a solid bar through the selected text.
* The "{{int:visualeditor-annotationbutton-code-tooltip}}" item (a set of curly brackets: <code>{}</code>) changes the font of the selected text to a monospaced font, which sets it apart from surrounding (proportionally spaced) text.
* The "{{int:visualeditor-annotationbutton-underline-tooltip}}" item (<u>U</u>) adds a solid line beneath the selected text.
* The "{{int:visualeditor-annotationbutton-language-tooltip}}" item (Ać) allows you to label the language (for example, Japanese) and direction (for example, right-to-left) of the selected text.
* The final item ([[File:VisualEditor MediaWiki theme clear icon bitmap.png]]), called "{{int:visualeditor-clearbutton-tooltip}}", removes all character formatting from the selected text, including links.
<br>
{{-}}
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Wikipedia:VisualEditor/User guide#Getting started: the VisualEditor toolbar|VisualEditor toolbar]] '''</div><br>
{{clear}}
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Wikipedia:Simplified ruleset]]'''</div>
{{clear}}
----
<small>'''Note:''' ''To view this information in an article style format, see [[Wikipedia:Contributing to Wikipedia|contributing to Wikipedia]]. Wikipedia also has "[[Help:Getting started|topic specific tutorials]]"; and [[Wikipedia:The Wikipedia Adventure|The Wikipedia Adventure]] a comprehensive and fun 7-mission interactive guided tour, which covers all the essentials about editing and the [[Wikipedia:Expectations and norms of the Wikipedia community|expectations and norms of the Wikipedia community]].''</small>
----
{{clear}}
<noinclude>
<div style="float: right; margin-top: 0.0em; margin-bottom: 3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border: 1px solid #a3b1bf;">'''Continue the tutorial with [[Wikipedia:Tutorial/Wikipedia links|Wikipedia links]]''' <span style="font-size: larger; font-weight: bold;">ā</span></div>
</div></noinclude>
<div style="clear:both"></div><noinclude>
[[Category:Wikipedia tutorials|*2]]
[[Category:Wikipedia text help]]
[[fr:Aide:Syntaxe]]
</noinclude>
__NOEDITSECTION__
{{Wikipedia:Tutorial/TabsHeader|This=3}}
<div style="border: 2px solid #A3B1BF; padding: .5em 1em 1em 1em; border-top: none; background-color: #fff; color: #000;">
{{TOCright}}
'''Formatting a Wikipedia article''' is different from writing in a standard [[word processor]] or in Wikipedia's [[Special:Preferences#mw-prefsection-betafeatures|opt-in]], alternative editing environment, [[Wikipedia:VisualEditor|VisualEditor]]. Instead of a strict [[WYSIWYG]] approach ("What You See Is What You Get"), Wikipedia uses text codes called '''wiki tags''' to create particular elements of the page (e.g. headings). This [[lightweight markup language|markup language]] is known as '''[[Wiki markup|wikitext]]''' (or '''wiki-markup''') and is designed for ease of editing. See the [[WP:CHEAT|cheatsheet]] for a quick reference list of wikitext codes. Complicated articles may be best modeled on the layout of an existing article of appropriate structure and topic.
==Basic markup==
===Bold and italics ===
The most commonly used wiki tags are '''bold''' and ''italics''. '''Bolding''' and ''italicizing'' are done by surrounding a word or phrase with multiple apostrophes (<tt>'</tt>):
[[File:Boldness and links tutorial.ogv|thumb|250px|A tutorial video explaining how to make bold text and wikilinks]]
[[File:Wiki_markup_cheatsheet_EN.pdf|thumb|Wiki markup quick reference (PDF download)]]
{| style="border:none; text-align:left; padding:0.3em;"
|-<!-- COLUMN HEADINGS -->
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You type'''
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You get'''
|-<!-- 1ST ROW -->
|<tt><nowiki>''italic''</nowiki></tt>
|''italic''
|-<!-- 2ND ROW -->
|
<tt><nowiki>'''bold'''</nowiki></tt>
|
'''bold'''
|-<!-- 3RD ROW -->
|
<tt><nowiki>'''''bold italic'''''</nowiki></tt>
|
'''''bold italic'''''
|}
On Wikipedia, the names of an article's subject are written in '''bold''' when they are first mentioned in the article. For example, the article [[Elizabeth II]] begins:
:'''Elizabeth II''' (Elizabeth Alexandra Mary, born 21 April 1926) is the constitutional monarch of 16 sovereign states, known as the Commonwealth realms, and their territories and dependencies, and head of the 53-member Commonwealth of Nations. ...
''Italics'' may be used for the names of books, movies, albums, and computer or video game titles. If the first mention of the subject of an article is also a book or movie title, then '''''bold italic''''' is used.
===Headings and subheadings===
Headings and subheadings are a way to organize an article. If an article discusses several topics and dedicates more than a couple of paragraphs to each, you can make the article more readable by inserting a heading for each topic ā that is, creating a '''[[Help:Section|section]]''' for each topic.
You can also create sections within sections (i.e., subsections) by using subheadings:
==Subheading example==
You create headings surrounding the heading text with several '=' wiki tags. The more '=' symbols in the wiki tag, the more nested the heading is:
{| style="border:none; text-align:left; padding:0.3em;"
|-<!-- COLUMN HEADINGS -->
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You type'''
| width="50%" style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You get'''
|-
|
<tt><nowiki>== Elizabeth II hats ==</nowiki></tt> <br/>
|
== Elizabeth II hats ==
|-
|
<tt><nowiki>=== Straw hats ===</nowiki></tt> <br />
|
=== Straw hats ===
|}
If an article has at least four headings, a table of contents is automatically 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.
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Help:Wiki markup]]'''</div>{{-}}
==Using the editor toolbars ==
===Wiki markup===
The Wikipedia editor has two toolbars with buttons that help with the use of wikimarkup. For instance, if you want to type a text in bold, instead of manually typing the <code><nowiki>'''</nowiki></code> tags, you can just press the '''Bold''' button and then type the text in bold directly.
If your toolbar looks like this:
{| class="wikitable"
|+ Enhanced toolbar: main selections
|-
| colspan="4" style="text-align: center;" |[[File:RefToolbar 2.0a.png|Enhanced editing toolbar|link=]]
|-
! Icon !! Function !! What it shows when editing !! What it shows on the page
|-
|[[File:Vector toolbar bold B button.png|Bold text|link=]]
|Bold
|<code><nowiki>'''Bold text'''</nowiki></code>
|'''Bold text'''
|-
|[[File:Vector toolbar italic I button.png|Italic text|link=]]
|Italic
|<code><nowiki>''Italic text''</nowiki></code>
|''Italic text''
|-
|[[File:Vector toolbar insert external link button.png|External link|link=]]
|External link
|<code><nowiki>[http://www.example.com link title]</nowiki></code>
| [http://www.example.com link title]
|-
|[[File:Vector toolbar insert internal link button.png|Internal link|link=]]
|Internal link
|<code><nowiki>[[Link title]]</nowiki></code>
|[[Link title]]
|-
|[[File:Vector toolbar insert image button.png|Embedded file|link=]]
|Insert image
|<code><nowiki>[[File:Example.jpg|thumbnail]]</nowiki></code>
| [[File:Example.jpg|90px|thumbnail]]
|-
| [[File:Vector toolbar insert reference button.png|link=]]
| Insert {{fnote}}
| <code><nowiki><ref>Insert footnote text here</ref></nowiki></code>
| <ref>Insert footnote text here</ref>
|-
|[[File:Vector toolbar signature button.png|40px|Your signature with timestamp|link=]]
|Sign talk comments<br />(with time stamp)
|<code><nowiki>--~~~~</nowiki></code>
|[[Special:Mypage|Username]] ([[Special:Mytalk|talk]]) {{CURRENTTIME}}, {{CURRENTDAY}} {{CURRENTMONTHNAME}} {{CURRENTYEAR}} (UTC)
|-
|}
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Help:Edit toolbar]] '''</div><br>
{{-}}
===VisualEditor===
The '''[[Wikipedia:VisualEditor/User guide#Getting started: the VisualEditor toolbar|VisualEditor toolbar]]''' appears at the top of the screen when you begin editing.
<div class="overflowbugx" style="overflow:auto; width: 90%;">
[[File:VisualEditor toolbar-en.png|frameless|center|1200px|alt=Screenshot of the VisualEditor toolbar]]</div>
[[File:VisualEditor Toolbar Headings-en.png|frameless|border|300px|center]]
'''Headings''' pull-down menu: allows you to change how the paragraph is formatted. To change the style of a paragraph, put your cursor in the paragraph and select an item in this menu (you don't have to highlight any text). Section titles are formatted "{{int:visualeditor-formatdropdown-format-mw-heading2}}", and subsections are "{{int:visualeditor-formatdropdown-format-heading2}}", "{{int:visualeditor-formatdropdown-format-heading3}}", and so on. The normal format for text is "{{int:visualeditor-formatdropdown-format-paragraph}}".
[[File:VisualEditor Toolbar Formatting-en.png|frameless|border|300px|center]]
'''Formatting:''' Clicking the "<u>'''''A'''''</u>" opens a menu.
* The "{{int:visualeditor-annotationbutton-bold-tooltip}}" item ('''B''') bolds the selected text.
* The "{{int:visualeditor-annotationbutton-italic-tooltip}}" item (''I'') italicizes the selected text.
* The "{{int:visualeditor-annotationbutton-superscript-tooltip}}" item (x<sup>2</sup>) causes the selected text to appear smaller than surrounding text and to be slightly higher than the surrounding text.
* The "{{int:visualeditor-annotationbutton-subscript-tooltip}}" item (x<sub>2</sub>) causes the selected text to appear smaller than surrounding text and slightly lower than the surrounding text.
* The "{{int:visualeditor-annotationbutton-strikethrough-tooltip}}" item (<s>S</s>) adds a solid bar through the selected text.
* The "{{int:visualeditor-annotationbutton-code-tooltip}}" item (a set of curly brackets: <code>{}</code>) changes the font of the selected text to a monospaced font, which sets it apart from surrounding (proportionally spaced) text.
* The "{{int:visualeditor-annotationbutton-underline-tooltip}}" item (<u>U</u>) adds a solid line beneath the selected text.
* The "{{int:visualeditor-annotationbutton-language-tooltip}}" item (Ać) allows you to label the language (for example, Japanese) and direction (for example, right-to-left) of the selected text.
* The final item ([[File:VisualEditor MediaWiki theme clear icon bitmap.png]]), called "{{int:visualeditor-clearbutton-tooltip}}", removes all character formatting from the selected text, including links.
<br>
{{-}}
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Wikipedia:VisualEditor/User guide#Getting started: the VisualEditor toolbar|VisualEditor toolbar]] '''</div><br>
{{clear}}
<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information, see [[Wikipedia:Simplified ruleset]]'''</div>
{{clear}}
----
<small>'''Note:''' ''To view this information in an article style format, see [[Wikipedia:Contributing to Wikipedia|contributing to Wikipedia]]. Wikipedia also has "[[Help:Getting started|topic specific tutorials]]"; and [[Wikipedia:The Wikipedia Adventure|The Wikipedia Adventure]] a comprehensive and fun 7-mission interactive guided tour, which covers all the essentials about editing and the [[Wikipedia:Expectations and norms of the Wikipedia community|expectations and norms of the Wikipedia community]].''</small>
----
{{clear}}
<noinclude>
<div style="float: right; margin-top: 0.0em; margin-bottom: 3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border: 1px solid #a3b1bf;">'''Continue the tutorial with [[Wikipedia:Tutorial/Wikipedia links|Wikipedia links]]''' <span style="font-size: larger; font-weight: bold;">ā</span></div>
</div></noinclude>
<div style="clear:both"></div><noinclude>
[[Category:Wikipedia tutorials|*2]]
[[Category:Wikipedia text help]]
[[fr:Aide:Syntaxe]]
</noinclude>