Difference between revisions of "Help:Editing"

From JetResources
Jump to navigation Jump to search
 
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{H:h|editor toc}}
+
=== Basic text formatting ===
This Editing Overview has a lot of '''[[w:wikitext|wikitext]]''' examples. You may want to keep this page open in a separate browser window for reference while you edit.
 
  
Each of the topics covered here is covered somewhere else in more detail. Please look in the box on the right for the topic you are interested in.
+
{| border="1" cellpadding="2" cellspacing="0"
== Editing basics ==
+
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
You can ''emphasize text'' by putting two
 +
apostrophes on each side. Three apostrophes
 +
will emphasize it '''strongly'''. Five
 +
apostrophes is '''''even stronger'''''.
 +
|<pre><nowiki>
 +
You can ''emphasize text'' by putting two
 +
apostrophes on each side. Three apostrophes
 +
will emphasize it '''strongly'''. Five
 +
apostrophes is '''''even stronger'''''.
 +
</nowiki></pre>
 +
|-
 +
|
 +
A single newline
 +
has no effect
 +
on the layout.
  
;Start editing
+
But an empty line
:To start editing a [[w:MediaWiki|MediaWiki]] page, click on the "'''Edit this page'''" (or just "'''edit'''") link at one of its edges. This will bring you to the '''edit page''': a page with a text box containing the ''[[w:wikitext|wikitext]]'': the editable source code from which the server produces the webpage. ''If you just want to experiment, please do so in the [[{{ns:4}}:Sandbox|sandbox]], not here''.
+
starts a new paragraph.
 +
|<pre><nowiki>
 +
A single newline
 +
has no effect
 +
on the layout.
  
;Summarize your changes
+
But an empty line
:You should 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 [[{{ns:4}}:Edit summary legend|legend]].
+
starts a new paragraph.
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can break lines<br>
 +
without starting a new paragraph.<br>
 +
Please use this sparingly.
 +
|<pre><nowiki>
 +
You can break lines<br>
 +
without starting a new paragraph.<br>
 +
Please use this sparingly.
 +
</nowiki></pre>
 +
|-
 +
|
 +
You should "sign" your comments on talk pages:
 +
: Three tildes gives your user name: [[User:Karl Wick|Karl Wick]]
 +
: Four tildes give your user name plus date/time: [[User:Karl Wick|Karl Wick]] 07:46, 27 November 2005 (UTC)
 +
: Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC)
 +
|<pre><nowiki>
 +
You should "sign" your comments on talk pages:
 +
: Three tildes gives your user name: ~~~
 +
: Four tildes give your user name plus date/time: ~~~~
 +
: Five tildes gives the date/time alone: ~~~~~
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can use <b>HTML tags</b>, too, if you
 +
want. Some useful ways to use HTML:
  
;Preview before saving
+
Put text in a <tt>typewriter font</tt>.
:When you have finished, press [[Help:Show preview|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" and your changes will be immediately applied to the article.
+
The same font is generally used for
 +
<code>computer code</code>.
  
{{:Help:Wikitext quick reference}} <!-- Edit this at [[Help:Wikitext quick reference]] -->
+
<strike>Strike out</strike> or
 +
<u>underline</u> text, or write it
 +
<span style="font-variant:small-caps">
 +
in small caps</span>.
  
{{:Help:Editing tips and tricks}} <!-- Edit this at [[Help:Editing tips and tricks]] -->
+
Superscripts and subscripts:
 +
x<sup>2</sup>, x<sub>2</sub>
  
== Minor edits ==
+
Invisible comments that only appear while editing the page.
 +
<!-- Note to editors: blah blah blah. -->
 +
Comments should usually go on the talk page, though.
 +
|<pre><nowiki>
 +
You can use <b>HTML tags</b>, too, if you
 +
want. Some useful ways to use HTML:
  
A [[Help:Logging in|logged-in]] user can mark an edit as "minor". [[Help:Minor edit|Minor edit]]s are generally spelling corrections, formatting, and minor rearrangement of text. Users may choose to ''hide'' minor edits when viewing [[Help:Recent changes|Recent Changes]].
+
Put text in a <tt>typewriter font</tt>.
 +
The same font is generally used for
 +
<code>computer code</code>.
  
Marking a significant change as a minor edit is considered bad Wikiquette. If you have accidentally marked an edit as minor, make a [[Help:Dummy edit|dummy edit]], verify that the "<small>'''[&nbsp;] This is a minor edit'''</small>" check-box is unchecked, and explain in the edit summary that the previous edit was not minor.
+
<strike>Strike out</strike> or
 +
<u>underline</u> text, or write it
 +
<span style="font-variant:small-caps">
 +
in small caps</span>.
  
==See also==
+
Superscripts and subscripts:
*[[Help:Editing FAQ]]
+
x<sup>2</sup>, x<sub>2</sub>
*[[Help:Automatic conversion of wikitext]]
 
*[[Help:Calculation]]
 
*[[Help:Editing toolbar]]
 
*[[Help:HTML in wikitext]]
 
*[[Help:Administration#Page_protection| Protecting pages]]
 
*[[Help:Starting a new page]]
 
*[[Help:Variable]]
 
*[[w:UseModWiki|UseModWiki]] and [[w:Wikipedia:PHP script|Wikipedia:PHP script]].
 
*[[w:HTML element|HTML elements]].
 
*[[w:en:User:Pilaf/Live Preview|Live preview]] - a way to preview your edits without contacting the server.
 
*[[:Image:Special characters Verdana IE.png]] - shows special characters with codes, and also shows problem characters.
 
*{{tim|fs}} - font size
 
*{{tim|co}} - color
 
  
==External links==
+
Invisible comments that only appear while editing the page.
*[http://home.earthlink.net/~awinkelried/keyboard_shortcuts.html Special characters in HTML]  
+
<!-- Note to editors: blah blah blah. -->
{{h:f|enname=Editing}}
+
Comments should usually go on the talk page, though.
 +
</nowiki></pre>
 +
|}
 +
 
 +
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.
 +
 
 +
=== Organizing your writing ===
 +
{| border="1" cellpadding="2" cellspacing="0"
 +
|-
 +
!What it looks like
 +
!What you type
 +
|-
 +
|
 +
<span style="font-size: 150%"><b>Section headings</b></span>
 +
 
 +
Headings organize your writing into sections.
 +
The Wiki software can automatically generate
 +
a [[Help:table of contents|table of contents]] from them.
 +
 
 +
 
 +
<span style="font-size: 125%"><b>Subsection</b></span>
 +
 
 +
Using more equals signs creates a subsection.
 +
 
 +
 
 +
<b>A smaller subsection</b>
 +
 
 +
Don't skip levels, like from two to four equals signs.
 +
Start with two equals signs; don't use single equals signs.
 +
|<pre><nowiki>
 +
== 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 two equals signs; don't use single equals signs.
 +
</nowiki></pre>
 +
|-
 +
|
 +
* ''Unordered [[Help:List|list]]s'' are easy to do:
 +
** Start every line with a star.
 +
*** More stars indicate a deeper level.
 +
*A newline
 +
*in a list 
 +
marks the end of the list.
 +
*Of course you can start again.
 +
|<pre><nowiki>
 +
* ''Unordered lists'' are easy to do:
 +
** Start every line with a star.
 +
*** More stars indicate a deeper level.
 +
*A newline
 +
*in a list 
 +
marks the end of the list.
 +
*Of course you can start again.
 +
</nowiki></pre>
 +
|-
 +
|
 +
# Numbered lists are also good:
 +
## Very organized
 +
## Easy to follow
 +
A newline marks the end of the list.
 +
#New numbering starts with 1.
 +
 
 +
|<pre><nowiki>
 +
# Numbered lists are also good:
 +
## Very organized
 +
## Easy to follow
 +
A newline marks the end of the list.
 +
#New numbering starts with 1.
 +
</nowiki></pre>
 +
|-
 +
|
 +
* You can even do mixed lists
 +
*# and nest them
 +
*#* or break lines<br>in lists.
 +
|<pre><nowiki>* You can even do mixed lists
 +
*# and nest them
 +
*#* or break lines<br>in lists.</nowiki></pre>
 +
|-
 +
|
 +
Another kind of list is a '''definition list''':
 +
; word : definition of the word
 +
; longer phrase
 +
: phrase defined
 +
|<pre><nowiki>
 +
Another kind of list is a '''definition list''':
 +
; word : definition of the word
 +
; longer phrase
 +
: phrase defined</nowiki></pre>
 +
|-
 +
|
 +
:A colon indents a line or paragraph.
 +
A newline after that starts a new paragraph.
 +
::This is often used for discussion on [[Help:Talk page|Talk page]]s.
 +
|<pre><nowiki>
 +
:A colon indents a line or paragraph.
 +
A newline after that starts a new paragraph.
 +
::This is often used for discussion on talk pages.
 +
</nowiki></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><nowiki>
 +
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.
 +
</nowiki></pre>
 +
|}
 +
 
 +
=== Links ===
 +
 
 +
You will often want to make clickable ''links'' to other pages.
 +
 
 +
{| 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.
 +
 
 +
You can put formatting around a link.
 +
Example: ''[[Wikipedia]]''.
 +
 
 +
The ''first letter'' will automatically be capitalized,
 +
so [[wikipedia]] goes to the same place as [[Wikipedia]].
 +
Capitalization matters after the first letter.
 +
This is not the case with wiktionary, where every letter is case-sensitive - see [http://en.wiktionary.org/wiki/apollo apollo] and [http://en.wiktionary.org/wiki/Apollo Apollo] as an example.
 +
 
 +
[[The weather in London]] is a page that doesn't exist
 +
yet. You can create it by clicking on the link.
 +
|<pre><nowiki>
 +
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]]''.
 +
 
 +
The ''first letter'' will automatically be capitalized,
 +
so [[wikipedia]] is the same as [[Wikipedia]].
 +
Capitalization matters after the first letter.
 +
 
 +
[[The weather in London]] is a page that doesn't exist
 +
yet. You can create it by clicking on the link.
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can link to a page section by its title:
 +
 
 +
*[[List of cities by country#Morocco]].
 +
*[[List of cities by country#Sealand]].
 +
 
 +
If multiple sections have the same title, add
 +
a number. [[#Example section 3]] goes to the
 +
third section named "Example section".
 +
|<pre><nowiki>
 +
You can link to a page section by its title:
 +
 
 +
*[[List of cities by country#Morocco]].
 +
*[[List of cities by country#Sealand]].
 +
 
 +
If multiple sections have the same title, add
 +
a number. [[#Example section 3]] goes to the
 +
third section named "Example section".
 +
</nowiki></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]]
 +
|<pre><nowiki>
 +
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]]
 +
</nowiki></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]
 +
|
 +
<pre><nowiki>
 +
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]
 +
</nowiki></pre>
 +
|-
 +
|
 +
You can [[Help:Redirect|redirect]] the user to another page with
 +
a special link. For example, you might want to
 +
redirect [[w:USA|USA]] to [[w:United States|United States]].
 +
|<pre><nowiki>
 +
#REDIRECT [[United States]]
 +
</nowiki></pre>
 +
|-
 +
|
 +
[[Help:Category|Category links]] don't show up, but add the page
 +
to a category. [[Category:English documentation]]
 +
 
 +
Add an extra colon to actually link to the category:
 +
[[:Category:English documentation]]
 +
|<pre><nowiki>
 +
Category links don't show up, but add the page
 +
to a category. [[Category:English documentation]]
 +
 
 +
Add an extra colon to actually link to the category:
 +
[[:Category:English documentation]]
 +
</nowiki></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]]:
 +
* [[July 20]], [[1969]]
 +
* [[20 July]] [[1969]]
 +
* [[1969]]-[[07-20]]
 +
|<pre><nowiki>
 +
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|]]:
 +
* [[July 20]], [[1969]]
 +
* [[20 July]] [[1969]]
 +
* [[1969]]-[[07-20]]
 +
</nowiki></pre>
 +
|}

Latest revision as of 13:57, 21 January 2006

Basic text formatting

What it looks like What you type

You can emphasize text by putting two apostrophes on each side. Three apostrophes will emphasize it strongly. Five apostrophes is even stronger.

You can ''emphasize text'' by putting two
apostrophes on each side. Three apostrophes
will emphasize it '''strongly'''. Five
apostrophes is '''''even stronger'''''.

A single newline has no effect on the layout.

But an empty line starts a new paragraph.

A single newline
has no effect
on the layout.

But an empty line
starts a new paragraph.

You can break lines
without starting a new paragraph.
Please use this sparingly.

You can break lines<br>
without starting a new paragraph.<br>
Please use this sparingly.

You should "sign" your comments on talk pages:

Three tildes gives your user name: Karl Wick
Four tildes give your user name plus date/time: Karl Wick 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 user name: ~~~
: Four tildes give your user name plus date/time: ~~~~
: Five tildes gives the date/time alone: ~~~~~

You can use HTML tags, too, if you want. Some useful ways to use HTML:

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

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

Superscripts and subscripts: x2, x2

Invisible comments that only appear while editing the page. Comments should usually go on the talk page, though.

You can use <b>HTML tags</b>, too, if you
want. Some useful ways to use HTML:

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

<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:
x<sup>2</sup>, x<sub>2</sub>

Invisible comments that only appear while editing the page.
<!-- Note to editors: blah blah blah. -->
Comments should usually go on the talk page, though.

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.

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 two equals signs; don't use single equals signs.

== 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 two equals signs; don't use single equals signs.
  • Unordered lists are easy to do:
    • Start every line with a star.
      • More stars indicate a deeper level.
  • 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.
*A newline
*in a list  
marks the end of the list.
*Of course you can start again.
  1. Numbered lists are also good:
    1. Very organized
    2. Easy to follow

A newline marks the end of the list.

  1. New numbering starts with 1.
# Numbered lists are also good:
## Very organized
## Easy to follow
A newline marks the end of the list.
#New numbering starts with 1.
  • You can even do mixed lists
    1. and nest them
      • or break lines
        in lists.
* You can even do mixed lists
*# and nest them
*#* or break lines<br>in lists.

Another kind of list is a definition list:

word
definition of the word
longer phrase
phrase defined
Another kind of list is a '''definition list''':
; word : definition of the word
; longer phrase 
: phrase defined
A colon indents a line or paragraph.

A newline after that starts a new paragraph.

This is often used for discussion on Talk pages.
:A colon indents a line or paragraph.
A newline after that starts a new paragraph.
::This is often used for discussion on talk pages.

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.

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.

You can put formatting around a link. Example: Wikipedia.

The first letter will automatically be capitalized, so wikipedia goes to the same place as Wikipedia. Capitalization matters after the first letter. This is not the case with wiktionary, where every letter is case-sensitive - see apollo and Apollo as an example.

The weather in London is a page that doesn't exist yet. You can create it by clicking on the link.

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

The ''first letter'' will automatically be capitalized,
so [[wikipedia]] is the same as [[Wikipedia]].
Capitalization matters after the first letter.

[[The weather in London]] is a page that doesn't exist
yet. You can 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]].
*[[List of cities by country#Sealand]].

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.

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

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]

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]

You can redirect the user to another page with a special link. For example, you might want to redirect USA to United States.

#REDIRECT [[United States]]

Category links don't show up, but add the page to a category.

Add an extra colon to actually link to the category: Category:English documentation

Category links don't show up, but add the page
to a category. [[Category:English documentation]]

Add an extra colon to actually link to 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|]]:
* [[July 20]], [[1969]]
* [[20 July]] [[1969]]
* [[1969]]-[[07-20]]