Difference between revisions of "Help:Editing"

Start your sections as follows:

New section<h2>

Subsection<h3>

Sub-subsection<h4>

Sub-sub-subsection<h5>

• Start with a second-level heading (==); don't use first-level headings (=).
• Don't skip levels (for example, second-level followed by fourth-level).
• A table of contents will automatically be added to an article that has four or more sections.
• If appropriate, place subsections in an appropriate order, such as alphabetical order.
• If you want to keep headings out of the TOC you have to use html heading tags and close them without using a slash e.g. <h4>heading too low level to be in the toc of large page<h4>.

== New section ==

=== Subsection ===

==== Sub-subsection ====

===== Sub-sub-subsection =====

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 function diff (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 function ''diff'' 
(used internally to compare
different versions of a page).

But an empty line
starts a new paragraph.

You can break lines
without starting a new paragraph.

• Please use this sparingly.
• Close markup between lines; do not start a link or italics or bold on one line and close it on the next.

You can break lines<br/>
without starting a new paragraph.

• It's easy to create a list:
  • Start every line with a star (asterisk).
    • More stars means deeper levels.
      • A newline in a list

marks the end of a list item.

• An empty line starts a new list.

* It's easy to create a list:
** Start every line with a star.
*** More stars means deeper levels.
**** A newline in a list
marks the end of a list item.

* An empty line starts a new list.

1. Numbered lists are also good
   1. very organized
   2. easy to follow
      1. easier still

# Numbered lists are also good
## very organized
## easy to follow
### easier still

• You can even create mixed lists
  1. and nest them
     • like this

* You can even create mixed lists
*# and nest them
*#* like this

Definition list 

list of definitions

item 

the item's definition

another item

the other item's definition

• One item per line; a newline can appear before the colon, but using a space before the colon improves parsing.

; Definition list : list of definitions
; item : the item's definition
; another item
: the other item's definition

A colon indents a line or paragraph.

A manual newline starts a new paragraph.

• This is primarily for displayed material, but is also used for discussion on talk pages.

: A colon indents a line or paragraph.
A manual newline starts a new paragraph.

When there is a need for separating a block of text

the blockquote command will indent both margins when needed instead of the left margin only as the colon does.

This is useful for (as the name says) inserting blocks of quoted (and cited) text.

<blockquote>
The '''blockquote''' command will indent 
both margins when needed instead of the 
left margin only as the colon does.  
</blockquote>

IF a line starts with a space THEN
   it will be formatted exactly
   as typed;
   in a fixed-width font;
   lines will not wrap;
ENDIF

• This is useful for:
  • pasting preformatted text;
  • algorithm descriptions;
  • program source code;
  • ASCII art;
  • chemical structures;
• WARNING: If you make it wide, you force the whole page to be wide and hence less readable, especially for people who use lower resolutions. Never start ordinary lines with spaces.

 IF a line starts with a space THEN
    it will be formatted exactly
    as typed;
    in a fixed-width font;
    lines will not wrap;
 ENDIF

• Please note the American spelling of "center."

<center>Centered text.</center>

A horizontal dividing line: this is above it...

...and this is below it.

• Mainly useful for
  • disambiguation - but to be used sparsely--only when separating completely different, unrelated (groups of) meanings
  • separating threads on Talk pages.

A horizontal dividing line:
this is above it...
----
...and this is below it.

London has public transport.

• A link to another article.
• Internally, the first letter of the target page is automatically capitalized and spaces are represented as underscores (typing an underscore in the link has the same effect as typing a space, but is not recommended).
• Thus the link above is to the URL www.cantr.net/mwiki/Public_transport, which is the wiki article with the name "Public transport".

London has [[public transport]].

San Francisco also has public transportation.

• Same target, different name.
• This is a piped link.
• The "piped" text must be placed first, the text that will be displayed, second.

San Francisco also has
[[public transport|public transportation]].

San Francisco also has public transportation.

Examples include buses, taxis, and streetcars.

• Endings are blended into the link.
• Preferred style is to use this instead of a piped link, if possible.

San Francisco also has
[[public transport]]ation.

Examples include [[bus]]es, [[taxi]]s,
and [[streetcar]]s.

See the Wikipedia:Manual of Style.

• A link to another namespace.

See the [[Wikipedia:Manual of Style]].

Economics#See also is a link to a section within another page.

#Links and URLs is a link to a section on the current page.

#example is a link to an anchor that was created using

• The part after the number sign (#) must match a section heading on the page. Matches must be exact in terms of spelling, case, and punctuation. Links to non-existent sections are not broken; they are treated as links to the top of the page.
• Identifiers may be created by attaching an id="..."> attribute to almost any HTML element.

[[Economics#See also]] is a link
to a section within another page.

[[#Links and URLs]] is a link
to a section on the current page.

[[#example]] is a link to an
anchor that was created using
<div id="example">an id attribute</div>

Automatically hide stuff in parentheses: kingdom.

Automatically hide namespace: Village Pump.

Or both: Manual of Style

But not: [[Wikipedia:Manual of Style#Links|]]

• The server fills in the part after the pipe character (|) when you save the page. The next time you open the edit box you will see the expanded piped link. When previewing your edits, you will not see the expanded form until you press Save and Edit again. The same applies to links to sections within the same page (see previous entry).

Automatically hide stuff in parentheses:
[[kingdom (biology)|]].

Automatically hide namespace: 
[[Wikipedia:Village Pump|]].

Or both:
[[Wikipedia:Manual of Style (headings)|]]

But not:
[[Wikipedia:Manual of Style#Links|]]

The weather in London is a page that does not exist yet.

• You can create it by clicking on the link (but please do not do so with this particular link).
• To create a new page:
  1. Create a link to it on some other (related) page.
  2. Save that page.
  3. Click on the link you just made. The new page will open for editing.
• Please do not create a new article without linking to it from at least one other article.

[[The weather in London]] is a page 
that does not exist yet.

Help:Editing is this page.

• Self links appear as bold text when the article is viewed.
• Do not use this technique to make the article name bold in the first paragraph.

[[Help:Editing]] is this page.

When adding a comment to a Talk page, you should sign it by adding three tildes to add your user name:

Sho

or four to add user name plus date/time:

Sho 00:18, Nov 19, 2004 (UTC)

Five tildes gives the date/time alone:

00:18, Nov 19, 2004 (UTC)

• The first two both provide a link to your user page.

When adding a comment to a Talk page,
you should sign it by adding
three tildes to add your user name:
: ~~~
or four for user name plus date/time:
: ~~~~
Five tildes gives the date/time alone:
: ~~~~~

• Redirect one article title to another by placing a directive like the one shown to the right on the first line of the article (such as at a page titled "UN").
• Note that, while it is possible to link to a section, it is not possible to redirect to a section. For example, "#REDIRECT [[United Nations#International_Years]]" will redirect to the United Nations page, but not to any particular section on it. This feature will not be implemented in the future, so such redirects should not be used.

#REDIRECT [[United Nations]]

• Link to a page on the same subject in another language by using a link of the form: [[language code:Title]].
• It does not matter where you put these links while editing as they will always show up in the same place when you save the page, but placement at the end of the edit box is recommended.

[[fr:Encyclopédie]] adds a french language link to the side menu for the article.

[[:fr:Encyclopedia]] produces a link like this: fr:Encyclopédie

[[:fr:Encyclopedia|Read in french!]] produces a link like this: Read in french!

[[fr:Wikipédia:Aide]]

What links here and Related changes pages can be linked as: Special:Whatlinkshere/Wikipedia:How to edit a page and Special:Recentchangeslinked/Wikipedia:How to edit a page

'''What links here''' and '''Related changes'''
pages can be linked as:
[[Special:Whatlinkshere/Wikipedia:How to edit a page]]
and
[[Special:Recentchangeslinked/Wikipedia:How to edit a page]]

A user's Contributions page can be linked as: Special:Contributions/UserName or Special:Contributions/192.0.2.0

A user's '''Contributions''' page can be linked as:
[[Special:Contributions/UserName]]
or
[[Special:Contributions/192.0.2.0]]

• To put an article in a category, place a link like the one to the right anywhere in the article. As with interlanguage links, it does not matter where you put these links while editing as they will always show up in the same place when you save the page, but placement at the end of the edit box is recommended.

[[Category:Character sets]]

• To link to a category page without putting the article into the category, use an initial colon (:) in the link.

[[:Category:Character sets]]

Three ways to link to external (non-wiki) sources:

1. Bare URL: http://www.nupedia.com/ (bad style)
2. Unnamed link: [1] (only used within article body for footnotes)
3. Named link: Nupedia

• Square brackets indicate an external link. Note the use of a space (not a pipe) to separate the URL from the link text in the "named" version.
• In the URL, all symbols must be among:
  A-Z a-z 0-9 . _ \ / ~ % - + & # ? ! = ( ) @ \x80-\xFF
• URLs must start with the protocol (eg. [http://www.nupedia.com], not [www.nupedia.com])
• If a URL contains a character not in this list, it should be encoded by using a percent sign (%) followed by the hex code of the character, which can be found in the table of ASCII printable characters. For example, the caret character (^) would be encoded in a URL as %5E.
• There is a class that can be used to remove the arrow image from the external link. It is used in Template:Ref to stop the URL from expanding during printing. It should never be used in the main body of an article. However, there is an exception: wikilinks in Image markup. An example of the markup is as follows:
  • Markup: <span class="plainlinksneverexpand"> [http://www.sec.gov/edgar.shtml SEC Filing]</span>
  • Display: SEC Filing
• See Wikipedia:External links for style issues.

Three ways to link to external (non-wiki) sources:
# Bare URL: http://www.nupedia.com/ (bad style)
# Unnamed link: [http://www.nupedia.com/]
      (only used within article body for footnotes)
# Named link: [http://www.nupedia.com Nupedia]

Linking to other wikis:

1. Interwiki link: Wiktionary:Hello
2. Named interwiki link: Hello
3. Interwiki link without prefix: Hello

• All of these forms lead to the URL http://en.wiktionary.org/wiki/Hello
• Note that interwiki links use the internal link style.

Linking to another language's wiktionary:

1. Wiktionary:fr:bonjour
2. bonjour
3. fr:bonjour

• All of these forms lead to the URL http://fr.wiktionary.org/wiki/bonjour

Linking to other wikis:
# [[Interwiki]] link: [[Wiktionary:Hello]]
# Named interwiki link: [[Wiktionary:Hello|Hello]]
# Interwiki link without prefix: [[Wiktionary:Hello|]]

Linking to another language's wiktionary:
# [[Wiktionary:fr:bonjour]]
# [[Wiktionary:fr:bonjour|bonjour]]
# [[Wiktionary:fr:bonjour|]]

Sound

• To include links to non-image uploads such as sounds, use a "media" link. For images, see next section.

[[media:Sg_mrob.ogg|Sound]]

File:Wiki.png

A picture: 
[[Image:wiki.png]]

jigsaw globe

With alternative text:
[[Image:wiki.png|jigsaw globe]]

• Alternative text, used when a mouse hovers over the image or when the image is not loaded in a text-only browser, or when spoken aloud, is strongly encouraged.

Floating to the right side of the page and with a caption:
[[Image:wiki.png|frame|Wikipedia Encyclopedia]]

• The frame tag automatically floats the image right.
• The caption is also used as alternate text.
• to cancel a float at a certain text point, see Forcing a break,

Floating to the right side of the page ''without'' a caption:
[[Image:wiki.png|right|Wikipedia Encyclopedia]]

• The help topic on Extended image syntax explains more options.

Image:wiki.png

Linking directly to the description page of an image:
[[:Image:wiki.png]]

• Clicking on an image displayed on a page (such as any of the ones above) also leads to the description page

Image of the jigsaw globe logo

Linking directly to an image without displaying it:
[[media:wiki.png|Image of the jigsaw globe logo]]

• To include links to images shown as links instead of drawn on the page, use a "media" link.

Emphasize, strongly, very strongly.

• These are double, triple, and quintuple apostrophes (single-quote marks), not double-quote marks.

''Emphasize'', '''strongly''', '''''very strongly'''''.

A typewriter font for monospace text or for computer code: int main()

• For semantic reasons, using <code> where applicable is preferable to using <tt>.

A typewriter font for <tt>monospace text</tt>
or for computer code: <code>int main()</code>

You can use small text for captions.

You can use <small>small text</small> for captions.

You can strike out deleted material and underline new material.

You can also mark deleted material and inserted material using logical markup rather than visual markup.

• When editing regular wiki articles, just make your changes and do not mark them up in any special way.
• When editing your own previous remarks in talk pages, it is sometimes appropriate to mark up deleted or inserted material.

You can <s>strike out deleted material</s>
and <u>underline new material</u>.

You can also mark <del>deleted material</del> and
<ins>inserted material</ins> using logical markup
rather than visual markup.

Diacritical marks:
À Á Â Ã Ä Å
Æ Ç È É Ê Ë
Ì Í Î Ï Ñ Ò
Ó Ô Õ Ö Ø Ù
Ú Û Ü ß à á
â ã ä å æ ç
è é ê ë ì í
î ï ñ ò ó ô
œ õ ö ø ù ú
û ü ÿ

À Á Â Ã Ä Å 
Æ Ç È É Ê Ë 
Ì Í Î Ï Ñ Ò 
Ó Ô Õ Ö Ø Ù 
Ú Û Ü ß à á 
â ã ä å æ ç 
è é ê ë ì í
î ï ñ ò ó ô 
œ õ ö ø ù ú 
û ü ÿ

Punctuation:
¿ ¡ § ¶
† ‡ • – —
‹ › « »
‘ ’ “ ”

¿ ¡ § ¶
† ‡ • – —
‹ › « »
‘ ’ “ ”

Commercial symbols:
™ © ® ¢ € ¥
£ ¤

™ © ® ¢ € ¥ 
£ ¤

Subscripts:
x₁ x₂ x₃ or
x₀ x₁ x₂ x₃ x₄
x₅ x₆ x₇ x₈ x₉

Superscripts:
x¹ x² x³ or
x⁰ x¹ x² x³ x⁴
x⁵ x⁶ x⁷ x⁸ x⁹

• The latter methods of sub/superscripting cannot be used in the most general context, as they rely on Unicode support which may not be present on all users' machines. For the 1-2-3 superscripts, it is nevertheless preferred when possible (as with units of measurement) because most browsers have an easier time formatting lines with it.

ε₀ = 8.85 × 10⁻¹² C² / J m.

1 hectare = 1 E4 m²

x<sub>1</sub> x<sub>2</sub> x<sub>3</sub> or
<br/>
x&#8320; x&#8321; x&#8322; x&#8323; x&#8324;
<br/>
x&#8325; x&#8326; x&#8327; x&#8328; x&#8329;

x<sup>1</sup> x<sup>2</sup> x<sup>3</sup> or
<br/>
x&#8304; x&sup1; x&sup2; x&sup3; x&#8308;
<br/>
x&#8309; x&#8310; x&#8311; x&#8312; x&#8313;

&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.

1 [[hectare]] = [[1 E4 m&sup2;]]

Greek characters:
α β γ δ ε ζ
η θ ι κ λ μ ν
ξ ο π ρ σ ς
τ υ φ χ ψ ω
Γ Δ Θ Λ Ξ Π
Σ Φ Ψ Ω

α β γ δ ε ζ 
η θ ι κ λ μ ν 
ξ ο π ρ σ ς
τ υ φ χ ψ ω
Γ Δ Θ Λ Ξ Π 
Σ Φ Ψ Ω

Mathematical characters:
∫ ∑ ∏ √ − ± ∞
≈ ∝ ≡ ≠ ≤ ≥
× · ÷ ∂ ′ ″
∇ ‰ ° ∴ ℵ ø
∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
→ ↔

• See also WikiProject Mathematics.

∫ ∑ ∏ √ − ± ∞
≈ ∝ ≡ ≠ ≤ ≥
× · ÷ ∂ ′ ″
∇ ‰ ° ∴ ℵ ø
∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
→ ↔

Spacing in simple math formulas:
Obviously, x² ≥ 0 is true.

• To space things out without allowing line breaks to interrupt the formula, use non-breaking spaces: &nbsp;.

Obviously, ''x''² ≥ 0 is true.

Suppressing interpretation of markup:
Link → (''to'') the [[Wikipedia FAQ]]

• Used to show literal data that would otherwise have special meaning.
• Escape all wiki markup, including that which looks like HTML tags.
• Does not escape HTML character references.
• To escape HTML character references such as &rarr; use &amp;rarr;

<nowiki>Link &rarr; (''to'') 
the [[Wikipedia FAQ]]</nowiki>

Commenting page source:
not shown when viewing page

• Used to leave comments in a page for future editors.
• Note that most comments should go on the appropriate Talk page.

<!-- comment here -->