This is a guide to what a wiki is and how you can create one. It looks like a lot of text, but you can scroll to the section you have questions about.
If you then still have questions, use the comment section below :)



Table of contents

Wiki guide#1: What is a wiki?
Wiki guide#2: Adding comments and editing pages
Wiki guide#3: Making a New Wiki Page
Wiki guide#4: Putting pictures in Wiki-pages
Wiki guide#5: Viewing Older Versions of a Page
Wiki guide#6: Restoring a page to an older version
Wiki guide#7: Wiki-ownership
Wiki guide#8: Searching for a wiki-page
Wiki guide#9: Making a Poll on a Wiki-Page
Wiki guide#10: Exporting a wiki-page
Wiki guide#11: Converting an MS Word document into a wiki-page

Note: Click the link and you will be taken to that part of the wiki.



What is a wiki?

A wiki is a web page (or set of pages) that anyone and everyone can edit. You can use it to share information, images or things like that with other members of Musmakers.



Adding comments and editing pages

To comment on a wiki
Near the bottom of the page there is a field for adding comments to the page without editing it and some buttons for determining how the comments are displayed or for not showing the comments at all.

Just above the comments there is a button labelled "Edit this page". When you click on it, you get some new fields at the top of the page. First there is a field called "Page name". Usually you don't want to change the page name, so leave it as it is. If the page is password protected, or if you are the creator of the page, there will be a field for entering the password for editing the page. To password-protect your page that you've created, you enter a new password in this field.

To edit a wiki
Finally, there is a larger box where you can edit the contents of the page. The contents can be formatted with pseudo-HTML.
Don't remove the text that is in the box unless you want to delete all old contents of the page!
What you usually want to do is to edit the contents, for example, by adding or changing something.

When you have made your changes, click on the button labelled "Submit changes to this page", and you will see the page as it looks after your modifications.



Making a New Wiki Page

First, pick a name for your wiki-page. Go to the menu to the right. Write the name you chose for your new page in the field that says 'Wiki-page' and click on "Go!". If you get a text that says "This is an empty page" the wiki-name hasn't been taken yet.
If anything else appears the name is taken and you must pick another name.



When you have found a name that isn't taken, you can edit the page as described above.

There are also extra fields for you to fill in:

'Enter keywords for this page only if you want it to be found:'
Fill in the keywords that represent the information on your wiki. When members try and find wikis with one of your chosen keywords, they will be directed to your wiki.
Further below is explained how you can search for a wiki.

Password:
Fill in a password if you want the page to only be editable by people whom you gave the password to.
Your password will be automatically remembered for you, so you don't have to fill it in each time you edit the page.
You can only create a password for wiki-pages you own (see ownership below).

Editable and viewable by whom?
The following options are possible;
1. Freely editable: Everyone can edit your wiki (provided you didn't submit a password).
2. Editable by forum members only: In the next white field you can fill in a forum number. If you created a forum, you can assign the wiki to a forum (see more explanation about forums on Forum guide).
With this particular option only forum members will be able to edit the page. Provided again you didn't fill in a password.
All members of Musmakers will still be able to view the wiki.
3. Editable by owner only: You and only you can edit the page.
4. Viewable by forum members only: Only members of the forum can view and edit your wiki.
5. Viewable by forum members & editable by owner only: Only forum members will be able to see the wiki and only you can actually edit it.

Forum # (Not needed for normal wiki-pages):
To be able to use option 2, 4 and 5 summed up above you need to fill in a forum number.
You can especially create one or fill in a forum number of an existing forum.


How to make a wiki-link
When you have made your page, you probably want to add a link to it from somewhere (another wiki-page, your presentation, etc). The "code" for a link looks like this: "[wikiname@wiki]". 
On the wiki-page the link will look like the page name: wikiname.

Note: If you don't want anyone to find your wiki, don't fill in any keywords and don't put a link to it in a public area. People will however be able to view it if they stumble upon it (by guessing its name). If you want to prevent that from happening you can create either a really strange name or create a forum and make the page only viewable by forum members (you). Creating a forum is explained on Forum guide#10.

Watching a wiki-page
I would also suggest that you watch all wiki-pages you create. Click on "Start watching this wiki-page" to start watching it, which means that you will get a notification below the status bar each time someone edits the page. If you don't want to watch the page, you should at least add it to your notes, so that you'll find it even if all links you have made to it would get removed.
How to add to notes, see Navigation#8: 'Show notes'.

If you don't have time to read the changes you can click 'Put this wiki under 'Wiki-changes'. You can also do this without actually watching the page. This button creates a notification in the right menu that you can check up on later.

In the wiki-page data you see '# of watchers:'(number)'. This shows how many members, yourself included if you started watching it, are watching your wiki.

D20:#?
For curious members:
There is a line below the number of watchers that says 'D20:(number)'. This is a 20 sided dice and will show a random number from 1 to 20 each time the wiki is changed. It can be used for role-playing, or any other usage you may find for it.



Putting pictures in Wiki-pages

1. Upload them to your photo slot (in your Presentation).

2. Then once done, right click on the picture and select properties. Then select the address (URL) of the picture and copy it.

3. Go to the wiki-page you want to put your picture in.

4. Click on the 'Edit this page' button at the bottom of the page.

5. Then, scroll down the text box till the place you want to put your picture in, then write:
<img:Paste the URL you copied earlier here>

6. The final syntax should look like:
for example.
Putting this syntax on your wiki (or presentation) will show the actual image.

Note: By the image link you can thus see who uploaded it, as the member number is in the link. Right click on the image and take a look at the URL ;)
This will not be the case with images that have been uploaded straight to a wiki.

7. Then, click on the 'Submit changes to this page' button.

8. The url to the image will appear on the bottom of the edit-box of the wiki.
<url:http://www.modelicacommunity.org/img/photo/membernumber_imagenumber.jpg> for example.
Change URL into img and you can put your image on the wiki!


Uploading pictures to Wiki-pages

If you have a good reason, you may ask the crew for permission to directly upload pictures to your wiki-page. That way, you can skip the extra steps of uploading the picture to your Presentation, and then getting the URL, and et cetera. 

Once you have a lower this permission and the crew gave you the privileges, you can upload pictures to your wiki-page.

1. Go to the bottom of your wiki-page and type in the file name of the image or file you want to upload. If you don't know it by memory, press the browse button.

2. If the name of your file or image is different from its name on your computer, rename it - remember to end the name with ".gif" or ".jpg" or something! Don’t put spaces in the name, because that makes the name really ugly once uploaded. Each space will be replaced by '%20'.

3. Fill in the extension of the file again, like '.jpg' or '.gif'

4. Then click the "upload a file" button.

5. The url to the image will appear on the bottom of the edit-box of the wiki.
<url:stuff/filename.jpg> for example.
Change URL into img and you can put your image on the wiki!

Note: If you want other files but images uploaded to a wiki-page, you have to ask for more privileges. You can then upload any file to the wiki.
If the file is not an image, don't replace url with img and leave the syntax as it is.



Viewing Older Versions of a Page

Below the Musmakers Status bar on each wiki-page you can see a box with the name of the latest author, the name of the page and the current version number. There is also a button saying "Previous version", which takes you to the previous version of the page, and a version number field that you can use to go directly to any older version of the page. If you are looking at an old version of the page, there will also be a button saying "Next version", which takes you to the next version.
If you are already watching the last version of the wiki the button 'Next version' won't show.
If you know a particular page version you wish to visit, then type in that number in the text box and press 'View!'.

What was changed?
If you want to see what exactly was changed on your wiki, you can also press 'View diff'.
Clicking this button (in the white information box) will let you view the page as pseudo Musmakers HTML.
Text that was removed will be crossed out, and text that was added will be highlighted in red colour.



Restoring a page to an older version

If your wiki-page has been messed up (intentionally or unintentionally), you will probably want to restore it to the latest "correct" version. That is actually fairly easy.

First click on "Edit this page" to go to "edit mode" (this is important!). Then you need to find the latest correct version of your page. If you know that the page was messed up recently, the easiest way is to click on the "previous version" button until you find a correct version.

When you have found the newest correct version (the one you want to revert to), you just click on "Submit changes to this page". Voilá, page restored!

Who messed it up?
You can see who messed up your wiki by using the 'View diff' button and looking at who was the author of the modification that messed it up.



Wiki-ownership

When you created a wiki, you are automatically the owner. To see who the creator of a wiki is you take a look at who made the first version.
If you made a wiki and you wish to transfer the ownership to someone else, there is a way to do that.
When you go to edit your wiki, you will see (on top of Page Name), "Change page owner to:"
Just type in who you wish to transfer page ownership to, and click the "Change Owner" button.



Searching for a wiki-page

Right above the wiki-page data you will find the possibility to search for wiki-pages. You fill in a keyword of what you're looking for and press Search.
If anyone made a wiki-page containing your keyword, the search will show this wiki-page.



Making a Poll on a Wiki-Page

1. Press the 'Edit this page' button. The wiki-page edit box will come up.

2. Now type one of the following (the tags in italic):

<wikipoll> - The wiki-poll is just like a poll in your house. However, you can set the wiki-poll so it can be edited by many people based on a private forum number.

<voting> - This poll is the same as a normal poll, except the members who vote have their names placed next to their selection.

<multivoting> - This poll is the same as a voting poll, but instead of restricting the member to only choosing one option, they are allowed to select many.

3. Click the 'Submit changes to this page' button. You will see a form similar to that of a house poll when the page reloads.

4. Follow steps 2 - 5 in the above section, about how to make a poll in your house. You can also set the accessibility options for the poll using the drop-down box and private forum number input box on the form.

5. Enjoy! Members will now be able to see the poll once they are given the link to your wiki-page!



Exporting a wiki-page

If you want your wiki-page to be viewable for non-members, you can actually do this!
Scroll down your wiki and click 'Start exporting this wiki-page'.
If you then scroll down again and click 'The exported version of this page.' you will be able to see what non-members will see.
The url in your browser is the url for these non-members.
You can also stop exporting the page by pressing 'Stop exporting this wiki-page'.

There is also the option to export in raw HTML.

Note: if you have links on your exported wiki-page that you also want to make viewable for non-members, you will have to go to each link and press 'Start exporting this wiki-page.'
Note2: You can not watch the exported version of a wiki when you protected it with a forum to be only viewable by the members of it.



Converting an MS Word document into a wiki-page

To covert an MS word document into a wiki-page you can save it as HTML and then enter it into a wiki-page. But to be able to read the HTML, you have to press the button "Start exporting this wiki-page" and then "Export raw HTML".

Now the page will look like text. See raw.

To view the HTML-code normally, press the link "The exported version of this page.".
You can also build a link to the page with: <URL:_raw> (opens in new window) or <URI:_raw>.



Go or return to:
- Help
- Navigation
- Presentation Navigation
- Song guide
- Forum guide
- Invitations guide
- Pseudo HTML