How To Wiki Wiki

How To Wiki Wiki (Last Edit: Aug 26 2005 14:07:19)

(Note: this page duplicates the material on the GoodStyle page; if a generous soul would refactor it would help)

First some etiquette. The following sites have some excellent rules to keep bad behaviour away:

Now the fun stuff!

A wiki is a collaborative tool

The general flow of how information gets on a page goes something like this:

I write some ideas onto a wiki page

You read the page and annotate it with your ideas and comments

I read your comments and change my original ideas

You realize that a section of the discussion should be on a new page. You create a new Wiki page and move the content to the new page

Someone else realizes that yet another page has related content. They create a link to the page.

and so on...

All of the above actions are very easy to do. The web pages eventually self-organize into an informative and flexible web of ideas. ---- Here's a short tutorial for using wiki:

Create a page

click on the edit button at the top of the page
you should see a page titled Editing HowToWikiWiki
jump to the end and type in YourName that is, a left square bracket, your capitalized first name, (no space!) your capitalized last name, a right square bracket.
click the Save button.
You should see your highlighted name with a question mark ? behind it

Follow a link

click on the question mark behind your name. You should see another edit form title Editing YourName?
type something about yourself.
click the Change YourName? button.
You should see the text you typed in a page called YourName??

That's it! You've created a page for all the world to see and have done in it just a few seconds. Wiki's are very simple to use but usually have some advanced formatting capabilities:

Make a list

edit your new page
on a new line, indent from the left margin three spaces
type an * asterisk
type some text after the asterisk
save your changes

You should see a bulleted list of one item edit your page again and add more lines with asterisks (don't forget the leading spaces) save your changes You should see all of your new items in a nicely formatted bulleted list

To have a nested list, indent another three spaces (six in all) and then the asterisk

Make an ordered list

follow the same procedure as you did for lists above, except use a 1 (one) instead of an asterisk
You should see your new items nicely formatted with consequtive numbers in front of them (i.e. like this list)

The
1. ordered
2. lists
  1. eventually
  2. repeat
    1. the kind
    2. of numbering
      1. they do.
      2. You can
        
        mix
        and match
ordered and unordered lists

emPhaSis

edit your page
place a plus sign around a few words like this

+bob was here+

save your page you should see the words in Italics like this bob was here

Boldness is rewarded

Place two plus signs to create a bold phrase

++bob was really here++

You should see the phrase in Bold bob was really here

Emphasis on Boldness

Place three plus signs to create a bold and italic phrase

+++bob was really, really here+++

You should see the phrase in Bold and italic bob was really, really here

Link to external sites

type in a url http://www.arrizza.com
you should see a link in blue http://www.arrizza.com
Click on the link, it should take you to the url you typed in
edit the page again and temporarily remove the "http:"
You should see something like: //www.arrizza.com The http: is required!
edit the page and put the http: back in

Horizontal rules Horizontal rules can be inserted by placing three dashes (hyphens) --- at the very beginning of a line.

You should see a horizontal line above.

Use backticks to escape

hyperlinks are created automatically for anything with

mailto : sends mail mailto:[email protected]
http : web link http://www.microsoft.com (if you omit the '//' the url is relative to the wiki server!)
ftp : web link ftp://www.microsoft.com (if you omit the '//' the url is relative to the wiki server!)

embed: can be used to embed another wiki page's contents into the current page

 embed:WikiName

A Wiki Name is a set of two or more capitalized words squished together.

viewport: can be used to view another wiki page's contents in the current page

 viewport:WikiName

WikiName edit Jan 10 2005 05:11:22

A Wiki Name is a set of two or more capitalized words squished together.

use an opening bracket [ to begin uninterpreted section e.g. a code snippet,
use closing bracket ] to end

  //this is example code
  if (a == 1)

[test]