Rick's Super-Quick Getting Started Guide



Your Account


  1. To make a new page, simply edit a page you would like it linked from (presumably your department page) and add a link using one of the below techniques:

    1. Use wiki /CamelCase - Any new word with mixed capital letters is automatically interpreted as a possible new link.
      If you have a mixed case word you don't want linked, add an exclamation point to the front of the word. Example, !CognitiveArts

    2. Use ["/brackets and double quotes"] - For example, ["/Rick's Testing Area"] would become Rick's Testing Area.

    3. Please try to remember to precede the link with a forward slash. This helps keep the page a sub-page (below) the page you linked it from.
  2. Click 'Save Changes'. Now, you will see a new link on your page, simply click that link and you will be prompted to edit a new page!


Working with Attachments & Images

The concept to keep in mind when working with attachments is; just like a regular web page, you need to have attachment available from that server. Then, you need to provide a link to that attachment.

Since you don't have local access to the server, the "attachments" link is really nothing more than an upload tool. It doesn't automatically provide the necessary download link for your readers. See the sections below for displaying your links.

It also helps to keep the following tips in mind when working with attachments on the web (and of course the same applies to this wiki):

  1. No spaces! Web browsers hate spaces! Otherwise, your document This is a sample document.doc becomes This%20is%20a%20sample%20document.doc. I suggest replacing spaces with hyphens.

  2. Include the extension for the file type, as this is how the wiki-parser determines how to handle the attachment. i.e. use .doc for Word, .xls for Excel, .jpg for an image, etc) (for example, project-budget.xls)).

  3. While you can make the link label anything you want, I generally advise making the link label the same as the document name. This way, when the reader downloads a document, it takes the guesswork out of finding the doc. For example:


How to add a picture

These steps assume you're in GUI-edit mode (you should see a word processing-style toolbar above the edit window):

  1. First create the link on your page:

    1. click the image-icon.jpg icon in the toolbar. This will pop a dialog window asking for a filename.

    2. Leave the pop-up list as "attachment:", and type in the name you want the filename to be (remember: no spaces, include the .jpg or .gif extension (for example, example-screenshot.jpg)). Don't worry, you can make up any name, because whatever you upload will be automatically renamed to this.

    3. Click "Save Changes" to get back into normal page view.

  2. Upload the image to the server:

    1. You'll notice at the spot you put the picture link, it will now read upload new attachment "example-screenshot.jpg".

    2. Simply click this link, you'll be taken to a new screen prompting you to upload your image. Click the 'Browse' button to find your image, and click upload.
    3. Click the "Clear message" link at the top to be taken back to your page. Voila! You should see your image!


(for you text-only wiki jockey's: substitute attachment:your-filename.jpg for step 1.)


Making downloadable file attachments (Word, PowerPoint, etc.)

  1. First create the link on your page:

    1. click the paperclip.jpg icon in the toolbar. This will pop a dialog window asking for a filename.

    2. Leave the pop-up list as "attachment:", and type in the name you want the filename to be (remember: no spaces, include the file-type extension (for example, example-budget.xls)). Don't worry, you can make up any name, because whatever you upload will be automatically renamed to this.

    3. Click "Save Changes" to get back into normal page view.

  2. Upload the document to the server:

    1. You'll notice at the spot you put the document link, it will now read upload new attachment "project-budget.xls

    2. Simply click this link, you'll be taken to a new screen prompting you to upload your image. Click the 'Browse' button to find your document, and click upload.
    3. Click the "Clear message" link at the top to be taken back to your page. Voila! You should see a link to your attachment!


Importing text from Word Docs, Emails, etc

Do NOT try to paste in text from a Word doc or email in GUI-mode! I can almost guarantee that you will get an error when you try to save.

The reason is because the wiki engine parser will choke on all those invisible control-tags (for example, the tags that makes text italic) that the parser doesn't understand. Even when you think you have a plain text, there's lots of invisible markers specifying font size, font face, etc.

To successfully import text:

  1. Click the 'Text mode' button to get into wiki's text mode.
  2. Paste in your text.
  3. Click 'Save Changes' to create a first-save and beginning revision.
  4. Click 'Edit' again, and begin reformatting your text just as you would in a normal word processor.


Editing: GUI verses Text modes

Creating or editing pages in GUI mode, extremely intuitive. Word processing-style toolbars help you style your text, make links, bulleted lists, and attachments.

However, the GUI editor is not always as robust as we would hope, and eventually you may run into weird anomalies that can be frustrating. For example, after an import of a long document (see above), you may notice that the GUI editor may try to start reformatting your numbered lists to bulleted lists.

Fortunately, there is an easy fix, and it's not as scary as it may sound: Text mode.


About Tables

Tables are a nice way to organize and display data in a cell-form. However, please note that tables in wiki's have to be greatly simplified, otherwise they will break. In general:

The reason for these limitations is because wiki lingo takes what's normally fairly complex markup and replaces it with a greatly simplified coding mock-up. To illustrate, to make a list on a regular web page, you would have to do something like this:

<ul>
   <li> this is item one. </li>
   <li> this is item two. </li>
</ul>

However, in wiki code, the same thing is accomplished by simply doing:

 * this is item one.
 * this is item two.

The result is that of that over-simplification is that it is not able to handle complex interactions that you may be used to seeing on normal web sites (such as lists embedded in table cells).


How to embed Flash & Other Multimedia

Our wiki is fairly sophisticated in that it is capable of handling flash and other multimedia content (many other wiki's cannot). But, if you're working with this medium, I presume that you already know most of what needs to be done (see examples above for uploading files). Hopefully, the example code below will be self-explanatory:

[[EmbedObject(example.swf)]]
[[EmbedObject(example.swf,width=637,height=392)]]
[[EmbedObject(SlideShow/example.swf,width=637,height=392)]]
[[EmbedObject(SlideShow/example.swf,width=637,height=392,play=false)]]
[[EmbedObject(SlideShow/example.swf,width=637,height=392,play=false,loop=false)]]
[[EmbedObject(SlideShow/example.swf,width=637,height=392,play=false,quality=low)]]

Additional help is here: http://moinmoin.wikiwikiweb.de/MacroMarket/EmbedObject

I have been able to embed flash by following these instructions, thanks very much. I followed the additional help link above, saw the ability to get menu buttons, followed that link but got lost. The German instructions seem more complete but I don't know any German. Can you help with this at all. Thanks in advance.


[HelpContents]

MoinMoin: RickVanderveer/EditingFAQ (last edited 2008-07-03 21:31:13 by static-68-179-95-98)