Help:Editing

From Dexid
Jump to: navigation, search

Editing refers to the changing of a page by a Wikimedia user. Unless certain restrictions are in effect, such as protection, all pages are editable, by everyone. This is a brief overview of that process. The editing table of contents to the right contains more information on editing functions. Remember to always reference your sources. For more info on the type of work being done on this site, see Help:Contents.

Here are the most frequently used types of wiki markup.

Layout

Sections

Section headings

Use headings to split articles into sections. Put a heading on a separate line. A level-two heading is the highest level editors use in an article.

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. Start with 2 'equals' characters.

Subsection

Using more 'equals' characters creates a subsection.

A smaller subsection

Don't skip levels, like from two to four 'equals' characters.

==Section headings==

''Headings'' organize your writing into sections.
The Wiki software can automatically generate
a table of contents from them.
Start with 2 'equals' characters.

===Subsection===

Using more 'equals' characters creates a subsection.

====A smaller subsection====

Don't skip levels, like from two to four 'equals' characters.
Horizontal line

Separating with a horizontal dividing line:

this is above it...

...and this is below it.

If you don't use a section header, you don't get a TOC entry.

'''Horizontal line'''
Separating with a horizontal dividing line:
:this is above it...
----
:...and this is below it.
If you don't use a section header, you don't get a TOC entry.

Table of contents

When a page has at least four headings, a table of contents (TOC) will appear in front of the first header (after the lead). Putting __TOC__ anywhere forces the TOC to appear at that point (instead of just before the first heading). Putting __NOTOC__ anywhere forces the TOC to disappear.

Line breaks

What it looks like What you type

A single newline has no effect on the layout.

But an empty line starts a new paragraph, or ends a list or indented part.

A single newline has no
effect on the layout.

But an empty line starts a new paragraph, or ends a list or indented part.

You can break lines
without starting a new paragraph.

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

Indent text

What it looks like What you type

Left indent

A colon at the start of a line
causes the line to be indented,
most commonly used on Talk pages.
:A colon at the start of a line
::causes the line to be indented,
:::most commonly used on Talk pages.

Blockquote
When there is a need for separating a block of text. This is useful for (as the name says) inserting blocks of quoted (and cited) text.

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

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

Center text

What it looks like What you type
Centered text
<div class="center" style="width:auto; margin-left:auto; margin-right:auto;">Centered text</div>

Lists

What it looks like What you type
  • Unordered lists are easy to do:
    • Start every line with a star.
      • More stars indicate a deeper level.
    Previous item continues.
    • A new line
  • 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 new line
* 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
    Previous item continues

A new line marks the end of the list.

  1. New numbering starts with 1.
# ''Numbered lists'' are:
## Very organized
## Easy to follow
#: Previous item continues
A new line marks the end of the list.
# New numbering starts with 1.

Retaining newlines and spaces

The MediaWiki software suppresses single newlines and converts lines starting with a space to preformatted text in a dashed box. HTML suppresses multiple spaces. It is often desirable to retain these elements for poems, lyrics, mottoes, oaths and the like.

What it looks like What you type
<poem>

In Xanadu did Kubla Khan

 A stately pleasure-dome decree:

Where Alph, the sacred river, ran

 Through caverns measureless to man

Down to a sunless sea.

So twice five miles of fertile ground

 With walls and towers were girdled round:

And there were gardens bright with sinuous rills,

 Where blossomed many an incense-bearing tree;

And here were forests ancient as the hills,

 Enfolding sunny spots of greenery.

</poem>

<poem>
In Xanadu did Kubla Khan
  A stately pleasure-dome decree:
Where Alph, the sacred river, ran
  Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
  With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
  Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
  Enfolding sunny spots of greenery.
</poem>

Format

Text formatting

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.

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

Syntax highlighting for source code.

Computer code has a colored background and more stringent formatting. Suppose we want to define int main(): <syntaxhighlight lang="cpp">#include <iostream> int main ( int argc, char **argv ) {

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

}</syntaxhighlight>

Computer code has a colored background
and more stringent formatting. Suppose we
want to define <code>int  main()</code>:

<syntaxhighlight lang="cpp">#include <iostream>
int main ( int argc,  char **argv ) {
    std::cout << "Hello World!";
    return 0;
}</syntaxhighlight>

You can use small text for captions.

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

Better stay away from big text, unless it's within small text.

Better stay away from <big>big text</big>, unless
<small> it's <big>within</big> small</small> text.

You can include a non-breaking space (sometimes called non-printing character) where you require two words to always appear together on the same line, such as Mr. Smith or 400 km/h using &nbsp; in place of a regular space between the two "words" that need to behave as a single word (never be separated on different lines).


Mr.&nbsp;Smith or 400&nbsp;km/h.

Extra spacing within text can best be achieved using the pad template:

Mary   had a little lamb.


Mary {{pad|4em}} had a little lamb.

Typewriter font (does also work beyond the end of a paragraph):
arrow →

italics link

New paragraph started here.

<tt>arrow      &rarr;</tt>

<tt>''italics''</tt>
<tt>[[link]]

New paragraph </tt>started here.

Links and URLs

Free links

In Wikipedia and some other Wikis, free links are used in Wikitext markup to produce internal links between pages, as opposed to the concept of CamelCase for the same purpose, which was used in the early days of Wikipedia, see CamelCase and Wikipedia.

In Wikipedia's markup language, you create free links by putting double square brackets around text designating the title of the page you want to link to. Thus, [[Texas]] will be rendered as Texas. Optionally, you can use a vertical bar (|) to customize the link title. For example, typing [[Texas|Lone Star state]] will produce Lone Star state, a link that is displayed as "Lone Star state" but in fact links to Texas.

Link to another Wiki article

What it looks like What you type

London has public transport.

London has [[public transport]].

Renamed link

What it looks like What you type

New York also has public transportation.

New York also has [[public transport|public transportation]].

Automatically rename links

Description What it looks like What you type

Automatically hide stuff in parentheses.

kingdom

[[kingdom (biology)|]].

Automatically hide namespace.

Village pump

[[Wikipedia:Village pump|]].

Or both.

Manual of Style

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

This doesn't work for section links.

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

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

Blend link

Description What it looks like What you type

Blending active.

San Francisco also has public transportation. Examples include buses, taxicabs, and trams.

San Francisco also has [[public transport]]ation. Examples include [[bus]]es, [[taxicab]]s, and [[tram]]s.

Blending suppressed.

A micro-second.

A [[micro-]]<nowiki></nowiki>second

Link to a section of a page

What it looks like What you type

Wikipedia:Manual of Style#Italics is a link to a section within another page.

[[Wikipedia:Manual of Style#Italics]] is a link to a section within another page.

#Links and URLs is a link to another section on the current page. Links and URLs is a link to the same section without showing the # symbol.

[[#Links and URLs]] is a link to another section on the current page. [[#Links and URLs|Links and URLs]] is a link to the same section without showing the # symbol.

Italics is a piped link to a section within another page.

[[Wikipedia:Manual of Style#Italics|Italics]] is a piped link to a section within another page.

Create page link

Description What it looks like What you type

Links to pages that don’t exist yet look red.

Wikipedia:Community portal/Opentask/Requested articles

[[Wikipedia:Community portal/Opentask/Requested articles]]

Redirects

Description What you type

Redirect to an article.

#REDIRECT [[United States]]

Redirect to a section.

#REDIRECT [[United States#History]]

Link to another namespace

What it looks like What you type

See the Wikipedia:Manual of Style.

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

Link to the same article in another language (interlanguage links)

NOTE: To create an inline link (a clickable link within the text), see Inline interlanguage links.

Description What you type

Link to the German version of "Plankton".
"de" is the language-code for "Deutsch" (the German language).

[[de:Plankton]]

Other examples.

[[de:Plankton]] [[es:Plancton]] [[ru:Планктон]] [[simple:Plankton]]

InterWiki link

Description What it looks like What you type

Linking to a page on another wiki in English.
All of these forms lead to the URL http://en.wiktionary.org/wiki/Hello

Simple link.

Without prefix.

Named link.

Wiktionary:Hello

Hello

Wiktionary definition of 'Hello'

[[Wiktionary:Hello]]

[[Wiktionary:Hello|]]

[[Wiktionary:Hello|Wiktionary definition of 'Hello']]

Linking to a page on another wiki in another language.
All of these forms lead to the URL http://fr.wiktionary.org/wiki/bonjour

Simple link.

Without prefix.

Named link.

Wiktionary:fr:bonjour

fr:bonjour

bonjour

[[Wiktionary:fr:bonjour]]

[[Wiktionary:fr:bonjour|]]

[[Wiktionary:fr:bonjour|bonjour]]

Categories

Description What it looks like What you type

Categorize an article.

[[Category:Character sets]]

Link to a category.

Category:Character sets

[[:Category:Character sets]]

Without prefix.

Character sets

[[:Category:Character sets|]]

External links

Description What it looks like What you type

Named link.

Wikipedia

[http://www.wikipedia.org Wikipedia]

Unnamed link
(only used within article body for footnotes).

[1]

[http://www.wikipedia.org/]

Bare URL
(bad style).

http://www.wikipedia.org/

http://www.wikipedia.org/

Image markup only.

WinObj

<span class="plainlinks">[http://www.sysinternals.com/ntw2k/freeware/winobj.shtml WinObj]</span>

Miscellaneous

Media link

What it looks like What you type

Sound

[[media:Classical guitar scale.ogg|Sound]]

Links directly into edit mode

Description What it looks like What you type

Full URL.

http://www.dexid.org/w/index.php?title=Help:Wiki_markup&action=edit

{{fullurl:Help:Wiki markup|action=edit}}

"Edit" label.

edit

edit

Images

Only images that have been uploaded to Wikipedia can be used. To upload images, use the upload page. You can find the uploaded image on the image list.

What it looks like What you type
A picture:

Dexid.png

A picture: 
[[File:Dexid.png]]
With alternative text:

Dexid logo

With alternative text:
[[File:Dexid.png|alt=Dexid logo]]
  • Alternative text, used when the image is unavailable or when the image is loaded in a text-only browser, or when spoken aloud, is strongly encouraged.
Floating to the right side of the page using the frame attribute and a caption:
Dexid logo
Dexid

Floating to the right side of the page 
using the ''frame'' attribute and a caption:
[[File:Dexid.png|frame|alt=Dexid logo|Dexid]]
  • The frame tag automatically floats the image right.
  • The last parameter is the caption that appears below the image.
Floating to the right side of the page using the thumb attribute and a caption:
Dexid logo
Dexid

Floating to the right side of the page 
using the ''thumb'' attribute and a caption:
[[File:Dexid.png|thumb|alt=Dexid logo|Dexid]]
  • The thumb tag automatically floats the image right.
  • An enlarge icon is placed in the lower right corner.
Floating to the right side of the page without a caption:
Dexid
Floating to the right side of the page
''without'' a caption:
[[File:Dexid.png|right|Dexid]]
A picture resized to 30 pixels...

Dexid

A picture resized to 30 pixels...
[[File:Dexid.png|30 px|Dexid]]
Linking directly to the description page of an image:

File:Dexid.png

Linking directly to the description page
of an image:
[[:File:Dexid.png]]
  • Clicking on an image displayed on a page (such as any of the ones above) also leads to the description page.
Linking directly to an image without displaying it:

Image of the Dexid logo

Linking directly to an image
without displaying it:
[[Media:Dexid.png|Image of the Dexid logo]]
  • To include links to images shown as links instead of drawn on the page, use a "media" link.
Using the span and div tag to separate images from text (note that this may allow images to cover text):
Example:
<div style="display:inline;
width:220px; float:right;">
Place images here </div>
Using wiki markup to make a table in which to place a vertical column of images (this helps edit links match headers, especially in Firefox browsers):
Example: {| align=right
|-
| 
Place images here
|}

Restrictions

Some pages cannot be edited by everyone. A special function known as protection can be applied to a page by administrators, making the said page uneditable to certain classes of users. There are several degrees of protection:

There are various reasons why a page might be protected. Vandalism and spam can lead to semi-protection, while content wars and other severe cases can lead to full protection. There are other times where 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.

Further reading

Personal tools
Namespaces
Variants
Actions
Navigation
Browse wiki
Interaction
Toolbox