Wiki Editing Tutorial

Aus AngWiki
Wechseln zu: Navigation, Suche

This tutorial will discuss the basic elements of creating a new wiki


Editing

The most basic wiki feature is the "bearbeiten" - link at the top of the page which allows you to edit the site you are looking at. As you know, sites like these (where anyone can edit anything or change already existing contents) are known as wikis - if you don't know yet, read Wikis im Fremdsprachenlernen & Interkulturellen Lernen to learn the basics about wikis and some of their advantages for the language classroom.

As already mentioned the "bearbeiten" - link is your best friend when working with wikis: By clicking "bearbeiten" you can see the wiki code for the page you are currently looking at; i.e. you can see the text of the site just as the editor has written it down. You'll quickly recognise that the wiki code is different from the text that becomes visible in the wiki afterward; e.g. there are apostrophes, brackets or various punctuation marks. These signs might appear strange to you but all of them are necessary and they fulfil a function in the wiki. To cut a long story short: If you want to edit a wiki you have to learn the code.

Formatting

Formatting a wiki is a bit different from writing on a standard word processor; i.e. the text you type differs from the text that appears in the wiki afterwards. To create particular elements of a wiki, e.g. italics or bold letters, you have to keep with the rules of formatting:


Bold and Italics

What you type What you get Explanation
''italic'' italic Italicising is done by surrounding a word or phrase with two apostrophes.

'''bold'''

bold

Bolding is done by surrounding a word or phrase with three apostrophes.

'''''bold italic'''''

bold italic

bold-italicising is done by surrounding a word or phrase with five apostrophes

Headings and Subheadings

If your entry consists of at least two distinct topics, it makes sense to insert headings and subheadings; which is an easy way to structure and provide clarity. If an article consists of four headings or more, a table of contents will automatically be generated.


What you type What you get Explanation
==heading== a heading Headings are done by surrounding all the words that are supposed

to appear in the heading with two equal signs

===subheading===

a subheading

Subheadings are done by surrounding all the words that are supposed

to appear in the heading with three equal signs

Enumerating and Listing

Hashes create enumerations

What you type What you get Explanation
#Monday 1. Monday Hashes in front of a word or a phrase create enumerations,

#Tuesday

2. Tuesday if your list consists of more than two elements.
#Wednesday 3. Wednesday


Stars create lists

What you type What you get Explanation
*Monday

*Tuesday

*Wednesday

  • Monday
  • Tuesday
  • Wednesday

A star in front of a word or a phrase creates a list,

if your list consists of more than two elements

Tables

As working with tables in wiki can be slightly confusing, I created a template that can be used for any other table in wiki. Just copy the source text and substitute the existing contents with your personal texts!


HEADLINE 1 HEADLINE 2 HEADLINE 3
1st row, 1st column 1st row, 2nd column 1st row, 3rd column
2nd row,1st column 2nd row,2nd column 2nd row,3rd column
3rd row,1st column 3rd row,2nd column 3rd row,3rd column

External Links

You have different options if you want to link to websites outside your wiki:

What you write What you get Explanation
"Every accomplishment starts with the decision to try [http://www.englishweb.de]" "Every accomplishment starts with the decision to try" [1] Enclosing the full URL with a square bracket, will display the link as a number in brackets. This way of linking is mostly used for citing within the article, looking like a footnote.
Germany's best fulball club is [http://www.schalke04.de/ Schalke 04] Germany's best fulball club is Schalke 04. Enclosing the full URL and a word/phrase (separated by a space) with a square bracket, will display the word/name/phrase as a link.
The page http://www.google.de is a search engine. The page http://www.google.de is a search engine. The simplest way to link is to type in the full URL of the site you want to refer to.


!IMPORTANT! Always include the http://

Internal Links

Linking different articles (called wiki-links) is one of the most important aspects of working with wikis: Each article can be linked to other articles, and thus form a network of non-linear hypertext.

What you type What you get Explanation
For further information read [[Wikis im Fremdsprachenlernen & Interkulturellen Lernen]]! For further information read Wikis im Fremdsprachenlernen & Interkulturellen Lernen! Enclosing a word or phrase with two square brackets, will display the whole word or phrase as a link. The link will be displayed in blue colour in case there already exists an article the link refers to;
[[Schalke 04]] is Germany's best football club. Schalke 04 is Germany's best football club. it will be displayed in red in case there is no entry, yet.

For Further Reading

For more detailed information read the help pages offered on Wikipedia, the free encyclopaedia.



Another good advice to get used to wiki language is to visit Wikipedia, arbitrarily select an article, click the view source button and do exactly that: View the source of the article; i.e. have a look at the text the author edited. Then compare to what extent the source text differs from the wiki text.