20-Minute Wiki Tutorial
This step-by-step, hands-on tutorial gets you up to speed with all the basics, in mere minutes
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...
This WikiSite is divided into webs; each one usually represents one area of collaboration. You can navigate the webs from the upper right corner of each web page.
- Each web has hyperlinked topics, displayed as pages in your browser.
- The home page in each web is the WebHome topic.
- To browse a Wiki web, just click on any highlighted link. These links are called WikiWords and comprise two or more words with initial capitals, run together.
- Follow the WikiWord link and learn what it is.
- If you know the name of a topic, you can jump directly to it by typing its name into the Go field on the top of the page. Type
WebSearch to jump to the search page. Hint: Do not confuse the Go field with search.
- You can search each Wiki web. Enter a search string in the WebHome topic or the WebSearch topic accessible from the
Search link on each topic. Wiki searches for an exact match; optionally, you can also use RegularExpressions.
3. Login with your LutherNet account
To edit topics, you need to login with your LutherNet account.
5. Test the page controls...
The color-coded control strips at the top and/or bottom of the page has a collection of action links. Different skins show different links, but most will have some or all of::
Edit - add to or edit the topic (discussed later)
Raw View - show the source text without editing the topic
Attach - attach files to a topic (discussed later)
Backlinks - find out what other topics link to this topic (reverse link)
Printable - goes to a stripped down version of the page, good for printing
History - topics are under revision control -
History shows you the complete change history of the topic, for example, who changed what and when
r3 > r2 > r1 - view a previous version of the topic or the difference between two versions
More - additional controls, such as rename/move, version control and setting the topic's parent.
6. Change a page, and create a new one...
Go to the Sandbox. This is the sandbox web, where you can make changes and try it all out at will.
- Click the
Edit link. You are now in edit mode and you can see the source of the page. (Go to a different topic like WikiGuestSandbox? if you see a "Topic is being edited by an other user" warning.)
- Look at the text in edit mode and compare it with the rendered page (move back and forth in your browser.)
- Tip: When you only want to see the source code of a topic click the
Raw View link.
- Notice how WikiWords are linked automatically; there is no link if you look at the text in edit mode.
- Now, create a new topic - your own test page:
- In edit mode, enter a new text with a WikiWord, for example:
This is WikiGuestSandbox topic.
- Preview and save the topic. The name appears, highlighted, with a linked question mark at the end. This means that the topic doesn't exist yet.
- Click on the question mark. Now you're in edit mode of the new topic.
- Type some text, basically, like you write an e-mail.
- A signature with your name is already entered by default. NOTE: The
%MAINWEB%. in front of your name means that you have a link from the current web to your personal topic located in the %MAINWEB% web.
- Preview and save the topic...
- Learn about text formatting. You can enter text in WikiSyntax, a very simple markup language. Follow the WikiSyntax link to see how, then:
- Go back to your sandbox topic end edit it.
- Enter some text in WikiSyntax: bold text, italic text, bold italic text, a bullet list, tables, paragraphs, etc. Hint: If you need help, click on the TextFormattingRules link located below the text box in edit mode.
- Preview and save the topic.
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.
- Attaching files is just like including a file with an e-mail.
- Go back to your sandbox topic and click on the
[Attach] link at the bottom.
[Browse] to find a file on your PC that you'd like to attach; enter an optional comment; leave everything else unchecked.
[Upload file], then scroll to the end of the page to see the new attachment listing.
- Do this again - this time, upload a GIF, JPG or PNG image file.
- Check the
[Link:] box to Create a link to the attached file at the end of the topic. The image will show up at the bottom of the topic.
- To move the image, edit the topic and place the last line (containing
%ATTACHURL%) anywhere on the page.
- Any uploaded files are not protected by the same permissions as the wiki pages This is a problem we are working on.
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 Wiki web. This is a convenience service - for many people, checking e-mail is easier than checking the Web.
- If you're using Wiki to collaborate on a project, it's important to know when anyone on your team posts an update. If you're following a specific discussion, it's convenient to know when there's new input.
- Alerts are e-mailed as links to individual topics that've been changed in a set period: each day, every hour, whatever is configured for your system.
- It's strongly recommended that you try out the service by subscribing to each Wiki web that's relevant to you. You can subscribe and unsubscribe instantly, on a per web basis using WebNotify.
That's it! You're now equipped with all the Wiki essentials. You are ready to roll.
When first using Wiki, 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 copy-and-paste from them if you want to undo any changes. After a short while, Wiki-style free-form communication becomes second-nature. You'll expect it everywhere!