Help:Wikitext examples: Difference between revisions
Replaced content with "Category:Editor handbook" Tags: Replaced deletion template removed Visual edit Mobile edit Mobile web edit |
MathXplore (talk | contribs) m Reverted changes by 2401:D800:EC1:F131:E59E:2685:3640:9CEC (talk) to last version by Waldyrious: unexplained content removal Tags: Rollback SWViewer [1.6] |
||
(45 intermediate revisions by 24 users not shown) | |||
Line 1: | Line 1: | ||
{{H:h|Editor toc}} |
|||
:''For basic information see [[Help:Editing]].'' |
|||
== Basic text formatting == |
|||
You can format the page using Wikitext special characters. |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="500"|What you type |
|||
|- |
|||
| |
|||
You can ''italicize'' text by putting 2 |
|||
apostrophes on ''each'' side. |
|||
3 apostrophes will '''bold''' the text. |
|||
5 apostrophes will '''''bold and italicize''''' |
|||
the text. |
|||
(Using 4 apostrophes doesn't do anything |
|||
special -- <br /> 3 of them '''bold''' the text as |
|||
usual; the others are ''''just'''' apostrophes |
|||
around the text.) |
|||
|<syntaxhighlight lang=wikitext> |
|||
You can ''italicize'' text by putting 2 |
|||
apostrophes on ''each'' side. |
|||
3 apostrophes will '''bold''' the text. |
|||
5 apostrophes will '''''bold and italicize''''' |
|||
the text. |
|||
(Using 4 apostrophes doesn't do anything |
|||
special -- <br /> 3 of them '''bold''' the text as |
|||
usual; the others are ''''just'''' apostrophes |
|||
around the text.) |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
A single newline |
|||
generally has no effect on the layout. |
|||
These can be used to separate |
|||
sentences within a paragraph. |
|||
Some editors find that this aids editing |
|||
and improves the ''diff'' function |
|||
(used internally to compare |
|||
different versions of a page). |
|||
But an empty line |
|||
starts a new paragraph. |
|||
When used in a list, a newline ''does'' affect the layout ([[#lists|see below]]). |
|||
|<syntaxhighlight lang=wikitext> |
|||
A single newline |
|||
generally has no effect on the layout. |
|||
These can be used to separate |
|||
sentences within a paragraph. |
|||
Some editors find that this aids editing |
|||
and improves the ''diff'' function |
|||
(used internally to compare |
|||
different versions of a page). |
|||
But an empty line |
|||
starts a new paragraph. |
|||
When used in a list, a newline ''does'' |
|||
affect the layout ([[#lists|see below]]). |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can break lines<br/> |
|||
without a new paragraph.<br/> |
|||
Please use this sparingly. |
|||
Please do not start a link or ''italics'' or '''bold''' text on one line and end on the next. |
|||
|<syntaxhighlight lang=wikitext> |
|||
You can break lines<br/> |
|||
without a new paragraph.<br/> |
|||
Please use this sparingly. |
|||
Please do not start a link or |
|||
''italics'' or '''bold''' text on one line |
|||
and end on the next. |
|||
</syntaxhighlight> |
|||
|- |
|||
|You should "sign" your comments on talk pages: <br/> |
|||
<div class="mw-notalk"> |
|||
* Three tildes gives your signature: [[User:Example|Example]] <br/> |
|||
* Four tildes give your signature plus date/time: [[User:Example|Example]] 07:46, 27 November 2005 (UTC) <br/> |
|||
* Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC) <br/> |
|||
</div> |
|||
|<syntaxhighlight lang=wikitext> |
|||
You should "sign" your comments |
|||
on talk pages: |
|||
* Three tildes gives your |
|||
signature: ~~~ |
|||
* Four tildes give your |
|||
signature plus date/time: ~~~~ |
|||
* Five tildes gives the |
|||
date/time alone: ~~~~~ |
|||
</syntaxhighlight> |
|||
|} |
|||
== HTML tags == |
|||
{{main|Help:HTML in wikitext}} |
|||
You can use some HTML tags, too. However, you should avoid HTML in favor of Wiki markup whenever possible. |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="500"|What you type |
|||
|- |
|||
| |
|||
Put text in a <kbd>monospace ('typewriter') |
|||
font</kbd>. The same font is |
|||
generally used for <code> |
|||
computer code</code>. |
|||
|<syntaxhighlight lang=wikitext> |
|||
Put text in a <kbd>monospace ('typewriter') |
|||
font</kbd>. The same font is |
|||
generally used for <code> |
|||
computer code</code>. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
<s>Strike out</s> |
|||
or <u>underline</u> text, |
|||
or write it <span style= |
|||
"font-variant:small-caps"> |
|||
in small caps</span>. |
|||
|<syntaxhighlight lang=wikitext> |
|||
<s>Strike out</s> |
|||
or <u>underline</u> text, |
|||
or write it <span style= |
|||
"font-variant:small-caps"> |
|||
in small caps</span>. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
Superscripts and subscripts: |
|||
X<sup>2</sup>, H<sub>2</sub>O |
|||
|<syntaxhighlight lang=wikitext> |
|||
Superscripts and subscripts: |
|||
X<sup>2</sup>, H<sub>2</sub>O |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
<div style="text-align: center;">Centered text</div> |
|||
* Please note the American spelling of "center". |
|||
|<syntaxhighlight lang=wikitext> |
|||
<div style="text-align: center;">Centered text</div> |
|||
* Please note the American spelling of "center". |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
* This is how to <mark>highlight part of a sentence</mark>. |
|||
|<syntaxhighlight lang=wikitext> |
|||
* This is how to <mark>highlight part of a sentence</mark>. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
<blockquote> |
|||
The '''blockquote''' command ''formats'' block |
|||
quotations, typically by surrounding them |
|||
with whitespace. |
|||
</blockquote> |
|||
|<syntaxhighlight lang=wikitext> |
|||
<blockquote> |
|||
The '''blockquote''' command ''formats'' block |
|||
quotations, typically by surrounding them |
|||
with whitespace. |
|||
</blockquote> |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
Invisible comments to editors (<!-- -->) |
|||
appear only while editing the page. |
|||
<!-- Note to editors: blah blah blah. --> |
|||
* If you wish to make comments to the public, you should usually use the [[help:Talk page|talk page]]. |
|||
|<syntaxhighlight lang=wikitext> |
|||
Invisible comments to editors (<!-- -->) |
|||
appear only while editing the page. |
|||
<!-- Note to editors: blah blah blah. --> |
|||
</syntaxhighlight> |
|||
|} |
|||
== Organizing your writing == |
|||
:''See also: [[wikipediawikipedia:Picture tutorial|w:Picture tutorial]]'' |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="500"|What you type |
|||
|- |
|||
| |
|||
''Headings'' organize your writing into |
|||
sections. The ''Wiki'' software can automatically |
|||
generate a [[help:Section|table of contents]] from them. |
|||
<!-- don't use standard since it will move the edit block --> |
|||
<h3>Subsection</h3> |
|||
Using more "equals" (=) signs creates a subsection. |
|||
<h4>A smaller subsection</h4> |
|||
Don't skip levels, like from two to four equals signs. |
|||
Start with 2 equals signs, not 1. If you use only 1 on each side, it will be the equivalent of h1 |
|||
tags, which should be reserved for page titles. |
|||
|<syntaxhighlight lang=wikitext> |
|||
== Section headings == |
|||
''Headings'' organize your writing into |
|||
sections. The ''Wiki'' software can automatically |
|||
generate a [[help:Section|table of contents]] from them. |
|||
=== Subsection === |
|||
Using more "equals" (=) signs creates a subsection. |
|||
==== A smaller subsection ==== |
|||
Don't skip levels, like from two to four equals signs. |
|||
Start with 2 equals signs, not 1. If you use only 1 on each side, it will be the equivalent of h1 tags, which should be reserved for page titles. |
|||
</syntaxhighlight> |
|||
|- id="lists" |
|||
| |
|||
* ''Unordered [[Help:List|list]]s'' are easy to do: |
|||
** Start every line with a asterisk. |
|||
*** More asterisks indicate a deeper level. |
|||
*: Previous item continues. |
|||
** A newline |
|||
* in a list |
|||
marks the end of the list. |
|||
*Of course you can start again. |
|||
|<syntaxhighlight lang=wikitext> |
|||
* ''Unordered lists'' are easy to do: |
|||
** Start every line with a asterisk. |
|||
*** More asterisks indicate a deeper level. |
|||
*: Previous item continues. |
|||
** A newline |
|||
* in a list |
|||
marks the end of the list. |
|||
*Of course you can start again. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
# ''Numbered lists'' are: |
|||
## Very organized |
|||
## Easy to follow |
|||
A newline marks the end of the list. |
|||
# New numbering starts with 1. |
|||
|<syntaxhighlight lang=wikitext> |
|||
# ''Numbered lists'' are: |
|||
## Very organized |
|||
## Easy to follow |
|||
A newline marks the end of the list. |
|||
# New numbering starts with 1. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
Here's a ''definition list'': |
|||
; Word : Definition of the word |
|||
; A longer phrase needing definition |
|||
: Phrase defined |
|||
; A word : Which has a definition |
|||
: Also a second definition |
|||
: And even a third |
|||
Begin with a semicolon. One item per line; |
|||
a newline can appear before the colon, but |
|||
using a space before the colon improves |
|||
parsing. |
|||
|<syntaxhighlight lang=wikitext> |
|||
Here's a ''definition list'': |
|||
; Word : Definition of the word |
|||
; A longer phrase needing definition |
|||
: Phrase defined |
|||
; A word : Which has a definition |
|||
: Also a second definition |
|||
: And even a third |
|||
Begin with a semicolon. One item per line; |
|||
a newline can appear before the colon, but |
|||
using a space before the colon improves |
|||
parsing. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
* You can even do mixed lists |
|||
*# and nest them |
|||
*# inside each other |
|||
*#* or break lines<br>in lists. |
|||
*#; definition lists |
|||
*#: can be |
|||
*#:; nested : too |
|||
|<syntaxhighlight lang=wikitext> |
|||
* You can even do mixed lists |
|||
*# and nest them |
|||
*# inside each other |
|||
*#* or break lines<br>in lists. |
|||
*#; definition lists |
|||
*#: can be |
|||
*#:; nested : too |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
: A colon (:) indents a line or paragraph. |
|||
A newline starts a new paragraph. <br> |
|||
Should only be used on [[help:Talk page|talk pages]]. <br> |
|||
For articles, you probably want the blockquote tag. |
|||
: We use 1 colon to indent once. |
|||
:: We use 2 colons to indent twice. |
|||
::: 3 colons to indent 3 times, and so on. |
|||
|<syntaxhighlight lang=wikitext> |
|||
: A colon (:) indents a line or paragraph. |
|||
A newline starts a new paragraph. |
|||
Should only be used on talk pages. |
|||
For articles, you probably want the blockquote tag. |
|||
: We use 1 colon to indent once. |
|||
:: We use 2 colons to indent twice. |
|||
::: 3 colons to indent 3 times, and so on. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can make ''horizontal dividing lines'' |
|||
(----) to separate text. |
|||
---- |
|||
But you should usually use sections instead, |
|||
so that they go in the table of contents. |
|||
|<syntaxhighlight lang=wikitext> |
|||
You can make ''horizontal dividing lines'' |
|||
(----) to separate text. |
|||
---- |
|||
But you should usually use sections instead, |
|||
so that they go in the table of contents. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can add footnotes to sentences using the ''ref'' tag -- this is especially good for citing a source. |
|||
:There are over six billion people in the world.<ref>CIA World Factbook, 2006.</ref> |
|||
References: <references/> |
|||
For details, see [[Wikipedia:Footnotes]] and [[Help:Footnotes]]. |
|||
| |
|||
<syntaxhighlight lang=wikitext> |
|||
You can add footnotes to sentences using |
|||
the ''ref'' tag -- this is especially good |
|||
for citing a source. |
|||
:There are over six billion people in the |
|||
world.<ref>CIA World Factbook, 2006.</ref> |
|||
References: <references/> |
|||
For details, see [[Wikipedia:Footnotes]] |
|||
and [[Help:Footnotes]]. |
|||
</syntaxhighlight> |
|||
|} |
|||
== Links == |
|||
{{main|Help:Link}} |
|||
You will often want to make clickable ''links'' to other pages. |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="700"|What you type |
|||
|- |
|||
| |
|||
Here's a link to a page named [[Official positions|Official position]]. |
|||
You can even say [[official positions]] |
|||
and the link will show up correctly. |
|||
|<syntaxhighlight lang=wikitext> |
|||
Here's a link to a page named [[Official positions|Official position]]. |
|||
You can even say [[official positions]] |
|||
and the link will show up correctly. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can put formatting around a link. |
|||
Example: ''[[Wikipedia]]''. |
|||
|<syntaxhighlight lang=wikitext> |
|||
You can put formatting around a link. |
|||
Example: ''[[Wikipedia]]''. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
The ''first letter'' of articles is automatically |
|||
capitalized, so [[wikipedia]] goes to the same place |
|||
as [[Wikipedia]]. Capitalization matters after the |
|||
first letter. |
|||
|<syntaxhighlight lang=wikitext> |
|||
The ''first letter'' of articles is automatically |
|||
capitalized, so [[wikipedia]] goes to the same place |
|||
as [[Wikipedia]]. Capitalization matters after the |
|||
first letter. |
|||
</syntaxhighlight > |
|||
|- |
|||
| |
|||
[[Intentionally permanent red link]] is a page that doesn't exist |
|||
yet. You could create it by clicking on the link. |
|||
|<syntaxhighlight lang=wikitext> |
|||
[[Intentionally permanent red link]] is a page that doesn't exist |
|||
yet. You could create it by clicking on the link. |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can link to a page section by its title: |
|||
* [[Doxygen#Doxygen Examples]].. |
|||
If multiple sections have the same title, add |
|||
a number. [[#Example section 3]] goes to the |
|||
third section named "Example section". |
|||
|<syntaxhighlight lang=wikitext> |
|||
You can link to a page section by its title: |
|||
* [[Doxygen#Doxygen Examples]]. |
|||
If multiple sections have the same title, add |
|||
a number. [[#Example section 3]] goes to the |
|||
third section named "Example section". |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can make a link point to a different place |
|||
with a [[Help:Piped link|piped link]]. Put the link |
|||
target first, then the pipe character "|", then |
|||
the link text. |
|||
* [[Help:Link|About Links]] |
|||
* [[List of cities by country#Morocco|Cities in Morocco]] |
|||
Or you can use the "pipe trick" so that a title that |
|||
contains disambiguation text will appear with more concise |
|||
link text. |
|||
* [[Spinning (textiles)|Spinning]] |
|||
* [[Boston, Massachusetts|Boston]] |
|||
|<syntaxhighlight lang=wikitext> |
|||
You can make a link point to a different place |
|||
with a [[Help:Piped link|piped link]]. Put the link |
|||
target first, then the pipe character "|", then |
|||
the link text. |
|||
* [[Help:Link|About Links]] |
|||
* [[List of cities by country#Morocco|Cities in Morocco]] |
|||
</syntaxhighlight> |
|||
<syntaxhighlight lang=wikitext> |
|||
Or you can use the "pipe trick" so that a title that |
|||
contains disambiguation text will appear with more concise |
|||
link text. |
|||
* [[Spinning (textiles)|]] |
|||
* [[Boston, Massachusetts|]] |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can make an external link just by typing a URL: |
|||
http://www.nupedia.com |
|||
You can give it a title: |
|||
[http://www.nupedia.com Nupedia] |
|||
Or leave the title blank: |
|||
[http://www.nupedia.com] |
|||
External link can be used to link to a wiki page that cannot be linked to with <nowiki>[[page]]</nowiki>: |
|||
http://meta.wikimedia.org/w/index.php?title=Fotonotes&oldid=482030#Installation |
|||
| |
|||
<syntaxhighlight lang=wikitext> |
|||
You can make an external link just by typing a URL: |
|||
http://www.nupedia.com |
|||
You can give it a title: |
|||
[http://www.nupedia.com Nupedia] |
|||
Or leave the title blank: |
|||
[http://www.nupedia.com] |
|||
External link can be used to link to a wiki page that |
|||
cannot be linked to with <nowiki>[[page]]</nowiki>: |
|||
http://meta.wikimedia.org/w/index.php?title=Fotonotes |
|||
&oldid=482030#Installation |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
Linking to an e-mail address works the same way: |
|||
mailto:someone@example.com or [mailto:someone@example.com someone] |
|||
| |
|||
<syntaxhighlight lang=wikitext> |
|||
Linking to an e-mail address works the same way: |
|||
mailto:someone@example.com or [mailto:someone@example.com someone] |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
You can [[Help:Redirect|redirect]] the user to another page. |
|||
|<syntaxhighlight lang=wikitext> |
|||
#REDIRECT [[Official positions]] |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
[[Help:Category|Category links]] do not show up in line |
|||
but instead at page bottom |
|||
''and cause the page to be listed in the category.'' |
|||
Add an extra colon to ''link'' to a category in line |
|||
without causing the page to be listed in the category: |
|||
[[:Category:English documentation]] |
|||
|<syntaxhighlight lang=wikitext> |
|||
[[Help:Category|Category links]] do not show up in line |
|||
but instead at page bottom |
|||
''and cause the page to be listed in the category.'' |
|||
[[Category:English documentation]] |
|||
Add an extra colon to ''link'' to a category in line |
|||
without causing the page to be listed in the category: |
|||
[[:Category:English documentation]] |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
The Wiki reformats linked dates to match the reader's |
|||
date preferences. These three dates will show up the |
|||
same if you choose a format in your |
|||
[[Special:Preferences|Preferences]]: |
|||
* [[1969-07-20]] |
|||
* [[July 20]], [[1969]] |
|||
* [[20 July]] [[1969]] |
|||
|<syntaxhighlight lang=wikitext> |
|||
The Wiki reformats linked dates to match the reader's |
|||
date preferences. These three dates will show up the |
|||
same if you choose a format in your |
|||
[[Special:Preferences|]]: |
|||
* [[1969-07-20]] |
|||
* [[July 20]], [[1969]] |
|||
* [[20 July]] [[1969]] |
|||
</syntaxhighlight> |
|||
|} |
|||
==Just show what I typed== |
|||
A few different kinds of formatting will tell the Wiki to display things as you typed them. |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="500"|What you type |
|||
|- |
|||
| |
|||
<nowiki> |
|||
The nowiki tag ignores |
|||
[[Wiki]] ''markup''. |
|||
It reformats text by |
|||
removing |
|||
newlines and multiple |
|||
spaces. |
|||
It still interprets special |
|||
characters: → |
|||
</nowiki> |
|||
|<syntaxhighlight lang=wikitext> |
|||
<nowiki> |
|||
The nowiki tag ignores |
|||
[[Wiki]] ''markup''. |
|||
It reformats text by |
|||
removing |
|||
newlines and multiple |
|||
spaces. |
|||
It still interprets special |
|||
characters: → |
|||
</nowiki> |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
<pre> |
|||
The pre tag ignores [[Wiki]] |
|||
''markup''. |
|||
It also doesn't reformat |
|||
text. |
|||
It still interprets special |
|||
characters: → |
|||
</pre> |
|||
|<syntaxhighlight lang=wikitext><pre> |
|||
The pre tag ignores [[Wiki]] |
|||
''markup''. |
|||
It also doesn't reformat |
|||
text. |
|||
It still interprets special |
|||
characters: → |
|||
</pre></syntaxhighlight> |
|||
|- |
|||
| |
|||
[[Leading spaces]] are another way to preserve formatting. |
|||
Putting a space at the |
|||
beginning of each |
|||
line stops the text |
|||
from being |
|||
reformatted. It still |
|||
interprets [[Wiki]] |
|||
''markup'' and special |
|||
characters: → |
|||
|<syntaxhighlight lang=wikitext> |
|||
Leading spaces are another way |
|||
to preserve formatting. |
|||
Putting a space at the |
|||
beginning of each |
|||
line stops the text |
|||
from being |
|||
reformatted. It still |
|||
interprets [[Wiki]] |
|||
''markup'' and special |
|||
characters: → |
|||
</syntaxhighlight> |
|||
|} |
|||
===Source code=== |
|||
{{main|mw:Extension:SyntaxHighlight}} |
|||
If the syntax highlighting extension is installed, you can display programming language [[w:source code|source code]] in a manner very similar to the HTML <syntaxhighlight lang=wikitext inline><pre></syntaxhighlight> tag, except with the type of [[w:syntax highlighting|syntax highlighting]] commonly found in advanced text editing software. |
|||
List of supported languages: http://pygments.org/languages/ |
|||
Here's an example of how to display some [[w:C Sharp (programming language)|C#]] source code: |
|||
{{#tag:syntaxhighlight|<syntax<nowiki></nowiki>highlight lang="csharp"> |
|||
// Hello World in Microsoft C# ("C-Sharp"). |
|||
using System; |
|||
class HelloWorld |
|||
{ |
|||
public static int Main(String[] args) |
|||
{ |
|||
Console.WriteLine("Hello, World!"); |
|||
return 0; |
|||
} |
|||
} |
|||
</syntaxhighlight>|lang=wikitext}} |
|||
Results in: |
|||
<syntaxhighlight lang="csharp"> |
|||
// Hello World in Microsoft C# ("C-Sharp"). |
|||
using System; |
|||
class HelloWorld |
|||
{ |
|||
public static int Main(String[] args) |
|||
{ |
|||
Console.WriteLine("Hello, World!"); |
|||
return 0; |
|||
} |
|||
} |
|||
</syntaxhighlight> |
|||
==Images, tables, video, and sounds== |
|||
<i>This is a very quick introduction. For more information, see: |
|||
* [[mw:Help:Images]], for how to upload files; |
|||
* [[w:en:Wikipedia:Extended image syntax]], for how to arrange images on the page; |
|||
* [[mw:Help:Tables]], for how to create a table.</i> |
|||
After uploading, just enter the filename, highlight it and press the "embedded image"-button of the edit_toolbar. |
|||
This will produce the syntax for uploading a file '''<nowiki>[[Image:filename.png]]</nowiki>''' |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="500"|What you type |
|||
|- |
|||
| |
|||
A picture, including alternate text: |
|||
[[Image:Wiki.png|This is Wiki's logo]] |
|||
You can put the image in a frame with a caption: |
|||
[[Image:Wiki.png|frame|This is Wiki's logo]] |
|||
|<syntaxhighlight lang=wikitext> |
|||
A picture, including alternate text: |
|||
[[Image:Wiki.png|This is Wiki's logo]] |
|||
You can put the image in a frame with a caption: |
|||
[[Image:Wiki.png|frame|This is Wiki's logo]] |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
A link to Wikipedia's page for the image: |
|||
[[:Image:Wiki.png]] |
|||
Or a link directly to the image itself: |
|||
[[Media:Wiki.png]] |
|||
|<syntaxhighlight lang=wikitext> |
|||
A link to Wikipedia's page for the image: |
|||
[[:Image:Wiki.png]] |
|||
Or a link directly to the image itself: |
|||
[[Media:Wiki.png]] |
|||
</syntaxhighlight> |
|||
|- |
|||
|Use '''media:''' links to link |
|||
directly to sounds or videos: |
|||
[[media:Classical guitar scale.ogg|A sound file]] |
|||
|<syntaxhighlight lang=wikitext> |
|||
Use '''media:''' links to link |
|||
directly to sounds or videos: |
|||
[[media:Classical guitar scale.ogg|A sound file]] |
|||
</syntaxhighlight> |
|||
|- |
|||
|Provide a spoken rendition of some text in a template: |
|||
{{listen |
|||
|title = Flow, my tears |
|||
|filename = Flow, my tears.ogg |
|||
|filesize = 1.41 MB |
|||
}} |
|||
|<syntaxhighlight lang=wikitext> |
|||
Provide a spoken rendition of some text in a template: |
|||
{{listen |
|||
|title = Flow, my tears |
|||
|filename = Flow, my tears.ogg |
|||
|filesize = 1.41 MB |
|||
}} |
|||
</syntaxhighlight> |
|||
|- |
|||
|<center><span style="border:5px double black">'''Text In a Box'''</span></center> |
|||
|<syntaxhighlight lang=wikitext> |
|||
|<span style="border:5px double black">'''Text In a Box'''</span> |
|||
|</syntaxhighlight> |
|||
|- |
|||
| |
|||
{| style="margin: auto; border: 10px solid black; border-spacing: 5px;" |
|||
|- |
|||
! style="padding: 10px;" | This |
|||
! style="padding: 10px;" | is |
|||
|- |
|||
| style="padding: 10px;" | a |
|||
| style="padding: 10px;" | table |
|||
|} |
|||
|<syntaxhighlight lang=wikitext> |
|||
{| style="margin: auto; border: 10px solid black; border-spacing: 5px;" |
|||
|- |
|||
! style="padding: 10px;" | This |
|||
! style="padding: 10px;" | is |
|||
|- |
|||
| style="padding: 10px;" | a |
|||
| style="padding: 10px;" | table |
|||
|} |
|||
</syntaxhighlight> |
|||
|} |
|||
===Galleries=== |
|||
:''Main article: [[wikipediawikipedia:Gallery tag|w:Gallery tag]]'' |
|||
Images can also be grouped into galleries using the <syntaxhighlight lang=wikitext inline><gallery></syntaxhighlight> tag, such as the following: |
|||
<gallery> |
|||
Image:Wiki.png |
|||
Image:Wiki.png|Captioned |
|||
Image:Wiki.png |
|||
Image:Wiki.png|[[Wikipedia|Links]] can be put in captions. |
|||
</gallery> |
|||
== Mathematical formulae == |
|||
{{main|Help:Displaying a formula}} |
|||
You can format mathematical formulae with [[w:TeX|TeX]] markup. |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="500"|What you type |
|||
|- |
|||
|<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math> |
|||
|<syntaxhighlight lang="tex"> |
|||
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math> |
|||
</syntaxhighlight> |
|||
|} |
|||
==Templates== |
|||
{{main|Help:Template}} |
|||
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 <nowiki>{{double braces}}</nowiki>. It is also possible to transclude other pages by using <nowiki>{{:colon and double braces}}</nowiki>. |
|||
Some templates take ''parameters'', as well, which you separate with the pipe character. |
|||
{| border="1" cellpadding="2" cellspacing="0" |
|||
!width="1000"|What it looks like |
|||
!width="500"|What you type |
|||
|- |
|||
| |
|||
{{Transclusion demo}} |
|||
|<syntaxhighlight lang=wikitext> |
|||
{{Transclusion demo}} |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
{{Help:Transclusion Demo}} |
|||
|<syntaxhighlight lang=wikitext> |
|||
{{Help:Transclusion Demo}} |
|||
</syntaxhighlight> |
|||
|- |
|||
| |
|||
This template takes two parameters, and |
|||
creates underlined text with a hover box |
|||
for many modern browsers supporting CSS: |
|||
{{H:title|This is the hover text| |
|||
Hover your mouse over this text}} |
|||
Go to this page to see the H:title template |
|||
itself: {{tl|H:title}} |
|||
|<syntaxhighlight lang=wikitext> |
|||
This template takes two parameters, and |
|||
creates underlined text with a hover box |
|||
for many modern browsers supporting CSS: |
|||
{{H:title|This is the hover text| |
|||
Hover your mouse over this text}} |
|||
Go to this page to see the H:title template |
|||
itself: {{tl|H:title}} |
|||
</syntaxhighlight> |
|||
|} |
|||
[[Category:Editor handbook]] |
[[Category:Editor handbook]] |
||
{{h:f|enname=Wikitext examples}} |
Revision as of 02:51, 5 May 2024
- For basic information see Help:Editing.
Basic text formatting
You can format the page using Wikitext special characters.
What it looks like | What you type |
---|---|
You can italicize text by putting 2 apostrophes on each side. 3 apostrophes will bold the text.
(Using 4 apostrophes doesn't do anything
special -- |
You can ''italicize'' text by putting 2
apostrophes on ''each'' side.
3 apostrophes will '''bold''' the text.
5 apostrophes will '''''bold and italicize'''''
the text.
(Using 4 apostrophes doesn't do anything
special -- <br /> 3 of them '''bold''' the text as
usual; the others are ''''just'''' apostrophes
around the text.)
|
A single newline generally has no effect on the layout. These can be used to separate sentences within a paragraph. Some editors find that this aids editing and improves the diff function (used internally to compare different versions of a page). But an empty line starts a new paragraph. When used in a list, a newline does affect the layout (see below). |
A single newline
generally has no effect on the layout.
These can be used to separate
sentences within a paragraph.
Some editors find that this aids editing
and improves the ''diff'' function
(used internally to compare
different versions of a page).
But an empty line
starts a new paragraph.
When used in a list, a newline ''does''
affect the layout ([[#lists|see below]]).
|
You can break lines Please do not start a link or italics or bold text on one line and end on the next. |
You can break lines<br/>
without a new paragraph.<br/>
Please use this sparingly.
Please do not start a link or
''italics'' or '''bold''' text on one line
and end on the next.
|
You should "sign" your comments on talk pages: |
You should "sign" your comments
on talk pages:
* Three tildes gives your
signature: ~~~
* Four tildes give your
signature plus date/time: ~~~~
* Five tildes gives the
date/time alone: ~~~~~
|
HTML tags
You can use some HTML tags, too. However, you should avoid HTML in favor of Wiki markup whenever possible.
What it looks like | What you type |
---|---|
Put text in a monospace ('typewriter')
font. The same font is
generally used for |
Put text in a <kbd>monospace ('typewriter')
font</kbd>. The same font is
generally used for <code>
computer code</code>.
|
|
<s>Strike out</s>
or <u>underline</u> text,
or write it <span style=
"font-variant:small-caps">
in small caps</span>.
|
Superscripts and subscripts: X2, H2O |
Superscripts and subscripts:
X<sup>2</sup>, H<sub>2</sub>O
|
Centered text
|
<div style="text-align: center;">Centered text</div>
* Please note the American spelling of "center".
|
|
* This is how to <mark>highlight part of a sentence</mark>.
|
|
<blockquote>
The '''blockquote''' command ''formats'' block
quotations, typically by surrounding them
with whitespace.
</blockquote>
|
Invisible comments to editors (<!-- -->) appear only while editing the page.
|
Invisible comments to editors (<!-- -->)
appear only while editing the page.
<!-- Note to editors: blah blah blah. -->
|
Organizing your writing
- See also: w:Picture tutorial
What it looks like | What you type |
---|---|
Headings organize your writing into sections. The Wiki software can automatically generate a table of contents from them.
SubsectionUsing more "equals" (=) signs creates a subsection. A smaller subsectionDon't skip levels, like from two to four equals signs. Start with 2 equals signs, not 1. If you use only 1 on each side, it will be the equivalent of h1 tags, which should be reserved for page titles. |
== Section headings ==
''Headings'' organize your writing into
sections. The ''Wiki'' software can automatically
generate a [[help:Section|table of contents]] from them.
=== Subsection ===
Using more "equals" (=) signs creates a subsection.
==== A smaller subsection ====
Don't skip levels, like from two to four equals signs.
Start with 2 equals signs, not 1. If you use only 1 on each side, it will be the equivalent of h1 tags, which should be reserved for page titles.
|
marks the end of the list.
|
* ''Unordered lists'' are easy to do:
** Start every line with a asterisk.
*** More asterisks indicate a deeper level.
*: Previous item continues.
** A newline
* in a list
marks the end of the list.
*Of course you can start again.
|
A newline marks the end of the list.
|
# ''Numbered lists'' are:
## Very organized
## Easy to follow
A newline marks the end of the list.
# New numbering starts with 1.
|
Here's a definition list:
Begin with a semicolon. One item per line; a newline can appear before the colon, but using a space before the colon improves parsing. |
Here's a ''definition list'':
; Word : Definition of the word
; A longer phrase needing definition
: Phrase defined
; A word : Which has a definition
: Also a second definition
: And even a third
Begin with a semicolon. One item per line;
a newline can appear before the colon, but
using a space before the colon improves
parsing.
|
|
* You can even do mixed lists
*# and nest them
*# inside each other
*#* or break lines<br>in lists.
*#; definition lists
*#: can be
*#:; nested : too
|
A newline starts a new paragraph.
|
: A colon (:) indents a line or paragraph.
A newline starts a new paragraph.
Should only be used on talk pages.
For articles, you probably want the blockquote tag.
: We use 1 colon to indent once.
:: We use 2 colons to indent twice.
::: 3 colons to indent 3 times, and so on.
|
You can make horizontal dividing lines (----) to separate text. But you should usually use sections instead, so that they go in the table of contents. |
You can make ''horizontal dividing lines''
(----) to separate text.
----
But you should usually use sections instead,
so that they go in the table of contents.
|
You can add footnotes to sentences using the ref tag -- this is especially good for citing a source.
For details, see Wikipedia:Footnotes and Help:Footnotes. |
You can add footnotes to sentences using
the ''ref'' tag -- this is especially good
for citing a source.
:There are over six billion people in the
world.<ref>CIA World Factbook, 2006.</ref>
References: <references/>
For details, see [[Wikipedia:Footnotes]]
and [[Help:Footnotes]].
|
Links
You will often want to make clickable links to other pages.
What it looks like | What you type |
---|---|
Here's a link to a page named Official position. You can even say official positions and the link will show up correctly. |
Here's a link to a page named [[Official positions|Official position]].
You can even say [[official positions]]
and the link will show up correctly.
|
You can put formatting around a link. Example: Wikipedia. |
You can put formatting around a link.
Example: ''[[Wikipedia]]''.
|
The first letter of articles is automatically capitalized, so wikipedia goes to the same place as Wikipedia. Capitalization matters after the first letter. |
The ''first letter'' of articles is automatically
capitalized, so [[wikipedia]] goes to the same place
as [[Wikipedia]]. Capitalization matters after the
first letter.
|
Intentionally permanent red link is a page that doesn't exist yet. You could create it by clicking on the link. |
[[Intentionally permanent red link]] is a page that doesn't exist
yet. You could create it by clicking on the link.
|
You can link to a page section by its title: If multiple sections have the same title, add a number. #Example section 3 goes to the third section named "Example section". |
You can link to a page section by its title:
* [[Doxygen#Doxygen Examples]].
If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".
|
You can make a link point to a different place with a piped link. Put the link target first, then the pipe character "|", then the link text. Or you can use the "pipe trick" so that a title that contains disambiguation text will appear with more concise link text. |
You can make a link point to a different place
with a [[Help:Piped link|piped link]]. Put the link
target first, then the pipe character "|", then
the link text.
* [[Help:Link|About Links]]
* [[List of cities by country#Morocco|Cities in Morocco]]
Or you can use the "pipe trick" so that a title that
contains disambiguation text will appear with more concise
link text.
* [[Spinning (textiles)|]]
* [[Boston, Massachusetts|]]
|
You can make an external link just by typing a URL: http://www.nupedia.com You can give it a title: Nupedia Or leave the title blank: [1] External link can be used to link to a wiki page that cannot be linked to with [[page]]: http://meta.wikimedia.org/w/index.php?title=Fotonotes&oldid=482030#Installation |
You can make an external link just by typing a URL:
http://www.nupedia.com
You can give it a title:
[http://www.nupedia.com Nupedia]
Or leave the title blank:
[http://www.nupedia.com]
External link can be used to link to a wiki page that
cannot be linked to with <nowiki>[[page]]</nowiki>:
http://meta.wikimedia.org/w/index.php?title=Fotonotes
&oldid=482030#Installation
|
Linking to an e-mail address works the same way: mailto:someone@example.com or someone |
Linking to an e-mail address works the same way:
mailto:someone@example.com or [mailto:someone@example.com someone]
|
You can redirect the user to another page. |
#REDIRECT [[Official positions]]
|
Category links do not show up in line but instead at page bottom and cause the page to be listed in the category. Add an extra colon to link to a category in line without causing the page to be listed in the category: Category:English documentation |
[[Help:Category|Category links]] do not show up in line
but instead at page bottom
''and cause the page to be listed in the category.''
[[Category:English documentation]]
Add an extra colon to ''link'' to a category in line
without causing the page to be listed in the category:
[[:Category:English documentation]]
|
The Wiki reformats linked dates to match the reader's date preferences. These three dates will show up the same if you choose a format in your Preferences: |
The Wiki reformats linked dates to match the reader's
date preferences. These three dates will show up the
same if you choose a format in your
[[Special:Preferences|]]:
* [[1969-07-20]]
* [[July 20]], [[1969]]
* [[20 July]] [[1969]]
|
Just show what I typed
A few different kinds of formatting will tell the Wiki to display things as you typed them.
What it looks like | What you type |
---|---|
The nowiki tag ignores [[Wiki]] ''markup''. It reformats text by removing newlines and multiple spaces. It still interprets special characters: → |
<nowiki>
The nowiki tag ignores
[[Wiki]] ''markup''.
It reformats text by
removing
newlines and multiple
spaces.
It still interprets special
characters: →
</nowiki>
|
The pre tag ignores [[Wiki]] ''markup''. It also doesn't reformat text. It still interprets special characters: → |
<pre>
The pre tag ignores [[Wiki]]
''markup''.
It also doesn't reformat
text.
It still interprets special
characters: →
</pre>
|
Leading spaces are another way to preserve formatting. Putting a space at the beginning of each line stops the text from being reformatted. It still interprets Wiki markup and special characters: → |
Leading spaces are another way
to preserve formatting.
Putting a space at the
beginning of each
line stops the text
from being
reformatted. It still
interprets [[Wiki]]
''markup'' and special
characters: →
|
Source code
If the syntax highlighting extension is installed, you can display programming language source code in a manner very similar to the HTML <pre>
tag, except with the type of syntax highlighting commonly found in advanced text editing software.
List of supported languages: http://pygments.org/languages/
Here's an example of how to display some C# source code:
<syntaxhighlight lang="csharp">
// Hello World in Microsoft C# ("C-Sharp").
using System;
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</syntaxhighlight>
Results in:
// Hello World in Microsoft C# ("C-Sharp").
using System;
class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
Images, tables, video, and sounds
This is a very quick introduction. For more information, see:
- mw:Help:Images, for how to upload files;
- w:en:Wikipedia:Extended image syntax, for how to arrange images on the page;
- mw:Help:Tables, for how to create a table.
After uploading, just enter the filename, highlight it and press the "embedded image"-button of the edit_toolbar.
This will produce the syntax for uploading a file [[Image:filename.png]]
What it looks like | What you type | ||||
---|---|---|---|---|---|
A picture, including alternate text: You can put the image in a frame with a caption: |
A picture, including alternate text:
[[Image:Wiki.png|This is Wiki's logo]]
You can put the image in a frame with a caption:
[[Image:Wiki.png|frame|This is Wiki's logo]]
| ||||
A link to Wikipedia's page for the image: Image:Wiki.png Or a link directly to the image itself: Media:Wiki.png |
A link to Wikipedia's page for the image:
[[:Image:Wiki.png]]
Or a link directly to the image itself:
[[Media:Wiki.png]]
| ||||
Use media: links to link
directly to sounds or videos: A sound file |
Use '''media:''' links to link
directly to sounds or videos:
[[media:Classical guitar scale.ogg|A sound file]]
| ||||
Provide a spoken rendition of some text in a template: | Provide a spoken rendition of some text in a template:
{{listen
|title = Flow, my tears
|filename = Flow, my tears.ogg
|filesize = 1.41 MB
}}
| ||||
|<span style="border:5px double black">'''Text In a Box'''</span>
|
| |||||
|
{| style="margin: auto; border: 10px solid black; border-spacing: 5px;"
|-
! style="padding: 10px;" | This
! style="padding: 10px;" | is
|-
| style="padding: 10px;" | a
| style="padding: 10px;" | table
|}
|
Galleries
- Main article: w:Gallery tag
Images can also be grouped into galleries using the <gallery>
tag, such as the following:
-
Captioned
-
Links can be put in captions.
Mathematical formulae
You can format mathematical formulae with TeX markup.
What it looks like | What you type |
---|---|
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
|
Templates
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}}.
Some templates take parameters, as well, which you separate with the pipe character.
What it looks like | What you type |
---|---|
This text comes from the page named Template:Transclusion demo. It has been transcluded into this page. |
{{Transclusion demo}}
|
This transclusion demo is a little bit of text from the page Help:Transclusion Demo to be included into any file. |
{{Help:Transclusion Demo}}
|
This template takes two parameters, and creates underlined text with a hover box for many modern browsers supporting CSS: Hover your mouse over this text Go to this page to see the H:title template itself: {{H:title}} |
This template takes two parameters, and
creates underlined text with a hover box
for many modern browsers supporting CSS:
{{H:title|This is the hover text|
Hover your mouse over this text}}
Go to this page to see the H:title template
itself: {{tl|H:title}}
|
Links to other help pages
- Help contents
- Meta · Wikinews · Wikipedia · Wikiquote · Wiktionary · Commons: · Wikidata · MediaWiki · Wikibooks · Wikisource · MediaWiki: Manual · Google
- Versions of this help page (for other languages see further)
- What links here on Meta or from Meta · Wikipedia · MediaWiki
- Reading
- Go · Search · Namespace · Page name · Section · Backlinks · Redirect · Category · Image page · Special pages · Printable version
- Tracking changes
- Recent changes (enhanced) | Related changes · Watching pages · Diff · Page history · Edit summary · User contributions · Minor edit · Patrolled edit
- Logging in and preferences
- Logging in · Preferences
- Editing
- Starting a new page · Advanced editing · Editing FAQ · Export · Import · Shortcuts · Edit conflict · Page size
- Referencing
- Links · URL · · Footnotes
- Style and formatting
- Wikitext examples · CSS · Reference card · HTML in wikitext · Formula · Lists · Table · Sorting · Colors · Images and file uploads
- Fixing mistakes
- Show preview · Reverting edits
- Advanced functioning
- Expansion · Template · Advanced templates · Parser function · Parameter default · Magic words · System message · Substitution · Array · Calculation · Transclusion
- Others
- Special characters · Renaming (moving) a page · Preparing a page for translation · Talk page · Signatures · Sandbox · Legal issues for editors