Edit detail for browsing revision 8 of 8

1 2 3 4 5 6 7 8
Editor: simon
Time: 2009/05/28 11:49:29 GMT-7
Note:

removed:
- <dtml-comment>
- Wiki pages are "smart" web pages which can link to each other easily.
- </dtml-comment>

removed:
- <dtml-comment>
- Pages link to each other by including each other's names in their text.
- </dtml-comment>

Organization of a wiki

Every page in a wiki has a single unique name which appears at the top. All the pages of a wiki are kept in a single folder. (Also, Zwiki organizes pages semi-automatically into a hierarchy, which you'll read about soon.)

Zwiki user interface

Zwiki sites look different depending on how they are installed and whether their "skin" (user interface) has been customized. There are basically three kinds of zwiki site you'll see:

  • Standard zwiki sites look like much like this one.
  • Zwiki sites inside Plone look like http://plone.demo.zwiki.org , usually.
  • Zwikis whose "skin" (user interface) has been heavily customized may look like anything at all.

In this guide we'll assume you are using this site, with its up-to-date standard skin. Zwiki in Plone works much the same way; we'll tell you about differences as we go. Here are the elements of the normal zwiki page view:

  • page name -- At the top is the name of the page you're looking at. When you click this, you'll see a list of any other pages which link to this one (backlinks). Note the page url may be the same as this or slightly different.
  • page controls -- Aside from the display mode links, the links at top right affect the current page. We'll learn more about these later.
  • search box -- Enter some text here and press enter to search all pages in the wiki.
  • last edited information -- This tells you when the page was last edited, and by whom.
  • rating stars -- When you can see and click these, you are invited to rate pages in the wiki. But first, configure a username (in options, described below), otherwise your vote can be changed by the next anonymous visitor. You get one vote per page, which you can change at any time. Hold the mouse over the stars to see useful information.
  • home -- This will return you to the wiki's front page, which is the starting point leading to all the others.
  • contents -- This shows the entire page hierarchy - the wiki's table of contents. You'll read more about this later.
  • changes -- This shows the wiki's recent changes - a list of pages that have changed recently.
  • discussion -- If this link is visible, it will take you to this wiki's main page for discussion.
  • issues -- If this link is visible, it will take you to this wiki's issue (bug) pages. You'll read more about this later.
  • index -- If this link is visible, it will show an alphabetic index of all pages.
  • options -- Here you can set some preferences for this wiki, such as a username. You'll need to have cookies enabled in your web browser.
  • help -- This usually leads to a page of help for the wiki.

Below these, you'll see:

  • the site logo -- This helps to identify the wiki you are in. It works like the home link when clicked.
  • page context -- As well as the name of current page, you'll see the names of any page above it in the page hierarchy. This helps you know where you are within the page hierarchy (the wiki's table of contents). You can click these to navigate up in the hierarchy.

Try it out

Try these things to see how all this works in practice.

  1. Click changes. Try the buttons and see what they do. What has been going on in this wiki recently ?
  2. Click contents. Get a rough idea of what's in this wiki. Using your browser's "find in page" feature, see if you can find the test page you made earlier. (Note in a large wiki like this one, contents may take a little while to finish loading, and then it will jump to the position of the current page.)
  3. Search for some words. How many occurrences of "raspberries" are there in this wiki ?
  4. Read about access keys. These are keyboard shortcuts which allow you to navigate any zwiki site very quickly. Find out how to use these in your web browser.
  5. Click options and give yourself a username and set your timezone. Then try changes again; the times should be more useful now.
  6. Now rate some pages. Rating is the easiest and quickest way to contribute to a wiki. It is a good practice, because it helps other visitors know which pages are worth reading, and it encourages authors to write good content.

Recap

After the above, you should now feel comfortable reading and rating pages, getting an overview, and finding information in any zwiki site.

When you're ready for more, let's find out how to do some editing.