Difference between revisions of "Main Page"

From Otago Wiki
Jump to: navigation, search
 
Line 1: Line 1:
<big>'''MediaWiki has been successfully installed.'''</big>
+
<big>'''Welcome to the University of Otago Wiki Service'''</big>
  
 
Consult the [http://meta.wikimedia.org/wiki/Help:Contents User's Guide] for information on using the wiki software.
 
Consult the [http://meta.wikimedia.org/wiki/Help:Contents User's Guide] for information on using the wiki software.
Line 8: Line 8:
 
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
 
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
 
* [http://mail.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
 
* [http://mail.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
 +
 +
= How to get a wiki on the Otago Wiki Service =
 +
 +
Information on how to get a wiki, including a link to the application form
 +
 +
= Quick Start Guide =
 +
 +
== Starting a new page ==
 +
 +
=== Using Wikilinks ===
 +
MediaWiki makes it very easy to link wiki pages together using a standard syntax.
 +
 +
<code><nowiki>[[PageName|Link text]]</nowiki></code>creates a link to a page called PageName, with the clickble text <span style="color: #ba0000">Link Text</span>.
 +
 +
If you (or anyone else) creates a link to an article that doesn't exist yet, the link will be coloured red, <span style="color: #ba0000">like this</span>.
 +
 +
Clicking a red link, will take you to the edit page for the new article.  Simply type your text, click save and the new page will be created.
 +
 +
Once the page has been created, the link will change from <span style="color: #ba0000">red</span> to <span style="color: #002bb8;">blue</span> (<span style="color: #5a3696;">purple</span> for pages you've visited) indicating that the article now exists.
 +
 +
==Using the URL==
 +
You can use the wiki's URL for creating a new page. The URL to an article of the wiki is usually something like this:
 +
*<code><nowiki>http://www.my-wiki.org/index.php/</nowiki>'''ARTICLE'''</code> &nbsp;&nbsp; or
 +
*<code><nowiki>http://www.my-wiki.org/wiki/</nowiki>'''ARTICLE'''</code>
 +
 +
If you replace <code>'''ARTICLE'''</code> with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet.  Clicking the "''edit''" link at the top of the page will take you to the edit page for that article, where you can create the new page by typing your text, and clicking submit.
 +
 +
==Formatting Text==
 +
 +
You can format your text using wiki markup. This consists of normal characters like asterisks, single quotes or equation marks which have a special function in the wiki, sometimes depending on their position. For example, to format a word in ''italic'', you include it in two single quotes like <tt><nowiki>''this''</nowiki></tt>
 +
 +
===Paragraphs===
 +
 +
Mediawiki ignores normal line breaks. To start a new paragraph, leave an empty line. You can also start a newline with the HTML tag <tt><nowiki><br/></nowiki></tt>. 
 +
 +
===HTML===
 +
 +
Some HTML-Tags are allowed in MediaWiki, for example <tt><nowiki><code></nowiki></tt>, <tt><nowiki><div></nowiki></tt>, <tt><nowiki><span></nowiki></tt> and <tt><nowiki><font></nowiki></tt>.
 +
 +
{| class="border"
 +
|-
 +
|&nbsp;|'''Description'''
 +
|&nbsp;|'''You type'''
 +
|&nbsp;|'''You get'''
 +
|-
 +
| colspan="3" align="center" | ''applies anywhere''
 +
|-
 +
|Italic text
 +
|<tt><nowiki>''italic''</nowiki></tt>
 +
|''italic''
 +
|-
 +
| Bold text
 +
|<tt><nowiki>'''bold'''</nowiki></tt>
 +
|'''bold'''
 +
|-
 +
| Bold and italic
 +
|<tt><nowiki>'''''bold & italic'''''</nowiki></tt>
 +
|'''''bold & italic'''''
 +
|-
 +
|Escape wiki markup
 +
|<tt><nowiki><nowiki>no ''markup''</nowiki></nowiki></tt>
 +
|<nowiki>no ''markup''</nowiki>
 +
|-
 +
| colspan="3" align="center" | ''only at the beginning of the line''
 +
|-
 +
|Headings of different sizes
 +
|
 +
<tt><nowiki>=level 1=</nowiki></tt><br />
 +
<tt><nowiki>==level 2==</nowiki></tt><br />
 +
<tt><nowiki>===level 3===</nowiki></tt><br />
 +
|
 +
=Level 1=
 +
==Level 2==
 +
===Level 3===
 +
|-
 +
|Horizontal rule
 +
|
 +
<tt><nowiki>----</nowiki></tt>
 +
|
 +
----
 +
|-
 +
|Bullet list
 +
|
 +
&#42; one<br>
 +
&#42; two<br>
 +
&#42; three<br>
 +
|
 +
* one
 +
* two
 +
* three
 +
|-
 +
|Numbered list
 +
|
 +
&#35; one<br>
 +
&#35; two<br>
 +
&#35; three<br>
 +
|
 +
# one
 +
# two
 +
# three
 +
|-
 +
|Definition list
 +
|
 +
&#59;Definition<br>
 +
&#58;item 1<br>
 +
&#58;item 2<br>
 +
|
 +
;Definition
 +
:item 1
 +
:item 2
 +
|-
 +
|Preformatted text
 +
|
 +
&nbsp;&nbsp;a space at the<br>
 +
&nbsp;&nbsp;beginning of the line<br>
 +
&nbsp;&nbsp;creates<br>
 +
&nbsp;&nbsp;preformatted text
 +
|
 +
a space at the
 +
beginning of the line
 +
creates
 +
preformatted text
 +
|}
 +
 +
==Links==
 +
 +
To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already, it is displayed in blue, empty pages are displayed in red. Selflinks to the current page are not transformed in URLs but displayed in bold.
 +
 +
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).
 +
 +
{| class="border"
 +
|-
 +
|&nbsp;|'''Description'''
 +
|&nbsp;|'''You type'''
 +
|&nbsp;|'''You get'''
 +
|-
 +
|Internal link
 +
|<tt><nowiki>[[Page]]</nowiki></tt>
 +
|[[Page]]
 +
|-
 +
|Piped link
 +
|<tt><nowiki>[[Page|different text]]</nowiki></tt>
 +
|[[Page|different text]]
 +
|-
 +
|External link
 +
|<tt><nowiki>http://mediawiki.org</nowiki></tt>
 +
|http://mediawiki.org
 +
|-
 +
|External link,<br />
 +
different title
 +
|<tt><nowiki>[http://mediawiki.org MediaWiki]</nowiki></tt>
 +
|[http://mediawiki.org MediaWiki]
 +
|-
 +
|External link,<br />
 +
unnamed
 +
|<tt><nowiki>[http://mediawiki.org]</nowiki></tt>
 +
|[http://mediawiki.org]
 +
|}
 +
 +
==Adding images==
 +
===Uploading files===
 +
First upload images,then include the code to them on your page.  The username and password for the wiki are stored in the ususal place.
 +
 +
===Using Images===
 +
 +
To use an image or other file which has been [[Special:Upload|uploaded to the wiki]], use:
 +
*<code><nowiki>[[Image:piglet.jpg]]</nowiki></code>
 +
If you add a pipe (|) and some text after the filename, the text will be used as alternative text for text-only browsers:
 +
*<code><nowiki>[[Image:piglet.jpg|Picture of a piglet]]</nowiki></code>
 +
 +
If you don't want to display the image, you can link to the file's description page, by adding a colon:
 +
*<code><nowiki>[[:Image:piglet.jpg]]</nowiki></code>
 +
To bypass the description page and link directly to a file , use the "Media" pseudo-namespace:
 +
*<code><nowiki>[[Media:piglet.jpg]]</nowiki></code>
 +
You can also make piped links if you want some other text to be used:
 +
*<code><nowiki>[[:Image:piglet.jpg|link text]]</nowiki></code>
 +
*<code><nowiki>[[Media:piglet.jpg|link text]]</nowiki></code>
 +
 +
===Examples===
 +
 +
{| class="border"
 +
|-
 +
|&nbsp;|'''Description'''
 +
|&nbsp;|'''You type'''
 +
|&nbsp;|'''You get'''
 +
|-
 +
|Embed image<br /> (with alt text)
 +
|
 +
<code><nowiki>[[Image:piglet.jpg|Piglet!]]</nowiki></code>
 +
|
 +
[[Image:piglet.jpg|Piglet!]]
 +
 +
 +
|-
 +
|Link to description page
 +
|
 +
<code><nowiki>[[:Image:piglet.jpg]]</nowiki></code><br />
 +
<code><nowiki>[[:piglet.jpg|Piglet!]]</nowiki></code>
 +
|
 +
[[:Image:piglet.jpg]]<br />
 +
[[:Image:piglet.jpg]]
 +
|-
 +
|Link directly to file
 +
|
 +
<code><nowiki>[[Media:piglet.jpg]]</nowiki></code><br />
 +
<code><nowiki>[[piglet.jpg|Piglet!]]</nowiki></code>
 +
|
 +
[[Media:piglet.jpg]]<br />
 +
[[Media:piglet.jpg|Piglet!]]
 +
|-
 +
|Thumbnail<br /> (centered, 50 pixels<br /> wide, with caption)
 +
|
 +
<code><nowiki>[[Image:piglet.jpg|center|thumb|50px|Ain't piglet cute!]]</nowiki></code>
 +
|
 +
[[Image:piglet.jpg|center|thumb|50px|Ain't piglet cute!]]
 +
|}

Revision as of 08:27, 5 October 2006

Welcome to the University of Otago Wiki Service

Consult the User's Guide for information on using the wiki software.

Contents

Getting started

How to get a wiki on the Otago Wiki Service

Information on how to get a wiki, including a link to the application form

Quick Start Guide

Starting a new page

Using Wikilinks

MediaWiki makes it very easy to link wiki pages together using a standard syntax.

[[PageName|Link text]]creates a link to a page called PageName, with the clickble text Link Text.

If you (or anyone else) creates a link to an article that doesn't exist yet, the link will be coloured red, like this.

Clicking a red link, will take you to the edit page for the new article. Simply type your text, click save and the new page will be created.

Once the page has been created, the link will change from red to blue (purple for pages you've visited) indicating that the article now exists.

Using the URL

You can use the wiki's URL for creating a new page. The URL to an article of the wiki is usually something like this:

  • http://www.my-wiki.org/index.php/ARTICLE    or
  • http://www.my-wiki.org/wiki/ARTICLE

If you replace ARTICLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. Clicking the "edit" link at the top of the page will take you to the edit page for that article, where you can create the new page by typing your text, and clicking submit.

Formatting Text

You can format your text using wiki markup. This consists of normal characters like asterisks, single quotes or equation marks which have a special function in the wiki, sometimes depending on their position. For example, to format a word in italic, you include it in two single quotes like ''this''

Paragraphs

Mediawiki ignores normal line breaks. To start a new paragraph, leave an empty line. You can also start a newline with the HTML tag <br/>.

HTML

Some HTML-Tags are allowed in MediaWiki, for example <code>, <div>, <span> and <font>.

Description You type You get
applies anywhere
Italic text ''italic'' italic
Bold text '''bold''' bold
Bold and italic '''''bold & italic''''' bold & italic
Escape wiki markup <nowiki>no ''markup''</nowiki> no ''markup''
only at the beginning of the line
Headings of different sizes

=level 1=
==level 2==
===level 3===

Level 1

Level 2

Level 3

Horizontal rule

----


Bullet list

* one
* two
* three

  • one
  • two
  • three
Numbered list

# one
# two
# three

  1. one
  2. two
  3. three
Definition list

;Definition
:item 1
:item 2

Definition
item 1
item 2
Preformatted text

  a space at the
  beginning of the line
  creates
  preformatted text

a space at the 
beginning of the line
creates 
preformatted text

Links

To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already, it is displayed in blue, empty pages are displayed in red. Selflinks to the current page are not transformed in URLs but displayed in bold.

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

Description You type You get
Internal link [[Page]] Page
Piped link [[Page|different text]] different text
External link http://mediawiki.org http://mediawiki.org
External link,

different title

[http://mediawiki.org MediaWiki] MediaWiki
External link,

unnamed

[http://mediawiki.org] [1]

Adding images

Uploading files

First upload images,then include the code to them on your page. The username and password for the wiki are stored in the ususal place.

Using Images

To use an image or other file which has been uploaded to the wiki, use:

  • [[Image:piglet.jpg]]

If you add a pipe (|) and some text after the filename, the text will be used as alternative text for text-only browsers:

  • [[Image:piglet.jpg|Picture of a piglet]]

If you don't want to display the image, you can link to the file's description page, by adding a colon:

  • [[:Image:piglet.jpg]]

To bypass the description page and link directly to a file , use the "Media" pseudo-namespace:

  • [[Media:piglet.jpg]]

You can also make piped links if you want some other text to be used:

  • [[:Image:piglet.jpg|link text]]
  • [[Media:piglet.jpg|link text]]

Examples

Description You type You get
Embed image
(with alt text)

[[Image:piglet.jpg|Piglet!]]

Piglet!


Link to description page

[[:Image:piglet.jpg]]
[[:piglet.jpg|Piglet!]]

Image:piglet.jpg
Image:piglet.jpg

Link directly to file

[[Media:piglet.jpg]]
[[piglet.jpg|Piglet!]]

Media:piglet.jpg
Piglet!

Thumbnail
(centered, 50 pixels
wide, with caption)

[[Image:piglet.jpg|center|thumb|50px|Ain't piglet cute!]]

File:Piglet.jpg
Ain't piglet cute!