20 Minute Tutorial

This step-by-step, hands-on tutorial gets you up to speed with all the Foswiki basics...

On this page:

1. Get set...

Open two browser windows, so that you can follow these steps in one window while trying things out in the other.

2. Take a quick tour...

A Foswiki site is divided into areas called webs. Usually webs represent one area of collaboration. Most Foswiki sites have links to the available webs on every page, in the lower part of the menu on the left hand side.

TIP Do not confuse the Jump field with the Search field.

3. Open a private account...

To edit topics, you need to have a Foswiki account.

4. Check out Foswiki users and groups.

5. Test the page controls...

The control strips at the top and/or bottom of the page have a collection of icons or links that allow you to take various actions. Different skins show different links, but most will have some or all of the following:

6. Create a new topic and edit an existing one

There are two different ways to create a new topic:
  1. Create a topic from scratch.
  2. Navigate to a topic that does not yet exist.

6.1 Create a topic from scratch

We are going to create a new topic from scratch first, before having a look at the second alternative:

Topic name:

Editing an existing topic is even more simple:

Now we will proceed to the second option of creating a topic - following a link that refers to a topic that does not exist yet:

There are different ways of formatting text:
  1. Using the WYSIWYG editor - highlight and format text as you would do it in a normal text editor
  2. Using TopicMarkupLanguage - TML (Topic Markup Language) is a very simple markup language.

7. Use your browser to upload files as page attachments...

You can attach any type of file to a topic - documents, images, programs, whatever - where they can be opened, viewed, or downloaded.
ALERT! Your site administrator may have blocked some types of files (such as .html) from being attached for security reasons.

8. Get e-mail alerts whenever pages are changed...

WebNotify is a subscription service that automatically notifies you by e-mail when topics change in a Foswiki web. This is a convenience service - for many people, checking e-mail is easier than checking the Web.

That's it! You're now equipped with all the Foswiki essentials. You are ready to roll.

HELP When first using Foswiki, it will probably seem strange to be able to change other people's postings - we're used to separating individual messages, with e-mail, message boards, non-Wiki collaboration platforms. Don't worry about it. You can't accidentally delete important stuff - you can always check previous versions, and restore them, if necessary, if you want to undo any changes. After a short while, it'll become second-nature and you'll expect it everywhere!

Related Topics: UserDocumentationCategory, TopicsAndWebs, TopicMarkupLanguage