Help:Editing
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.
Contents |
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:
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
- You can make the wikitext more readable by putting in newlines.
- To break lines use the
<br />element. The HTML tag<br>will be converted to the XHTML<br />tag by HTML Tidy in most instances. The<br>tag is not converted when used in editnotices or in the MediaWiki namespace— it will render invalid XHTML and will break tools such as Twinkle. - Please use these sparingly.
- Close markup between lines; do not start a link or italics or bold on one line and close it on the next.
- When used in a list, a newline does affect the layout (See Help:List).
| 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 |
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. |
|
Blockquote | |
The blockquote tag will indent both margins when needed instead of the left margin only as the colon does. |
|
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 |
|---|---|
marks the end of the list.
|
* ''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. |
A new line marks the end of the list.
|
# ''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 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 |
Mr. Smith or 400 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): italics link New paragraph started here. |
<tt>arrow →</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
- 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 below is to the URL en.wikipedia.org/wiki/Public_transport, which is the Wikipedia article with the name "Public transport". See also Canonicalization.
- A red link is a page that doesn't exist yet; it can be created by clicking on the link.
- A link to its own page will appear only as bold text.
| What it looks like | What you type |
|---|---|
|
London has public transport. |
|
Renamed link
- Same target, different name.
- The target ("piped") text must be placed first, then the text to be displayed second.
| What it looks like | What you type |
|---|---|
|
New York also has public transportation. |
|
Automatically rename links
- Simply typing the pipe character (|) after a link will automatically rename the link in certain circumstances. 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 Pipe trick for details.
| Description | What it looks like | What you type |
|---|---|---|
|
Automatically hide stuff in parentheses. |
| |
|
Automatically hide namespace. |
| |
|
Or both. |
| |
|
This doesn't work for section links. |
[[Wikipedia:Manual of Style#Links|]] |
|
Blend link
- Endings are blended into the link.
- Exception: a trailing apostrophe (') and any characters following the apostrophe are not blended.
- Preferred style is to use this instead of a piped link, if possible.
- Blending can be suppressed by using <nowiki></nowiki> tags, which may be desirable in some instances.
| Description | What it looks like | What you type |
|---|---|---|
|
Blending active. |
San Francisco also has public transportation. Examples include buses, taxicabs, and trams. |
|
|
Blending suppressed. |
A micro-second. |
|
Link to a section of a page
- 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.
- Include "| link title" to create a stylish (piped) link title.
- 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". You can use the pipe and retype the section title to display the text without the # symbol.
| What it looks like | What you type |
|---|---|
|
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. |
|
|
Italics is a piped link to a section within another page. |
|
Create page link
- To create a new page:
- Create a link to it on some other (related) page.
- Save that page.
- Click on the link you just made. The new page will open for editing.
- For more information, see starting an article and check out Wikipedia's naming conventions.
- Please do not create a new article without linking to it from at least one other article.
| Description | What it looks like | What you type |
|---|---|---|
|
Links to pages that don’t exist yet look red. |
|
Redirects
- 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 "USA").
- It is possible to redirect to a section. For example, a redirect to United States#History will redirect to the History section of the United States page, if it exists.
| Description | What you type |
|---|---|
|
Redirect to an article. |
|
|
Redirect to a section. |
|
Link to another namespace
| What it looks like | What you type |
|---|---|
|
See the Wikipedia:Manual of Style. |
|
Link to the same article in another language (interlanguage links)
- To link to a page on the same subject in another language, use the form: [[language code:Title]].
- It is recommended interlanguage links be placed at the very end of the article.
- Interlanguage links are not visible within the formatted article but, instead, appear as language links on the sidebar (to the left) under the menu section "languages".
- Please see Interlanguage links and the Complete list of language wikis available.
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". |
|
|
Other examples. |
|
InterWiki link
- Link to any page on other Wikimedia wikis.
- Note that interwiki links use the internal link style.
- See MetaWikiPedia:Interwiki_map for the list of shortcuts; if the site you want to link to is not on the list, use an external link (see below)
- See also Wikimedia sister projects.
| Description | What it looks like | What you type |
|---|---|---|
|
Linking to a page on another wiki in English. | ||
|
Simple link. Without prefix. Named link. |
| |
|
Linking to a page on another wiki in another language. | ||
|
Simple link. Without prefix. Named link. |
| |
Categories
- To put an article in a category, place a link like the one to the right anywhere in the article. As with interlanguage links, placing these links at the end of the edit box is recommended.
- To link to a category page without putting the article into the category, use a colon prefix (":Category") in the link.
| Description | What it looks like | What you type |
|---|---|---|
|
Categorize an article. |
| |
|
Link to a category. |
| |
|
Without prefix. |
|
External links
- 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" link. Square brackets may be used as normal when not linking to anything - [like this].
- In the URL, all symbols must be among:
A-Z a-z 0-9 . _ \ / ~ % - + & # ? ! = ( ) @ - 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, and square brackets as %5B and %5D.
- If the "named" version contains a closing square bracket "]", then you must use the HTML special character syntax, i.e. ] otherwise the MediaWiki software will prematurely interpret this as the end of the external link.
- See External links for style issues.
| Description | What it looks like | What you type |
|---|---|---|
|
Named link. |
| |
|
Unnamed link |
| |
|
Bare URL |
| |
|
Image markup only. |
|
Miscellaneous
Media link
- To include links to non image uploads such as sounds, use a "media" link. For images, see next section.
- Some uploaded sounds are listed at Commons:Sound.
| What it looks like | What you type |
|---|---|
|
|
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 |
|
|
"Edit" label. |
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: | A picture: [[File:Dexid.png]] |
| With alternative text: | With alternative text: [[File:Dexid.png|alt=Dexid logo]]
|
| Floating to the right side of the page using the frame attribute and a caption:
|
Floating to the right side of the page using the ''frame'' attribute and a caption: [[File:Dexid.png|frame|alt=Dexid logo|Dexid]]
|
| Floating to the right side of the page using the thumb attribute and a caption:
|
Floating to the right side of the page using the ''thumb'' attribute and a caption: [[File:Dexid.png|thumb|alt=Dexid logo|Dexid]]
|
| Floating to the right side of the page without a caption: | Floating to the right side of the page ''without'' a caption: [[File:Dexid.png|right|Dexid]] |
| A picture resized to 30 pixels... | A picture resized to 30 pixels... [[File:Dexid.png|30 px|Dexid]] |
| Linking directly to the description page of an image: | Linking directly to the description page of an image: [[:File:Dexid.png]]
|
| Linking directly to an image without displaying it: | Linking directly to an image without displaying it: [[Media:Dexid.png|Image of the Dexid logo]]
|
| 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:
- If a page is semiprotected, it can be edited by everyone except IPs and accounts that have not yet been confirmed.
- If a page is fully protected, only other admins can make edits to the page.
- A page can also be protected so that it cannot be moved.
- In some cases, an admin might see fit to protect a page from being created.
- For very rare pages, such as the Main Page, "cascading" protection is applied, wherein every page that is transcluded onto a page is protected too.
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.