Simple user guide for beginners

Doing stuff

Editing

  1. Find the page you want to change.
  2. Hit the edit button on the top right of the page or click the red underlined 'edit' link at the very bottom left of the page. This takes you into the edit screen.
  3. Start making your changes, keeping in mind the page formatting and editing recommendations found at TaxonomyWikiGuidelines#General_page_structure
  4. With TWiki, the default option is to edit in the WYSIWG (= What You See is What you Get) mode. This is easy after you get the hang of the idea that a Wiki is NOT meant to be a really cool text editor with all formatting bells and whistles you have in your favourite word processing package. The WYSIWG editor has its little ways but is generally fun.
  5. If something is not working the way you think it should, try looking at it in TWiki markup mode i.e. hit the little pick-tool icon on the right hand of the bottom row on the editing toolbar and have a look at the place which is giving you pain. You might see that you've put in a paragraph tag or something else which is interfering with your formatting. Once you get the hang of TWiki markup script, it can be faster to write your text in this mode than in WYSIWYG mode.
  6. Spellchecking is only available in the "Raw Edit" mode (click the pick-tool). It also requires the firefox browser.

  1. If you make a mistake in a link you can lose all of the edits you've done since the last save. To avoid frustration, it is best to save, make the link and save again to see if it works.
  2. You can put in a link by putting in the entire URL inside nested square brackets i.e. http://taxonomy.org.au/twiki/bin/view/Main/WebHome. If you don't use the nested square brackets, mostly the link works, but sometimes it doesn't, which can lead to Wiki-rage (see point 1 above).
  3. You can define a link to a page in the Wiki by specifying it, again inside double nested square brackets, with the web name e.g. Main, or Hubris followed by a dot "." and then the name of the required page e.g. Ants.ActiveTopics? .
  4. If you've got a table of contents, you can also include the heading as shown in the link in Point 3 in the Editing section above i.e. with a '#' character between the page name and the first n characters of the heading - best to copy this straight off the Address banner in your browser so you get the right n characters.
  5. Note that if your link is to a page in the same web, i.e. you are working in the Ants web and you want to link to a page also in the Ants web, you can omit the "Ants." prefix e.g. ActiveTopics?.
  6. The convention we prefer is NOT to include any blanks in link names. For example, we prefer you to use Ants.ActiveTopics? rather than Ants.Active Topics?.
  7. To have the link become part of the text, type: Text you wish to see? e.g. Learn how to start working with the Wiki, which will then appear like this: Learn how to start working with the Wiki

-- BernardPfeil - 17 Oct 2008