Ibjadmin: /* Organizing your writing */

2010-07-21T17:05:51Z

Organizing your writing

← Older revision		Revision as of 19:05, 21 July 2010
Line 178:		Line 178:

	== Organizing your writing ==		== Organizing your writing ==
	~~:''See also: [[wikipediawikipedia:Picture tutorial\|w:Picture tutorial]]''~~
	{\| border="1" cellspacing="2"		{\| border="1" cellspacing="2"
	!width="1000"\|What it looks like		!width="1000"\|What it looks like
Line 220:		Line 219:
	\|- id="lists"		\|- id="lists"
	\|		\|
	* ''Unordered ~~[[Help:List\|list]]s~~'' are easy to do:		* ''Unordered lists'' are easy to do:
	** Start every line with a star.		** Start every line with a star.
	*** More stars indicate a deeper level.		*** More stars indicate a deeper level.

Ibjadmin: /* Templates */

2010-07-21T17:05:23Z

Templates

← Older revision		Revision as of 19:05, 21 July 2010
Line 767:		Line 767:
	</nowiki></pre>		</nowiki></pre>
	\|}		\|}

	~~==Templates==~~
	~~{{main\|Help:Template}}~~
	~~Templates are segments of Wiki markup that are meant to be copied automatically ("transcluded") into a page.~~
	~~You add them by putting the template's name in <nowiki>{{double braces}}</nowiki>. It is also possible to transclude other pages by using <nowiki>{{:colon and double braces}}</nowiki>.~~

	~~Some templates take ''parameters'', as well, which you separate with the pipe character.~~

	~~{\| border="1" cellpadding="2"~~
	~~!width="1000"\|What it looks like~~
	~~!width="500"\|What you type~~
	\|-
	\|
	~~{{Transclusion demo}}~~
	~~\|<pre>~~
	~~{{Transclusion demo}}~~
	~~</pre>~~
	\|-
	\|
	~~{{Help:Transclusion Demo}}~~
	~~\|<pre>~~
	~~{{Help:Transclusion Demo}}~~
	~~</pre>~~
	\|-
	\|

	~~This template takes two parameters, and~~
	~~creates underlined text with a hover box~~
	~~for many modern browsers supporting CSS:~~

	~~{{H:title\|This is the hover text\|~~
	~~Hover your mouse over this text}}~~

	~~Go to this page to see the H:title template~~
	~~itself: {{tl\|H:title}}~~

	~~\|<pre>~~
	~~This template takes two parameters, and~~
	~~creates underlined text with a hover box~~
	~~for many modern browsers supporting CSS:~~

	~~{{H:title\|This is the hover text\|~~
	~~Hover your mouse over this text}}~~

	~~Go to this page to see the H:title template~~
	~~itself: {{tl\|H:title}}~~
	~~</pre>~~
	\|}

	~~[[Category:Editor handbook]]~~
	~~{{h:f\|enname=Wikitext examples}}~~

Ibjadmin: /* Mathematical formulae */

2010-07-21T16:36:42Z

Mathematical formulae

← Older revision		Revision as of 18:36, 21 July 2010
Line 755:		Line 755:
	== Mathematical formulae ==		== Mathematical formulae ==
	{{main\|Help:Displaying a formula}}		{{main\|Help:Displaying a formula}}
	You can format mathematical formulae with ~~[[w:~~TeX~~\|TeX]]~~ markup.		You can format mathematical formulae with TeX markup.

	{\| border="1" cellpadding="2"		{\| border="1" cellpadding="2"

Ibjadmin: moved Wikitext Examples to Help:Wikitext Examples

2010-07-07T15:29:19Z

moved Wikitext Examples to Help:Wikitext Examples

← Older revision	Revision as of 17:29, 7 July 2010
(No difference)

Ibjadmin: /* Basic text formatting */

2010-07-07T08:11:27Z

Basic text formatting

← Older revision		Revision as of 10:11, 7 July 2010
Line 84:		Line 84:

	\|You should "sign" your comments on talk pages: <br/>		\|You should "sign" your comments on talk pages: <br/>
	* Three tildes gives your signature: [[User:Example\|Example]] <br/>		* Three tildes gives your signature: User:Example\|Example <br/>
	* Four tildes give your signature plus date/time: [[User:Example\|Example]] 07:46, 27 November 2005 (UTC) <br/>		* Four tildes give your signature plus date/time: User:Example\|Example 07:46, 27 November 2005 (UTC) <br/>
	* Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC) <br/>		* Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC) <br/>
	\|<pre>		\|<pre>

Ibjadmin: Created page with '== Basic text formatting == You can format the page using Wikitext special characters. {|width="80%" border="1" cellpadding="2" cellspacing="0" |- !What it looks like !What you�'

2010-07-07T08:10:42Z

Created page with '== Basic text formatting == You can format the page using Wikitext special characters. {|width="80%" border="1" cellpadding="2" cellspacing="0" |- !What it looks like !What you�'

New page

== Basic text formatting ==
You can format the page using Wikitext special characters.

{|width="80%" border="1" cellpadding="2" cellspacing="0"
|-
!What it looks like
!What you type
|-
|
You can ''italicize text'' by putting 2
apostrophes on '''each''' side.

3 apostrophes will '''embolden the text'''.

5 apostrophes will '''embolden''' and ''italicize''
'''''the text'''''.

(Using 4 apostrophes doesn't do anything
special -- the last pair are just
''''left over ones'''' that are included
as part of the text.)
|<pre>
You can ''italicize text'' by putting 2
apostrophes on '''each''' side.

3 apostrophes will '''embolden the text'''.

5 apostrophes will '''embolden''' and ''italicize''
'''''the text'''''.

(Using 4 apostrophes doesn't do anything
special -- the last pair are just
''''left over ones'''' that are included
as part of the text.)
</pre>
|-
|
A single newline
generally has no effect on the layout.
These can be used to separate
sentences within a paragraph.
Some editors find that this aids editing
and improves the ''diff'' function
(used internally to compare
different versions of a page).

But an empty line
starts a new paragraph.

When used in a list, a newline ''does'' affect the layout ([[#lists|see below]]).
|<pre>
A single newline
generally has no effect on the layout.
These can be used to separate
sentences within a paragraph.
Some editors find that this aids editing
and improves the ''diff'' function
(used internally to compare
different versions of a page).

But an empty line
starts a new paragraph.

When used in a list, a newline ''does''
affect the layout ([[#lists|see below]]).
</pre>
|-
|
You can break lines 
without a new paragraph. 
Please use this sparingly.

Please do not start a link or ''italics'' or '''bold''' text on one line and end on the next.
|<pre>
You can break lines 
without a new paragraph. 
Please use this sparingly.

Please do not start a link or
''italics'' or '''bold''' text on one line
and end on the next.
</pre>
|-

|You should "sign" your comments on talk pages: 
* Three tildes gives your signature: [[User:Example|Example]] 
* Four tildes give your signature plus date/time: [[User:Example|Example]] 07:46, 27 November 2005 (UTC) 
* Five tildes gives the date/time alone: 07:46, 27 November 2005 (UTC) 
|<pre>
You should "sign" your comments
on talk pages:
- Three tildes gives your
signature: ~~~
- Four tildes give your
signature plus date/time: ~~~~
- Five tildes gives the
date/time alone: ~~~~~
</pre>
|}

== HTML tags ==
{{main|Help:HTML in wikitext}}
You can use some HTML tags, too. However, you should avoid HTML in favor of Wiki markup whenever possible.

{| border="1" cellpadding="1"
!width="1000"|What it looks like
!width="500"|What you type
|-
|
Put text in a <tt>typewriter
font</tt>. The same font is
generally used for <code>
computer code</code>.
|<pre>
Put text in a <tt>typewriter
font</tt>. The same font is
generally used for <code>
computer code</code>.
</pre>
|-
|
<strike>Strike out</strike>
or underline text,
or write it 
in small caps.
|<pre>
<strike>Strike out</strike>
or underline text,
or write it 
in small caps.
</pre>
|-
|
Superscripts and subscripts:
X2, H2O
|<pre>
Superscripts and subscripts:
X2, H2O
</pre>
|-
|
<center>Centered text</center>
* Please note the American spelling of "center".
|<pre>
<center>Centered text</center>
* Please note the American spelling of "center".
</pre>
|-
|
<blockquote>
The '''blockquote''' command ''formats'' block
quotations, typically by surrounding them
with whitespace and a slightly different font.
</blockquote>
|<pre>
<blockquote>
The '''blockquote''' command ''formats'' block
quotations, typically by surrounding them
with whitespace and a slightly different font.
</blockquote>
</pre>
|-
|
Invisible comments to editors ()
appear only while editing the page.


* If you wish to make comments to the public, you should usually use the [[talk page]].
|<pre>
Invisible comments to editors ()
appear only while editing the page.

</pre>
|}

== Organizing your writing ==
:''See also: [[wikipediawikipedia:Picture tutorial|w:Picture tutorial]]''
{| border="1" cellspacing="2"
!width="1000"|What it looks like
!width="500"|What you type
|-
|
<h2>Section headings</h2>

''Headings'' organize your writing into
sections. The ''Wiki'' software can automatically
generate a [[Help:table of contents|table of contents]] from them.



<h3>Subsection</h3>
Using more "equals" (=) signs creates a subsection.

<h4>A smaller subsection</h4>

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

Start with 2 equals signs not 1 because 1 creates H1
tags which should be reserved for page title.
|<pre>
== Section headings ==

''Headings'' organize your writing into
sections. The ''Wiki'' software can automatically
generate a [[Help:table of contents|table of contents]] from them.

=== Subsection ===
Using more "equals" (=) signs creates a subsection.

==== A smaller subsection ====

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

Start with 2 equals signs not 1 because 1 creates H1
tags which should be reserved for page title.
</pre>
|- id="lists"
|
* ''Unordered [[Help:List|list]]s'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
*: Previous item continues.
** A newline
* in a list
marks the end of the list.
*Of course you can start again.
|<pre>
* ''Unordered lists'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
*: Previous item continues.
** A newline
* in a list
marks the end of the list.
*Of course you can start again.
</pre>
|-
|
# ''Numbered lists'' are:
## Very organized
## Easy to follow
A newline marks the end of the list.
# New numbering starts with 1.

|<pre>
# ''Numbered lists'' are:
## Very organized
## Easy to follow
A newline marks the end of the list.
# New numbering starts with 1.
</pre>
|-
|
Here's a ''definition list'':
; Word : Definition of the word
; A longer phrase needing definition
: Phrase defined
; A word : Which has a definition
: Also a second definition
: And even a third

Begin with a semicolon. One item per line;
a newline can appear before the colon, but
using a space before the colon improves
parsing.
|<pre>
Here's a ''definition list'':
; Word : Definition of the word
; A longer phrase needing definition
: Phrase defined
; A word : Which has a definition
: Also a second one
: And even a third

Begin with a semicolon. One item per line;
a newline can appear before the colon, but
using a space before the colon improves
parsing.
</pre>
|-
|
* You can even do mixed lists
*# and nest them
*# inside each other
*#* or break lines in lists.
*#; definition lists
*#: can be
*#:; nested : too
|<pre>
* You can even do mixed lists
*# and nest them
*# inside each other
*#* or break lines in lists.
*#; definition lists
*#: can be
*#:; nested : too
</pre>
|-
|
: A colon (:) indents a line or paragraph.
A newline starts a new paragraph. 
Should only be used on [[talk page]]s. 
For articles, you probably want the blockquote tag.
: We use 1 colon to indent once.
:: We use 2 colons to indent twice.
::: 3 colons to indent 3 times, and so on.
|<pre>
: A colon (:) indents a line or paragraph.
A newline starts a new paragraph.
Should only be used on talk pages.
For articles, you probably want the blockquote tag.
: We use 1 colon to indent once.
:: We use 2 colons to indent twice.
::: 3 colons to indent 3 times, and so on.
</pre>
|-
|
You can make [[w:horizontal dividing line|horizontal dividing line]]s
(----) to separate text.
----
But you should usually use sections instead,
so that they go in the table of contents.
|<pre>
You can make [[w:horizontal dividing line|horizontal dividing line]]s
(----) to separate text.
----
But you should usually use sections instead,
so that they go in the table of contents.
</pre>
|-
|
You can add footnotes to sentences using the ''ref'' tag -- this is especially good for citing a source.

:There are over six billion people in the world.<ref>CIA World Factbook, 2006.</ref>

References: <references/>

For details, see [[Wikipedia:Footnotes]] and [[Help:Footnotes]].
|
<pre>
You can add footnotes to sentences using
the ''ref'' tag -- this is especially good
for citing a source.

:There are over six billion people in the
world.<ref>CIA World Factbook, 2006.</ref>

References: <references/>

For details, see [[Wikipedia:Footnotes]]
and [[Help:Footnotes]].
</pre>
|}

== Links ==
{{main|Help:Link}}
You will often want to make clickable ''links'' to other pages.

{|width="100%" border="1" cellpadding="2" cellspacing="0"
|-
!What it looks like
!What you type
|-
|
Here's a link to a page named [[Official position]].
You can even say [[official position]]s
and the link will show up correctly.
|<pre>
Here's a link to a page named [[Official position]].
You can even say [[official position]]s
and the link will show up correctly.
</pre>
|-
|
You can put formatting around a link.
Example: ''[[Wikipedia]]''.
|<pre>
You can put formatting around a link.
Example: ''[[Wikipedia]]''.
</pre>
|-
|
The ''first letter'' of articles is automatically
capitalized, so [[wikipedia]] goes to the same place
as [[Wikipedia]]. Capitalization matters after the
first letter.
|<pre>
The ''first letter'' of articles is automatically
capitalized, so [[wikipedia]] goes to the same place
as [[Wikipedia]]. Capitalization matters after the
first letter.
</pre>
|-
|
[[Intentionally permanent red link]] is a page that doesn't exist
yet. You could create it by clicking on the link.
|<pre>
[[Intentionally permanent red link]] is a page that doesn't exist
yet. You could create it by clicking on the link.
</pre>
|-
|
You can link to a page section by its title:

* [[Doxygen#Doxygen Examples]]..

If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".
|<pre>
You can link to a page section by its title:

* [[Doxygen#Doxygen Examples]].

If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".
</pre>
|-
|
You can make a link point to a different place
with a [[Help:Piped link|piped link]]. Put the link
target first, then the pipe character "|", then
the link text.

* [[Help:Link|About Links]]
* [[List of cities by country#Morocco|Cities in Morocco]]

Or you can use the "pipe trick" so that a title that
contains disambiguation text will appear with more concise
link text.

* [[Spinning (textiles)|Spinning]]
* [[Boston, Massachusetts|Boston]]
|<pre>
You can make a link point to a different place
with a [[Help:Piped link|piped link]]. Put the link
target first, then the pipe character "|", then
the link text.

* [[Help:Link|About Links]]
* [[List of cities by country#Morocco|Cities in Morocco]]

Or you can use the "pipe trick" so that a title that
contains disambiguation text will appear with more concise
link text.

* [[Spinning (textiles)|]]
* [[Boston, Massachusetts|]]
</pre>
|-
|
You can make an external link just by typing a URL:
http://www.nupedia.com

You can give it a title:
[http://www.nupedia.com Nupedia]

Or leave the title blank:
[http://www.nupedia.com]

External link can be used to link to a wiki page that cannot be linked to with <nowiki>[[page]]</nowiki>:
http://meta.wikimedia.org/w/index.php?title=Fotonotes&oldid=482030#Installation
|
<pre>
You can make an external link just by typing a URL:
http://www.nupedia.com

You can give it a title:
[http://www.nupedia.com Nupedia]

Or leave the title blank:
[http://www.nupedia.com]

External link can be used to link to a wiki page that
cannot be linked to with <nowiki><nowiki>[[page]]</nowiki></nowiki>:
http://meta.wikimedia.org/w/index.php?title=Fotonotes
&oldid=482030#Installation
</pre>
|-
|
Linking to an e-mail address works the same way:
mailto:someone@example.com or [mailto:someone@example.com someone]
|
<pre>
Linking to an e-mail address works the same way:
mailto:someone@example.com or [mailto:someone@example.com someone]
</pre>
|-
|
You can [[Help:Redirect|redirect]] the user to another page.
|<pre>
#REDIRECT [[Official position]]
</pre>
|-
|
[[Help:Category|Category links]] do not show up in line
but instead at page bottom
''and cause the page to be listed in the category.''
[[Category:English documentation]]

Add an extra colon to ''link'' to a category in line
without causing the page to be listed in the category:
[[:Category:English documentation]]
|<pre>
[[Help:Category|Category links]] do not show up in line
but instead at page bottom
''and cause the page to be listed in the category.''
[[Category:English documentation]]

Add an extra colon to ''link'' to a category in line
without causing the page to be listed in the category:
[[:Category:English documentation]]
</pre>
|-
|
The Wiki reformats linked dates to match the reader's
date preferences. These three dates will show up the
same if you choose a format in your
[[Special:Preferences|Preferences]]:
* [[1969-07-20]]
* [[July 20]], [[1969]]
* [[20 July]] [[1969]]
|<pre>
The Wiki reformats linked dates to match the reader's
date preferences. These three dates will show up the
same if you choose a format in your
[[Special:Preferences|]]:
* [[1969-07-20]]
* [[July 20]], [[1969]]
* [[20 July]] [[1969]]
</pre>
|}

==Just show what I typed==

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

{| border="1" cellpadding="2"
!width="1000"|What it looks like
!width="500"|What you type
|-
|
<nowiki>
The nowiki tag ignores
[[Wiki]] ''markup''.
It reformats text by
removing
newlines and multiple
spaces.
It still interprets special
characters: →
</nowiki>
|<pre>
<nowiki>
The nowiki tag ignores
[[Wiki]] ''markup''.
It reformats text by
removing
newlines and multiple
spaces.
It still interprets special
characters: &rarr;
</nowiki>
</pre>
|-
|
<pre>
The pre tag ignores [[Wiki]]
''markup''.
It also doesn't reformat
text.
It still interprets special
characters: →
</pre>
|<pre>
<pre>
The pre tag ignores [[Wiki]]
''markup''.
It also doesn't reformat
text.
It still interprets special
characters: &rarr;
</pre>
</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: →
|<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: &rarr;
</pre>
|}

===Source code===
{{main|mw:Extension:SyntaxHighlight GeSHi}}
If the syntax highlighting extension is installed, you can display programming language [[w:source code|source code]] in a manner very similar to the HTML <code><nowiki><pre></nowiki></code> tag, except with the type of [[w:syntax highlighting|syntax highlighting]] commonly found in advanced text editing software.

Here's an example of how to display some [[w:C Sharp (programming language)|C#]] source code:

<pre><nowiki>
<source lang="csharp">
// Hello World in Microsoft C# ("C-Sharp").

using System;

class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</source>
</nowiki></pre>

Results in:

<source lang="csharp">
// Hello World in Microsoft C# ("C-Sharp").

using System;

class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</source>

==Images, tables, video, and sounds==
This is a very quick introduction. For more information, see:
* [[Help:Images and other uploaded files]], for how to upload files;
* [[w:en:Wikipedia:Extended image syntax]], for how to arrange images on the page;
* [[Help:Table]], for how to create a table.

After uploading, just enter the filename, highlight it and press the "embedded image"-button of the edit_toolbar.

This will produce the syntax for uploading a file '''<nowiki>[[Image:filename.png]]</nowiki>'''

{| border="1" cellpadding="2"
!width="1000"|What it looks like
!width="500"|What you type
|-
|
A picture, including alternate text:

[[Image:Wiki.png|This is Wiki's logo]]

You can put the image in a frame with a caption:
[[Image:Wiki.png|frame|This is Wiki's logo]]
|<pre>
A picture, including alternate text:

[[Image:Wiki.png|This is Wiki's logo]]

You can put the image in a frame with a caption:
[[Image:Wiki.png|frame|This is Wiki's logo]]
</pre>
|-
|
A link to Wikipedia's page for the image:
[[:Image:Wiki.png]]

Or a link directly to the image itself:
[[Media:Wiki.png]]
|<pre>
A link to Wikipedia's page for the image:
[[:Image:Wiki.png]]

Or a link directly to the image itself:
[[Media:Wiki.png]]
</pre>
|-
|Use '''media:''' links to link
directly to sounds or videos:
[[media:Classical guitar scale.ogg|A sound file]]
|<pre>
Use '''media:''' links to link
directly to sounds or videos:
[[media:Classical guitar scale.ogg|A sound file]]
</pre>
|-
|Provide a spoken rendition of some text in a template:
{{listen
|title = Flow my tears
|filename = Flow my tears.ogg
|filesize = 583KB
}}
|<pre>
Provide a spoken rendition of some text in a template:
{{listen
|title = Flow my tears
|filename = Flow my tears.ogg
|filesize = 583KB
}}
</pre>
|-
|
{| border="1" cellspacing="0" cellpadding="5" align="center"
! This
! is
|-
| a
| table
|}
|<pre>
{| border="1" cellspacing="0" cellpadding="5" align="center"
! This
! is
|-
| a
| table
|}
</pre>
|}

===Galleries===
:''Main article: [[wikipediawikipedia:Gallery tag|w:Gallery tag]]''

Images can also be grouped into galleries using the <code><nowiki><gallery></nowiki></code> tag, such as the following:

<gallery>
Image:Wiki.png
Image:Wiki.png|Captioned
Image:Wiki.png
Image:Wiki.png|[[Wikipedia|Links]] can be put in captions.
</gallery>

== Mathematical formulae ==
{{main|Help:Displaying a formula}}
You can format mathematical formulae with [[w:TeX|TeX]] markup.

{| border="1" cellpadding="2"
!width="1000"|What it looks like
!width="500"|What you type
|-
|
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
|<pre><nowiki>
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
</nowiki></pre>
|}

==Templates==
{{main|Help:Template}}
Templates are segments of Wiki markup that are meant to be copied automatically ("transcluded") into a page.
You add them by putting the template's name in <nowiki>{{double braces}}</nowiki>. It is also possible to transclude other pages by using <nowiki>{{:colon and double braces}}</nowiki>.

Some templates take ''parameters'', as well, which you separate with the pipe character.

{| border="1" cellpadding="2"
!width="1000"|What it looks like
!width="500"|What you type
|-
|
{{Transclusion demo}}
|<pre>
{{Transclusion demo}}
</pre>
|-
|
{{Help:Transclusion Demo}}
|<pre>
{{Help:Transclusion Demo}}
</pre>
|-
|

This template takes two parameters, and
creates underlined text with a hover box
for many modern browsers supporting CSS:

{{H:title|This is the hover text|
Hover your mouse over this text}}

Go to this page to see the H:title template
itself: {{tl|H:title}}

|<pre>
This template takes two parameters, and
creates underlined text with a hover box
for many modern browsers supporting CSS:

{{H:title|This is the hover text|
Hover your mouse over this text}}

Go to this page to see the H:title template
itself: {{tl|H:title}}
</pre>
|}

[[Category:Editor handbook]]
{{h:f|enname=Wikitext examples}}

Help:Wikitext Examples - Revision history

Ibjadmin: /* Organizing your writing */

Ibjadmin: /* Templates */

Ibjadmin: /* Mathematical formulae */

Ibjadmin: moved Wikitext Examples to Help:Wikitext Examples

Ibjadmin: /* Basic text formatting */

Ibjadmin: Created page with '== Basic text formatting == You can format the page using Wikitext special characters. {|width="80%" border="1" cellpadding="2" cellspacing="0" |- !What it looks like !What you�'