Difference between revisions of "Help:Editing"

From COGAIN: Communication by Gaze Interaction (hosted by the COGAIN Association)
Jump to navigationJump to search
(Created page with '{{shortcut|H:E}} '''Editing''' refers to the changing of a page by a Wikipedia user. Unless certain restrictions are in effect, such as protection, all pages are edit…')
 
 
Line 1: Line 1:
{{shortcut|H:E}}
+
For basic information see [[Help:Editing]].
'''Editing''' refers to the changing of a page by a Wikipedia user. Unless certain restrictions are in effect, such as [[WP:PPOL|protection]], all pages are editable, by everyone. This is a brief overview of that process. For more detailed information, see the links under [[#Further reading|Further reading]] below.
+
== Basic text formatting ==
 +
You can format the page using Wikitext special characters.
  
==Editing basics==
+
{|width="80%" border="1" cellpadding="2" cellspacing="0"
<!--It is intended to be brief, or as an overview. Otherwise why we separate the materials into different pages? Thus it's best NOT to add new materials or expand here. Add more examples or expand in other areas like Wikitext examples. Thanks!-->
+
|-
 
+
!What it looks like
===Review policy and conventions===
+
!What you type
 
 
:Make sure that you submit information which is relevant to the specific purpose of the wiki, or your content might be deleted. You can always use the [[Help:Talk page|talk pages]] to ask questions or check to see if your idea will be accepted. Please make note of the license your contributions will be covered with.
 
 
 
===Start editing===
 
:Click the '''edit this page''' tab at the top of the page. This brings you to the edit page: a page with a text box (the ''edit box'') containing the ''[[wikitext]]'' – the editable code from which the server produces the finished page.
 
:Note: if you just want to experiment, please do so only in the [[{{ns:4}}:Sandbox|sandbox]].
 
 
 
===Type your changes===
 
:You can just type your text. However, also using basic wiki markup (described in the next section) to make links and do simple formatting adds to the value of your contribution. Style guidelines can be found in the [[WP:MOS|Manual of Style]]. If you follow these, your contributions will be more valuable as they won't need to be cleaned up later.
 
 
 
===Summarize your changes===
 
:Write a short [[Help:Edit summary|edit summary]] in the small field below the edit-box. You may use shorthand to describe your changes, as described in the [[w:Wikipedia:Edit summary legend|edit summary legend]].
 
 
 
===Preview before saving!===
 
:When you have finished, click '''[[Help:Show preview|Show preview]]''' to see how your changes will look '''before''' you make them permanent. Repeat the edit/preview process until you are satisfied, then click '''Save page''' and your changes will be immediately applied to the article. Sometimes it is helpful to save in between.
 
 
 
==Most frequent wiki markup explained== <!-- other pages link directly to this section; do not rename -->
 
<!--It is intended to be brief, or as an overview. Otherwise why we separate the materials into different pages? Thus it's best NOT to add new materials or expand here. Add more examples or expand in other areas like Wikitext examples. Thanks!-->
 
Here are the most frequently used types of wiki markup. If you need more help see [[Help:Wikitext examples|Wikitext examples]].
 
 
 
<br clear="right" />
 
{| class="wikitable"
 
! style="width: 50%" | What it looks like
 
! style="width: 50%" | What you type
 
 
|-
 
|-
 
|
 
|
Line 35: Line 12:
 
apostrophes on each side.
 
apostrophes on each side.
  
3 apostrophes will embolden '''the text'''.
+
3 apostrophes will '''bold the text'''.
  
5 apostrophes will embolden and italicize
+
5 apostrophes will '''bold''' and ''italicize''
 
'''''the text'''''.
 
'''''the text'''''.
  
(4 apostrophes don't do anything special -- there's just ''''one left over''''.)
+
(Using 4 apostrophes doesn't do anything special -- <br>they are just '''' left over ones'''' that are included as part of the text.)
 
|<pre>
 
|<pre>
 
You can ''italicize text'' by putting 2
 
You can ''italicize text'' by putting 2
 
apostrophes on each side.
 
apostrophes on each side.
  
3 apostrophes will embolden '''the text'''.
+
3 apostrophes will '''bold the text'''.
  
5 apostrophes will embolden and italicize
+
5 apostrophes will '''bold''' and ''italicize''
 
'''''the text'''''.
 
'''''the text'''''.
  
(4 apostrophes don't do anything
+
(Using 4 apostrophes doesn't do anything
special -- there's just ''''one left
+
special -- <br /> they are just ''''left
over''''.)
+
over ones'''' that are included as part
 +
of the text.)
 +
</pre>
 +
|-
 +
|
 +
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]]).
 +
|<pre>
 +
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]]).
 +
</pre>
 +
|-
 +
|
 +
You can break lines<br/>
 +
without a new paragraph.<br/>
 +
Please use this sparingly.
 +
 
 +
Please do not start a link or ''italics'' or '''bold''' on one line and close it on the next.
 +
|<pre>
 +
You can break lines<br/>
 +
without a new paragraph.<br/>
 +
Please use this sparingly.
 +
 
 +
Please do not start a link or
 +
''italics'' or '''bold''' on one line
 +
and close it on the next.
 
</pre>
 
</pre>
 
|-
 
|-
 
|
 
|
You should "sign" your comments on talk pages:
+
You should "sign" your comments on talk pages: <br/>
* Three tildes give your user name: [[User:Example|Example]] ([[User talk:Example|talk]])<br />
+
- Three tildes gives your signature: [[User:Example|Example]] <br/>
* Four tildes give your user name plus date/time: [[User:Example|Example]] ([[User talk:Example|talk]]) 07:46, 27 November 2005 (UTC)
+
- Four tildes give your signature plus date/time: [[User:Example|Example]] 07:46, 27 November 2005 (UTC) <br/>
* Five tildes give the date/time alone: 07:46, 27 November 2005 (UTC)
+
- Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC) <br/>
 
|<pre>
 
|<pre>
 
You should "sign" your comments
 
You should "sign" your comments
 
on talk pages:
 
on talk pages:
* Three tildes give your user
+
- Three tildes gives your
name: ~~~
+
signature: ~~~
* Four tildes give your user
+
- Four tildes give your
name plus date/time: ~~~~
+
signature plus date/time: ~~~~
* Five tildes give the
+
- Five tildes gives the
 
date/time alone: ~~~~~
 
date/time alone: ~~~~~
 
</pre>
 
</pre>
 +
|}
 +
 +
=== HTML tags ===
 +
You can use some ''HTML tags'' too.  For a list of HTML tags that are allowed, see [[Help:HTML in wikitext|HTML in wikitext]]. However, you should avoid HTML in favor of Wiki markup whenever possible.
 +
 +
 +
{| border="1" cellpadding="2"
 +
!width="1000"|What it looks like
 +
!width="500"|What you type
 
|-
 
|-
 
|
 
|
<div style="font-size:150%;border-bottom:1px solid rgb(170,170,170);">Section headings</div>
+
Put text in a <tt>typewriter
 +
font</tt>. The same font is
 +
generally used for <code>
 +
computer code</code>.
 +
|<pre>
 +
Put text in a <tt>typewriter
 +
font</tt>. The same font is
 +
generally used for <code>
 +
computer code</code>.
 +
</pre>
 +
|-
 +
|
 +
<strike>Strike out</strike>
 +
or <u>underline</u> text,
 +
or write it <span style=
 +
"font-variant:small-caps">
 +
in small caps</span>.
 +
|<pre>
 +
<strike>Strike out</strike>
 +
or <u>underline</u> text,
 +
or write it <span style=
 +
"font-variant:small-caps">
 +
in small caps</span>.
 +
</pre>
 +
|-
 +
|
 +
Superscripts and subscripts:
 +
X<sup>2</sup>, H<sub>2</sub>O
 +
|<pre>
 +
Superscripts and subscripts:
 +
X<sup>2</sup>, H<sub>2</sub>O
 +
</pre>
 +
|-
 +
|
 +
<center>Centered text</center>
 +
* Please note the American spelling of "center".
 +
|<pre>
 +
<center>Centered text</center>
 +
* Please note the American spelling of "center".
 +
</pre>
 +
|-
 +
|
 +
Using the '''blockquote''' command,
 +
<blockquote>
 +
... block quotations will be set apart, typically in a slightly different font ...
 +
</blockquote>
 +
and surrounded with whitespace.
 +
|<pre>
 +
Using the '''blockquote''' command,
 +
<blockquote>
 +
... block quotations will be set apart, typically in a slightly different font ...
 +
</blockquote>
 +
and surrounded with whitespace.</pre>
 +
|-
 +
|
 +
Invisible comments to editors (&lt;!-- --&gt;)
 +
appear only while editing the page.
 +
<!-- Note to editors: blah blah blah. -->
  
''Headings'' organize your writing into sections.
+
* If you wish to make comments to the public, you should usually use the [[talk page]].
The Wiki software can automatically generate
+
|<pre>
a [[Help:Section|table of contents]] from them.
+
Invisible comments to editors (&amp;lt;!-- --&amp;gt;)
 +
appear only while editing the page.
 +
<!-- Note to editors: blah blah blah. -->
 +
</pre>
 +
|}
 +
 
 +
=== Organizing your writing ===
 +
{| border="1" cellpadding="2"
 +
!width="1000"|What it looks like
 +
!width="500"|What you type
 +
|-
 +
|
 +
<div style="font-size:150%;border-bottom:1px solid #000000;">Section headings</div>
 +
 
 +
''Headings'' organize your writing into
 +
sections. The Wiki software can automatically
 +
generate a [[Help:table of contents|table of contents]] from them.
  
 
<div style="font-size:132%;font-weight:bold;">Subsection</div>
 
<div style="font-size:132%;font-weight:bold;">Subsection</div>
Using more equals signs creates a subsection.
+
Using more "equals" (=) signs creates a subsection.
  
 
<div style="font-size:116%;font-weight:bold;">A smaller subsection</div>
 
<div style="font-size:116%;font-weight:bold;">A smaller subsection</div>
Line 87: Line 194:
 
Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title.
 
Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title.
 
|<pre>
 
|<pre>
==Section headings==
+
== Section headings ==
  
''Headings'' organize your writing into sections.
+
''Headings'' organize your writing into
The Wiki software can automatically generate
+
sections. The Wiki software can automatically
a table of contents from them.
+
generate a [[table of contents]] from them.
  
===Subsection===
+
=== Subsection ===
 +
Using more "equals" (=) signs creates a subsection.
  
Using more equals signs creates a subsection.
+
==== A smaller subsection ====
  
====  A smaller subsection  ====
 
 
Don't skip levels,
 
Don't skip levels,
 
like from two to four equals signs.
 
like from two to four equals signs.
Line 104: Line 211:
 
because 1 creates H1 tags
 
because 1 creates H1 tags
 
which should be reserved for page title.
 
which should be reserved for page title.
Also notice spaces between the modifier
 
and text do not matter.
 
 
</pre>
 
</pre>
 
|- id="lists"
 
|- id="lists"
Line 113: Line 218:
 
*** More stars indicate a deeper level.
 
*** More stars indicate a deeper level.
 
*: Previous item continues.
 
*: Previous item continues.
** A new line
+
** A newline
 
* in a list
 
* in a list
 
marks the end of the list.
 
marks the end of the list.
Line 122: Line 227:
 
*** More stars indicate a deeper level.
 
*** More stars indicate a deeper level.
 
*: Previous item continues.
 
*: Previous item continues.
** A new line
+
** A newline
 
* in a list
 
* in a list
 
marks the end of the list.
 
marks the end of the list.
* Of course you can start again.
+
*Of course you can start again.
 
</pre>
 
</pre>
 
|-
 
|-
Line 132: Line 237:
 
## Very organized
 
## Very organized
 
## Easy to follow
 
## Easy to follow
#: Previous item continues
+
#Capable of being nested (but they won't fix your counting errors!).
A new line marks the end of the list.
+
A newline marks the end of the list.
 
# New numbering starts with 1.
 
# New numbering starts with 1.
  
Line 140: Line 245:
 
## Very organized
 
## Very organized
 
## Easy to follow
 
## Easy to follow
#: Previous item continues
+
#Capable of being nested (but they won't fix your counting errors!).
A new line marks the end of the list.
+
A newline marks the end of the list.
 
# New numbering starts with 1.
 
# New numbering starts with 1.
 +
</pre>
 +
|-
 +
|
 +
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 one
 +
: 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.
 +
|<pre>
 +
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 one
 +
: 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.
 +
</pre>
 +
|-
 +
|
 +
* You can even do mixed lists
 +
*# and nest them
 +
*# inside each other
 +
*#* or break lines<br>in lists.
 +
*#; definition lists
 +
*#: can be
 +
*#:; nested : too
 +
|<pre>
 +
* You can even do mixed lists
 +
*# and nest them
 +
*# inside each other
 +
*#* or break lines<br>in lists.
 +
*#; definition lists
 +
*#: can be
 +
*#:; nested : too
 
</pre>
 
</pre>
 
|-
 
|-
Line 148: Line 299:
 
: A colon (:) indents a line or paragraph.
 
: A colon (:) indents a line or paragraph.
 
A newline starts a new paragraph. <br>
 
A newline starts a new paragraph. <br>
Often used for discussion on [[talk pages]].
+
Should only be used on [[talk pages]]. <br>
 +
For articles, you probably want the blockquote tag.
 
: We use 1 colon to indent once.
 
: We use 1 colon to indent once.
 
:: We use 2 colons to indent twice.
 
:: We use 2 colons to indent twice.
Line 154: Line 306:
 
|<pre>
 
|<pre>
 
: A colon (:) indents a line or paragraph.
 
: A colon (:) indents a line or paragraph.
A newline starts a new paragraph. <br>
+
A newline starts a new paragraph.
Often used for discussion on talk pages.
+
Should only be used on talk pages.
 +
For articles, you probably want the blockquote tag.
 
: We use 1 colon to indent once.
 
: We use 1 colon to indent once.
 
:: We use 2 colons to indent twice.
 
:: We use 2 colons to indent twice.
 
::: 3 colons to indent 3 times, and so on.
 
::: 3 colons to indent 3 times, and so on.
 
</pre>
 
</pre>
 +
|-
 +
|
 +
You can make [[w:horizontal dividing line|horizontal dividing line]]s (----)
 +
to separate text.
 +
----
 +
But you should usually use sections instead,
 +
so that they go in the table of contents.
 +
|<pre>
 +
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.
 +
</pre>
 +
|-
 +
|
 +
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]].
 +
|
 +
<pre>
 +
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]].
 +
</pre>
 +
|}
 +
 +
See also [[Wikipedia:Picture tutorial#Forcing a break]] (not just for pictures).
 +
 +
=== Links ===
  
 +
You will often want to make clickable ''links'' to other pages.
  
 +
{|width="100%"  border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
Here's a link to a page named [[Official position]].
 +
You can even say [[official position]]s
 +
and the link will show up correctly.
 +
|<pre>
 +
Here's a link to a page named [[Official position]].
 +
You can even say [[official position]]s
 +
and the link will show up correctly.
 +
</pre>
 +
|-
 +
|
 +
You can put formatting around a link.
 +
Example: ''[[Wikipedia]]''.
 +
|<pre>
 +
You can put formatting around a link.
 +
Example: ''[[Wikipedia]]''.
 +
</pre>
 
|-
 
|-
 
|
 
|
Here's a link to the [[Main page]].
+
The ''first letter'' of articles is automatically
 
+
capitalized, so [[wikipedia]] goes to the same place
But be careful - capitalization counts!
+
as [[Wikipedia]]. Capitalization matters after the
 +
first letter.
 
|<pre>
 
|<pre>
Here's a link to the [[Main page]].
+
The ''first letter'' of articles is automatically
 +
capitalized, so [[wikipedia]] goes to the same place
 +
as [[Wikipedia]]. Capitalization matters after the
 +
first letter.
 
</pre>
 
</pre>
 
|-
 
|-
Line 175: Line 397:
 
yet. You could create it by clicking on the link.
 
yet. You could create it by clicking on the link.
 
|<pre>
 
|<pre>
[[Intentionally permanent red link]] is
+
[[Intentionally permanent red link]] is a page that doesn't exist
a page that doesn't exist
+
yet. You could create it by clicking on the link.
yet. You could create it by
 
clicking on the link.
 
 
</pre>
 
</pre>
 
|-
 
|-
 
|
 
|
You can link to a page section
+
You can link to a page section by its title:
by placing a "#" before its title:
 
  
* [[Help:Contents#For editors]].
+
* [[List of cities by country#Morocco]].
  
If sections have the same title, add
+
If multiple sections have the same title, add
a number to link to any but the first.
+
a number. [[#Example section 3]] goes to the
[[#Example section 3]] goes to the
 
 
third section named "Example section".
 
third section named "Example section".
 
|<pre>
 
|<pre>
 +
You can link to a page section by its title:
 +
 +
* [[List of cities by country#Morocco]].
 +
 +
If multiple sections have the same title, add
 +
a number. [[#Example section 3]] goes to the
 +
third section named "Example section".
 +
</pre>
 +
|-
 +
|
 +
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]]
 +
|<pre>
 +
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|]]
 +
</pre>
 +
|-
 +
|
 +
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
 +
|
 +
<pre>
 +
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
 +
</pre>
 +
|-
 +
|
 +
Linking to an e-mail address works the same way:
 +
mailto:someone@example.com or [mailto:someone@example.com someone]
 +
|
 +
<pre>
 +
Linking to an e-mail address works the same way:
 +
mailto:someone@example.com or [mailto:someone@example.com someone]
 +
</pre>
 +
|-
 +
|
 +
You can [[Help:Redirect|redirect]] the user to another page.
 +
|<pre>
 +
#REDIRECT [[Official position]]
 +
</pre>
 +
|-
 +
|
 +
[[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]]
 +
|<pre>
 +
[[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]]
 +
[[Category:Editor handbook]]
  
You can link to a page section
+
Add an extra colon to ''link'' to a category in line
by placing a "#" before its title:
+
without causing the page to be listed in the category:
 +
[[:Category:English documentation]]
 +
</pre>
 +
|-
 +
|
 +
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]]
 +
|<pre>
 +
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]]
 +
</pre>
 +
|}
  
* [[Help:Contents#For editors]].
+
=== 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"
 +
!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>
 +
|<pre>
 +
&lt;nowiki&gt;
 +
The nowiki tag ignores
 +
[[Wiki]] ''markup''.
 +
It reformats text by
 +
removing
 +
newlines    and multiple
 +
spaces.
 +
It still interprets special
 +
characters: &amp;rarr;
 +
&lt;/nowiki&gt;
 +
</pre>
 +
|-
 +
|
 +
<pre>
 +
The pre tag ignores [[Wiki]]
 +
''markup''.
 +
It also doesn't    reformat
 +
text.
 +
It still interprets special
 +
characters: →
 +
</pre>
 +
|<pre>
 +
&lt;pre&gt;
 +
The pre tag ignores [[Wiki]]
 +
''markup''.
 +
It also doesn't    reformat
 +
text.
 +
It still interprets special
 +
characters: &amp;rarr;
 +
&lt;/pre&gt;
 +
</pre>
 +
|-
 +
|
 +
[[Wikipedia:How to edit a page#No or limited formatting—showing exactly what is being typed|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: →
 +
|<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: &amp;rarr;
 +
</pre>
 +
|}
 +
 
 +
If you need to display [[Character encodings in HTML|special HTML characters]] you have to replace the initial "<tt>&</tt>" with "<tt>&amp;amp;</tt>"; e.g. to display the special character ''Right arrow'' (&rarr;) use: <tt>&amp;amp;rarr;</tt>.
 +
{{See also|Wikipedia:How to edit a page}}
 +
 
 +
=== Images, tables, video, and sounds ===
 +
 
 +
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>'''
 +
 
 +
This is a very quick introduction. For more information, see:
 +
* [[Help:Images and other uploaded files]] for how to upload files
 +
* [[w:en:Wikipedia:Extended image syntax]] for how to arrange images on the page
 +
* [[Help:Table]] for how to create a table
 +
 
 +
{| border="1" cellpadding="2"
 +
!width="1000"|What it looks like
 +
!width="500"|What you type
 +
|-
 +
|
 +
A picture, including alternate text:
 +
 
 +
[[Image:Wiki.png|This Wiki's logo]]
 +
 
 +
You can put the image in a frame with a caption:
 +
[[Image:Wiki.png|frame|This Wiki's logo]]
 +
|<pre>
 +
A picture, including alternate text:
 +
 
 +
[[Image:Wiki.png|This Wiki's logo]]
 +
 
 +
The image in a frame with a caption:
 +
[[Image:Wiki.png|frame|This Wiki's logo]]
 +
</pre>
 +
|-
 +
|
 +
A link to Wikipedia's page for the image:
 +
[[:Image:Wiki.png]]
 +
 
 +
Or a link directly to the image itself:
 +
[[Media:Wiki.png]]
 +
|<pre>
 +
A link to Wikipedia's page for the image:
 +
[[:Image:Wiki.png]]
 +
 
 +
Or a link directly to the image itself:
 +
[[Media:Wiki.png]]
 +
</pre>
 +
|-
 +
|
 +
Use '''media:''' links to link
 +
directly to sounds or videos:
 +
[[media:Classical guitar scale.ogg|A sound file]]
 +
|<pre>
 +
Use '''media:''' links to link
 +
directly to sounds or videos:
 +
[[media:Classical guitar scale.ogg|A sound file]]
 +
</pre>
 +
|-
 +
|
 +
{| border="1" cellspacing="0" cellpadding="5" align="center"
 +
! This
 +
! is
 +
|-
 +
| a
 +
| table
 +
|-
 +
|}
 +
|<pre>
 +
{| border="1" cellspacing="0" cellpadding="5" align="center"
 +
! This
 +
! is
 +
|-
 +
| a
 +
| table
 +
|-
 +
|}
  
If sections have the same title, add
 
a number to link to any but the first.
 
[[#Example section 3]] goes to the
 
third section named "Example section".
 
 
</pre>
 
</pre>
 
|}
 
|}
  
==Restrictions==
+
=== Mathematical formulas ===
Some pages cannot be edited by everyone. A special function known as [[protection]] can be applied to a page by [[Wikipedia:Administrators|administrator]]s, making the said page uneditable to certain classes of users. There are several degrees of protection:
+
You can format mathematical formulas with [[w:TeX|TeX]] markup. See [[Help:Displaying a formula]].
*If a page is semiprotected, it can be edited by everyone except IPs and accounts that have not yet been [[autoconfirmation|confirmed]].
+
 
*If a page is fully protected, only other admins can make edits to the page.
+
{| border="1" cellpadding="2"
*A page can also be protected so that it cannot be [[Help:Moving a page|moved]].
+
!width="1000"|What it looks like
*In some cases, an admin might see fit to protect a page from being created.
+
!width="500"|What you type
*For very rare pages, such as the Main Page, "cascading" protection is applied, wherein every page that is [[WP:Transclusion|transcluded]] onto a page is protected too.
+
|-
There are various reasons why a page might be protected. Vandalism and spam can lead to semiprotection, while content wars and other severe cases can lead to full protection. There are other times where [[WP:Office actions|Office actions]] come into play. For the most part, protection is temporary and editing privileges are then restored. In any case, everyone can view the source of any page, irrespective of its level of protection.
+
|
 +
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
 +
|<pre><nowiki>
 +
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
 +
</nowiki></pre>
 +
|}
 +
 
 +
=== Software source code ===
 +
You can format software source code.
 +
See [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi Mediawiki: Extension:SyntaxHighlight GeSHi].
 +
 
 +
 
 +
{| border="1" cellpadding="2"
 +
!width="1000"|What it looks like
 +
!width="500"|What you type
 +
|-
 +
|
 +
<source lang=cpp>
 +
// 'Hello World!' program
 +
#include <iostream>
 +
int main(){
 +
  std::cout << "Hello World!" << std::endl;
 +
  return 0;
 +
}
 +
</source>
 +
|<pre><nowiki>
 +
<source lang=cpp>
 +
// 'Hello World!' program
 +
#include <iostream>
 +
int main(){
 +
  std::cout << "Hello World!" << std::endl;
 +
  return 0;
 +
}
 +
</source>
 +
</nowiki></pre>
 +
|}
 +
 
 +
=== Templates ===
  
==Further reading==
+
'''[[Help:Template|Templates]]''' are segments of Wiki markup that are meant to be copied automatically ("transcluded") into a page.
<!--More relevant links are welcome-->
+
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>.
  
===Editing help===
+
Some templates take ''parameters'', as well, which you separate with the pipe character.
*[[Help:Editing FAQ]]
 
*[[Help:Editing toolbar]]
 
*[[Help:Minor edit]]
 
  
===Wiki markups and codes===
+
{| border="1" cellpadding="2"
*[[Help:Wikitext examples]]
+
!width="1000"|What it looks like
*[[m:Help:Reference card|Help:Reference card]]: a one-page summary of important commands, to be printed out and used next to the computer
+
!width="500"|What you type
*[[Help:HTML in wikitext]]
+
|-
*[[Help:Comment tags]]
+
|
*[[HTML element]]s: HTML Elements in general
+
{{Transclusion demo}}
*[[Help:Redirect]]: setting up a redirect page within Wikipedia
+
|<pre>
 +
{{Transclusion demo}}
 +
</pre>
 +
|-
 +
|
 +
{{Help:Transclusion Demo}}
 +
|<pre>
 +
{{Help:Transclusion Demo}}
 +
</pre>
 +
|-
 +
|
 +
 
 +
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}}
 +
 
 +
|<pre>
 +
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}}
 +
</pre>
 +
|}
  
===Page management===
+
<noinclude>
*[[Help:Starting a new page]]
+
[[Category:Editor handbook]]</noinclude>
*[[Help:Administration#Protection|Protecting pages]]
 
*[[Wikipedia:Merging and moving pages|Merging and moving pages]]
 
*[[meta:Anti-spam features]]
 

Latest revision as of 03:46, 20 July 2009

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.

5 apostrophes will bold and italicize the text.

(Using 4 apostrophes doesn't do anything special --
they are just ' left over ones' that are included as part of the text.)

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 /> they are just ''''left
over ones'''' that are included as part
of 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
without a new paragraph.
Please use this sparingly.

Please do not start a link or italics or bold on one line and close it 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''' on one line
and close it on the next.

You should "sign" your comments on talk pages:
- Three tildes gives your signature: Example
- Four tildes give your signature plus date/time: Example 07:46, 27 November 2005 (UTC)
- Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC)

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. For a list of HTML tags that are allowed, see HTML in wikitext. However, you should avoid HTML in favor of Wiki markup whenever possible.


What it looks like What you type

Put text in a typewriter font. The same font is generally used for computer code.

Put text in a <tt>typewriter
font</tt>. The same font is
generally used for <code>
computer code</code>.

Strike out or underline text, or write it in small caps.

<strike>Strike out</strike>
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
  • Please note the American spelling of "center".
<center>Centered text</center>
* Please note the American spelling of "center".

Using the blockquote command,

... block quotations will be set apart, typically in a slightly different font ...

and surrounded with whitespace.

Using the '''blockquote''' command,
<blockquote>
... block quotations will be set apart, typically in a slightly different font ...
</blockquote>
and surrounded with whitespace.

Invisible comments to editors (<!-- -->) appear only while editing the page.

  • If you wish to make comments to the public, you should usually use the talk page.
Invisible comments to editors (&lt;!-- --&gt;)
appear only while editing the page.
<!-- Note to editors: blah blah blah. -->

Organizing your writing

What it looks like What you type
Section headings

Headings organize your writing into sections. The Wiki software can automatically generate a 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 because 1 creates H1 tags which should be reserved for page title.

== Section headings ==

''Headings'' organize your writing into
sections. The Wiki software can automatically
generate a [[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
because 1 creates H1 tags
which should be reserved for page title.
  • Unordered lists are easy to do:
    • Start every line with a star.
      • More stars indicate a deeper level.
    Previous item continues.
    • A newline
  • in a list

marks the end of the list.

  • Of course you can start again.
* ''Unordered lists'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
*: Previous item continues.
** A newline
* in a list
marks the end of the list.
*Of course you can start again.
  1. Numbered lists are:
    1. Very organized
    2. Easy to follow
  2. Capable of being nested (but they won't fix your counting errors!).

A newline marks the end of the list.

  1. New numbering starts with 1.
# ''Numbered lists'' are:
## Very organized
## Easy to follow
#Capable of being nested (but they won't fix your counting errors!).
A newline marks the end of the list.
# New numbering starts with 1.

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 one
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.

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 one
: 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
    1. and nest them
    2. inside each other
      • or break lines
        in lists.
      definition lists
      can be
      nested 
      too
* 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 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.
: 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.

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.

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]].

See also Wikipedia:Picture tutorial#Forcing a break (not just for pictures).

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 position]].
You can even say [[official position]]s
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:

* [[List of cities by country#Morocco]].

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 [[page]]:
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 position]]

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]]
[[Category:Editor handbook]]

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

If you need to display special HTML characters you have to replace the initial "&" with "&amp;"; e.g. to display the special character Right arrow (→) use: &amp;rarr;. Template:See also

Images, tables, video, and sounds

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]]

This is a very quick introduction. For more information, see:

What it looks like What you type

A picture, including alternate text:

This Wiki's logo

You can put the image in a frame with a caption:

File:Wiki.png
This Wiki's logo
A picture, including alternate text:

[[Image:Wiki.png|This Wiki's logo]]

The image in a frame with a caption:
[[Image:Wiki.png|frame|This 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]]
This is
a table
{| border="1" cellspacing="0" cellpadding="5" align="center"
! This
! is
|-
| a
| table
|-
|}

Mathematical formulas

You can format mathematical formulas with TeX markup. See Help:Displaying a formula.

What it looks like What you type

<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

Software source code

You can format software source code. See Mediawiki: Extension:SyntaxHighlight GeSHi.


What it looks like What you type

<source lang=cpp> // 'Hello World!' program

  1. include <iostream>

int main(){

 std::cout << "Hello World!" << std::endl;
 return 0;

} </source>

<source lang=cpp>
// 'Hello World!' program
#include <iostream>
int main(){
  std::cout << "Hello World!" << std::endl;
  return 0;
}
</source>

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

Template:Transclusion demo

{{Transclusion demo}}

Help:Transclusion Demo

{{Help:Transclusion Demo}}

This template takes two parameters, and creates underlined text with a hover box for many modern browsers supporting CSS:

Template:H:title

Go to this page to see the H:title template itself: Template:Tl

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}}