Difference between revisions of "Wiki Editing"
(2 intermediate revisions by the same user not shown) | |||
Line 71: | Line 71: | ||
* http://meta.wikimedia.org/wiki/Help:Editing_FAQ | * http://meta.wikimedia.org/wiki/Help:Editing_FAQ | ||
+ | |||
+ | |||
+ | === Organizing your writing — sections, paragraphs, lists and lines === | ||
+ | |||
+ | {| border="1" cellpadding="2" cellspacing="0" | ||
+ | |- | ||
+ | !What it looks like | ||
+ | !What you type | ||
+ | |- | ||
+ | | | ||
+ | ; Sections and subsections | ||
+ | Start sections with header lines | ||
+ | |||
+ | Note: Single equal signs give the highest level heading, like the page title; usually projects have the convention not to use them. | ||
+ | |||
+ | <!-- This code prevents confusion in the section editing feature --> | ||
+ | <b><font style="font-size:120%">New section</font></b> | ||
+ | |||
+ | <b><font style="font-size:110%">Subsection</font></b> | ||
+ | |||
+ | <b><font style="font-size:100%">Sub-subsection</font></b> | ||
+ | |||
+ | * Start with a second-level heading (<tt><nowiki>==</nowiki></tt>); 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 order. If listing countries, for example, place them in alphabetical order rather than, say, relative to population of countries, or some haphazardous 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. <nowiki><h4>heading too low level to be in the TOC of large page<h4></nowiki>. | ||
+ | |<nowiki> | ||
+ | |||
+ | == New section == | ||
+ | |||
+ | === Subsection === | ||
+ | |||
+ | ==== Sub-subsection ==== | ||
+ | </nowiki> | ||
+ | |||
+ | |- | ||
+ | | | ||
+ | ; Newline|Newline: | ||
+ | |||
+ | A single | ||
+ | newline | ||
+ | has no | ||
+ | effect on the | ||
+ | layout. | ||
+ | |||
+ | But an empty line | ||
+ | starts a new paragraph, | ||
+ | or ends a list or indented part. | ||
+ | (<nowiki><p></nowiki> disables this paragraphing until <nowiki></p></nowiki> or the end of the section) | ||
+ | |||
+ | (In Cologne blue, two newlines and a div tag give just one newline; in the order newline, div tag, newline, the result is two newlines.) | ||
+ | |||
+ | A semicolon at the start of a line is not rendered, but has the effect of rendering the newline. A colon in such a line is not rendered, but has the effect of starting a new, indented line, see definition list. | ||
+ | |||
+ | |||
+ | |<pre><nowiki> | ||
+ | |||
+ | A single | ||
+ | newline | ||
+ | has no | ||
+ | effect on the | ||
+ | layout. | ||
+ | |||
+ | But an empty line | ||
+ | starts a new paragraph.</nowiki></pre> | ||
+ | |- | ||
+ | |You can break lines <br/> | ||
+ | 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. | ||
+ | |<pre><nowiki>You can break lines <br/> | ||
+ | without starting a new paragraph.</nowiki></pre> | ||
+ | |- | ||
+ | | | ||
+ | * ''Unordered Lists'' are easy to do: | ||
+ | ** start every line with a star, | ||
+ | *** more stars means deeper levels. | ||
+ | * 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 means deeper levels. | ||
+ | * 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 | ||
+ | # in a list | ||
+ | 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 | ||
+ | # in a list | ||
+ | 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> | ||
+ | |- | ||
+ | |'''Definition list''' | ||
+ | ; word : definition of the word | ||
+ | ; longer phrase | ||
+ | : phrase defined | ||
+ | |<pre><nowiki>; word : definition of the word | ||
+ | ; longer phrase | ||
+ | : phrase defined</nowiki></pre> | ||
+ | |||
+ | * One item per line; a newline can appear before the colon, but using a space before the colon improves parsing. | ||
+ | |- | ||
+ | | | ||
+ | ; Indenting | ||
+ | : A colon at the start of a line indents a paragraph. | ||
+ | A manual newline starts a new paragraph. | ||
+ | * This is often used for discussion. | ||
+ | In the case of a semicolon and some text in front of the colon, the first colon starts a new line (indented as before) even though it is in the wikitext not at the start of the line, see definition list. | ||
+ | |<pre><nowiki>: A colon indents a line or paragraph. | ||
+ | A manual newline starts a new paragraph. | ||
+ | </nowiki></pre> | ||
+ | |- | ||
+ | | | ||
+ | When there is a need for separating a block of text | ||
+ | <blockquote> | ||
+ | the '''blockquote''' command will indent both margins when needed instead of the left margin only as the colon does. | ||
+ | </blockquote> | ||
+ | This is useful for (as the name says) inserting blocks of quoted (and cited) text. | ||
+ | | | ||
+ | <pre><nowiki> | ||
+ | <blockquote> | ||
+ | The '''blockquote''' command will indent | ||
+ | both margins when needed instead of the | ||
+ | left margin only as the colon does. | ||
+ | </blockquote> | ||
+ | </nowiki></pre> | ||
+ | |- | ||
+ | |<center>Centered text.</center> | ||
+ | * Please note the US English spelling of "center". | ||
+ | |<pre><nowiki><center>Centered text.</center></nowiki></pre> | ||
+ | |- | ||
+ | |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. | ||
+ | |<pre><nowiki>A horizontal dividing line: | ||
+ | this is above it... | ||
+ | ---- | ||
+ | ...and this is below it. | ||
+ | </nowiki></pre> | ||
+ | |} | ||
+ | |||
+ | |||
+ | * Consult the [http://meta.wikimedia.org/wiki/Help:Contents User's Guide] for information on using the wiki software. | ||
+ | |||
+ | {{Template:Wiki-Nav}} |
Revision as of 04:10, 26 February 2014
List of functions
(apart from the last two examples, these pieces of wikitext are created by typing abc, selecting it and clicking the buttons on the toolbar)
Icon | Function | What it shows when editing | What it shows on the page |
---|---|---|---|
Bold or strong emphasis | '''abc'''
|
abc | |
Italic or emphasis | ''abc''
|
abc | |
Internal link | [[meta:Sandbox|abc]]
|
abc | |
External link | [abc.com]
|
||
Section heading | == abc ==
|
abc | |
Insert image | [[Image:abc.png]]
|
80px | |
Insert media | [[Media:abc.ogg]]
|
Media:abc.ogg | |
Mathematical formula | <math>abc</math>
|
<math>abc</math> | |
Ignore wiki formatting | <nowiki>abc '''[[Bold text]]'''</nowiki>
|
abc '''[[Bold text]]''' | |
Sign talk comments (with time stamp) | ~~~~
|
Gareth Aus 22:49, 11 February 2006 (UTC) | |
Horizontal line | ----
|
|
Organizing your writing — sections, paragraphs, lists and lines
What it looks like | What you type |
---|---|
Start sections with header lines Note: Single equal signs give the highest level heading, like the page title; usually projects have the convention not to use them. New section Subsection Sub-subsection
|
== New section == === Subsection === ==== Sub-subsection ==== |
A single newline has no effect on the layout. But an empty line starts a new paragraph, or ends a list or indented part. (<p> disables this paragraphing until </p> or the end of the section) (In Cologne blue, two newlines and a div tag give just one newline; in the order newline, div tag, newline, the result is two newlines.) A semicolon at the start of a line is not rendered, but has the effect of rendering the newline. A colon in such a line is not rendered, but has the effect of starting a new, indented line, see definition list.
|
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.
|
You can break lines <br/> without starting a new paragraph. |
marks the end of the list.
|
* Unordered Lists are easy to do: ** start every line with a star, *** more stars means deeper levels. * A newline * in a list marks the end of the list. * Of course, * you can * start again. |
marks the end of the list.
|
# Numbered lists are also good ## very organized ## easy to follow # A newline # in a list marks the end of the list. # New numbering starts # with 1. |
|
* You can even do mixed lists *# and nest them *#* or break lines <br/>in lists |
Definition list
|
; word : definition of the word ; longer phrase : phrase defined
|
A manual newline starts a new paragraph.
In the case of a semicolon and some text in front of the colon, the first colon starts a new line (indented as before) even though it is in the wikitext not at the start of the line, see definition list. |
: 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
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> |
|
<center>Centered text.</center> |
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. |
A horizontal dividing line: this is above it... ---- ...and this is below it. |
- Consult the User's Guide for information on using the wiki software.
Wiki Ways | Get Started | Help Editing | functions | Wiki Wizard Editor forum | Network