Wiki Editing: Difference between revisions

From PreparingYou
Jump to navigation Jump to search
No edit summary
No edit summary
Line 95: Line 95:
* Start with a second-level heading (<tt><nowiki>==</nowiki></tt>); don't use first-level headings (=).
* 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).
* Don't skip levels (for example, second-level followed by fourth-level).
* A [[Help:Table_of_contents#Table_of_contents_.28TOC.29|table of contents]] will automatically be added to an article that has four or more sections.  
* 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 [[w:OECD|OECD]] countries, or some [[wikt:haphazard|haphazard]]ous order.
* 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>.
* 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>
|<nowiki>
Line 109: Line 109:
|-
|-
|
|
; [[w:Newline|Newline]]:
; Newline|Newline:


A single
A single
Line 126: Line 126:
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 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.


You can make the wikitext more readable by putting in newlines.
You might find this causes future problems&mdash;see [[w:Wikipedia:Don't use line breaks]] for details.


* When used in a list, a newline ''does'' affect the layout (See [[Help:List]]).
|<pre><nowiki>
|<pre><nowiki>


Line 145: Line 142:


* Please use this sparingly.
* Please use this sparingly.
* Close markup between lines; do not start a [[Help:link|link]] or ''italics'' or '''bold''' on one line and close it on the next.
* 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/>
|<pre><nowiki>You can break lines <br/>
without starting a new paragraph.</nowiki></pre>
without starting a new paragraph.</nowiki></pre>
Line 214: Line 211:
: A colon at the start of a line indents a paragraph.
: A colon at the start of a line indents a paragraph.
A manual newline starts a new paragraph.
A manual newline starts a new paragraph.
* This is often used for discussion on [[Help:talk page|talk page]]s.
* 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.
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.
|<pre><nowiki>: A colon indents a line or paragraph.

Revision as of 03:05, 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 text Bold or strong emphasis '''abc''' abc
Italic text Italic or emphasis ''abc'' abc
Internal link Internal link [[meta:Sandbox|abc]] abc
External link External link [abc.com]
Level 2 headline Section heading == abc ==

abc

Embedded image Insert image [[Image:abc.png]] File:Abc.png
Media file link Insert media [[Media:abc.ogg]] Media:abc.ogg
Mathematical formula (LaTeX) Mathematical formula <math>abc</math> <math>abc</math>
Ignore wiki formatting Ignore wiki formatting <nowiki>abc '''[[Bold text]]'''</nowiki> abc '''[[Bold text]]'''
Your signature with timestamp Sign talk comments (with time stamp) ~~~~ Gareth Aus 22:49, 11 February 2006 (UTC)
Horizontal line Horizontal line ----


Organizing your writing — sections, paragraphs, lists and lines

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.

New section

Subsection

Sub-subsection

  • 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 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. <h4>heading too low level to be in the TOC of large page<h4>.
== New section == === Subsection === ==== Sub-subsection ====
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. (<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.

  • 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.
  • 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.
* 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.

  1. Numbered lists are also good
    1. very organized
    2. easy to follow
  2. A newline
  3. in a list

marks the end of the list.

  1. New numbering starts
  2. with 1.
# 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
    1. and nest them
      • or break lines
        in lists
* 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
; word : definition of the word
; longer phrase 
: phrase defined
  • 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.

: 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>
Centered text.
  • Please note the US English spelling of "center".
<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.



Wiki Ways | Get Started | Help Editing | functions | Wiki Wizard Editor forum | Network