Help:Wikitext examples: Difference between revisions

Revision as of 18:10, 30 May 2024

Latest revision as of 21:11, 29 July 2024

Line 1:

{{MovedToMediaWiki}}

{{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², H₂O

|<syntaxhighlight lang=wikitext>

Superscripts and subscripts:

X², H₂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 (&lt;!-- --&gt;)

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:[e-mail] or [mailto:[e-mail] someone]

|

<syntaxhighlight lang=wikitext>

Linking to an e-mail address works the same way:

mailto:[e-mail] or [mailto:[e-mail] 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: &rarr;

</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: &rarr;

</nowiki>

</syntaxhighlight>

|-

|

<pre>

The pre tag ignores [[Wiki]]

''markup''.

It also doesn't reformat

text.

It still interprets special

characters: &rarr;

</pre>

|<syntaxhighlight lang=wikitext><pre>

The pre tag ignores [[Wiki]]

''markup''.

It also doesn't reformat

text.

It still interprets special

characters: &rarr;

</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: &rarr;

|<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: &rarr;

</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|mw: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]]

{{h:f|enname=Wikitext examples}}