Help:Wikitext markup

From AVENwiki
(Redirected from Wikitext markup)
Jump to: navigation, search
< back to Help:Contents

Wikitext markup — making your page look the way you want

  • If you want to try out things without danger of doing any harm, you can do so in the sandbox.

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 an appropriate order. If listing countries, for example, place them in alphabetical order rather than, say, relative to population of OECD countries, or some random 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

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.

You can make the wikitext more readable by putting in newlines. You might find this causes future problems — see Don't use line breaks for details.

  • When used in a list, a newline does affect the layout (See Help: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.

(The HTML tag <br> is sufficient. The system produces the XHTML code <br />.)

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

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.

Links, URLs

More information at Help:Link

Internal links

General notes:

  • Enclose the target name in double square brackets — "[[" and "]]"
  • First letter of target name is automatically capitalized
  • Spaces are represented as underscores (but don't do underscores yourself)
  • Links to nonexistent pages are shown in red — Starting A New Page tells about creating the page.
  • When the mouse cursor "hovers" over the link, you see a "hover box" containing... hover over links below to see.
What it looks like What you type
Basic

Sue is reading the FAQ (or FAQs).

Sue is reading the 
[[FAQ]]
(or [[FAQ]]s).
Basic + Text formatting

You can also italicize/etc. links: e.g., AVEN.

 ''[[AVEN]]'' 
Section of page

If the section doesn't exist, the link goes to the top of the page. If there are multiple sections by the same name, link to specific ones by adding how many times that header has already appeared (e.g. if there are 3 sections entitled "Example header," and you wish to link to the third one, then use [[#Example section 3]].

*[[Attraction#Sexual Attraction]]
*[[Attraction#Romantic Attraction]]
Piped link

Use a pipe "|" to create a link label:

*[[Dive_in|Main Contents]]
"blank" pipes hide:

After you save, the server automatically fills in the link label.

*Parentheses: [[Asexuality (forum section)|]]. 
*Colon: [[User:Wikimaster|]].
Links to nonexistent pages

A red link (like this one) points to a page that doesn't exist yet.

guide and the naming conventions page for your project.
A red link ([[like this one]]) points to a page
that doesn't exist yet.
Link to yourself

Please "sign" comments on talk pages:

Your user name: Wikimaster
Your user name plus timestamp: Wikimaster 20:05, 22 December 2008 (EST) (UTC)
Five tildes give a timestamp: 20:05, 22 December 2008 (EST)

The server will fill in the link after you save.

Please "sign" comments on talk pages:
: Your user name: ~~~
: Your user name plus timestamp: ~~~~
: Five tildes give a timestamp: ~~~~~
Redirects

one article title to another with this special link.

#REDIRECT [[Asexuality]]
Media links

To include links to non-image uploads such as sounds, use a "media" link.
Sound

[[media:Sg_mrob.ogg|Sound]]
Category listing links (these appear at page bottom and list the page in the Category)

To list a page in a Category and have a link to the Category at page bottom.

[[Category:AVENwiki basic information]]
Category non-listing links (these appear inline without listing the page in the Category)

To link to a Category without causing the page to be listed in the category, add a colon
Category:AVENwiki basic information

[[:Category:AVENwiki basic information]]
Special pages

"What links here" etc. can be linked as:
Special:Whatlinkshere/Help:Wikitext markup

[[Special:Whatlinkshere/Help:Wikitext markup]]

External links

What it looks like What you type
AVEN, [1]
[http://www.asexuality.org AVEN],
[http://www.asexuality.org]
Email Example,

[2]

[mailto:email@example.com Email Example],
[mailto:email@example.com]
Or just give the URL: http://www.asexuality.org.
  • In the URL all symbols must be among: A-Z a-z 0-9 ._\/~%- &#?!=()@ \x80-\xFF. If a URL contains a different character it should be converted; for example, ^ has to be written %5e. A blank space can also be converted into an underscore.
Or just give the URL:
http://www.asexuality.org.

.

Text formatting — controlling how it looks

What it looks like What you type

Emphasize (italics), strongly (bold), very strongly (bold italics). (These are double and triple apostrophes, not double quotes.)

Note: this can also be applied to links (e.g., AVEN).

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

''[[AVEN]]''

You can also write italic and bold. This is useful in mathematical formulas where you need specific font styles rather than emphasis.

F = ma

(The difference between these two methods is not very important for graphical browsers, so most people ignore it). But it may make a big difference for the visually impaired ;-)

You can also write <i>italic</i> and <b>bold</b>.
This is useful in mathematical formulas where you 
need specific font styles rather than emphasis.
:<b>F</b> = <i>m</i><b>a</b>

You can also write in small caps.

You can also write 
<span style="font-variant:small-caps">
in small caps</span>.
A typewriter font, sometimes used for

technical terms and computer code.

A typewriter font, sometimes used for 
<tt>technical terms</tt> and <code>computer code</code>.
  • For semantic reasons, using <code> where applicable is preferable to using <tt>.
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 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 <strike>strike out deleted material</strike>
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.
Subscript: x2

Superscript: x2 or x²

Most browsers have an easier time formatting lines with &sup2; than with <sup>2</sup>

ε0 = 8.85 × 10−12 C² / J m.

1 hectare = 1 E4 m²

Subscript: x<sub>2</sub>
Superscript: x<sup>2</sup> or x&sup2;
&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.

1 hectare = 1 E4 m&sup2

Just show what I typed

A few different kinds of formatting will tell the wiki to display things as you typed them.

What it looks like What you type

The nowiki tag ignores wiki ''markup''. It reformats text by removing newlines and multiple spaces. It still interprets special characters: &rarr;

<nowiki>
The nowiki tag ignores wiki ''markup''.
It reformats text by removing
newlines    and multiple spaces.
It still interprets special
characters: &rarr;
</nowiki>
The pre tag ignores [[Wiki]] ''markup''.
It also doesn't     reformat text.
It still interprets special characters: &rarr;
<pre>
The pre tag ignores [[Wiki]] ''markup''.
It also doesn't     reformat text.
It still interprets special characters: &rarr;
</pre>

Leading spaces are another way to preserve formatting.

Putting a space at the beginning of each
line stops the text   from being reformatted.
It still interprets wiki markup and
special characters: →
Leading spaces are another way to preserve formatting.

 Putting a space at the beginning of each
 line stops the text   from being reformatted.
 It still interprets wiki ''markup'' and
 special characters: &rarr

Invisible comments to editors (<!-- -->) only appear while editing the page. So nothing shows up between here and here

Public comments should go on the talk page.


Invisible comments to editors (<!-- -->) 
only appear while editing the page.
So nothing shows up between '''here''' <!-- comment here -->'''and here'''

Public comments should go on the ''talk page''.

Special characters

What it looks like What you type

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

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


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

&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring;
&AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml;
&Igrave; &Iacute; &Icirc; &Iuml; &Ntilde; &Ograve;
&Oacute; &Ocirc; &Otilde; &Ouml; &Oslash; &Ugrave;
&Uacute; &Ucirc; &Uuml; &szlig; &agrave; &aacute;
&acirc; &atilde; &auml; &aring; &aelig; &ccedil;
&egrave; &eacute; &ecirc; &euml; &igrave; &iacute;
&icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc;
&oelig; &otilde; &ouml; &oslash; &ugrave; &uacute;
&ucirc; &uuml; &yuml;

Punctuation:
¿ ¡ « » § ¶ † ‡ • - – —

¿ ¡ « » § ¶
† ‡ • - – —

¿ ¡ « » § ¶
† ‡ • - – —

&iquest; &iexcl; &laquo; &raquo; &sect; &para;
&dagger; &Dagger; &bull; - &ndash; &mdash;

Commercial symbols:
™ © ® ¢ € ¥ £ ¤

™ © ® ¢ € ¥ £ ¤
™ © ® ¢ € ¥ £ ¤

&trade; &copy; &reg; &cent; &euro; &yen; &pound; &curren;
Greek characters:

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

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

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

&alpha; &beta; &gamma; &delta; &epsilon; &zeta;
&eta; &theta; &iota; &kappa; &lambda; &mu; &nu;
&xi; &omicron; &pi; &rho;  &sigma; &sigmaf;
&tau; &upsilon; &phi; &chi; &psi; &omega;
&Gamma; &Delta; &Theta; &Lambda; &Xi; &Pi;
&Sigma; &Phi; &Psi; &Omega;

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

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

Problem symbols:

ℵ ∉

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

&int; &sum; &prod; &radic; &minus; &plusmn; &infin;
&asymp; &prop; &equiv; &ne; &le; &ge; 
&times; &middot; &divide; &part; &prime; &Prime;
&nabla; &permil; &deg; &there4; &oslash;
&isin; &cap; &cup; &sub; &sup; &sube; &supe;
&not; &and; &or; &exist; &forall; &rArr; &hArr;
&rarr; &harr; &uarr;

Problem symbols:

ℵ ∉

&alefsym; &notin;

Including another page — transclusion and templates

Changing a transcluded file will change every file that transcludes it.

Transclusion
Including the contents of another page into the current page.
This transclusion demo is a little bit of text from the page Help:Transclusion Demo to be included into any file.
{{:Help:Transclusion Demo}}
Template

A special kind of page designed for transclusion. These pages are found in the Template: namespace

Templates can even take parameters, by using
{{templatename|value}}

When you edit a page, all the templates used on the page are listed below the edit box.

This article explains an inside joke used on the AVEN forums, especially the Just For Fun board.
It does not describe any actual facts, nor does it represent the beliefs of asexuals as a whole.
{{JFF}}