Version 10.1

It is recommended that you use Firefox or Internet Explorer on the PC, and Firefox, Camino or Safari, on the Mac.

This document will show you all the functionality you are most likely to use.

But first read this so that you get an idea of what wikis are and what they can be used for in education.

How do I login to UCL Wiki?

Go to http://wiki.ucl.ac.uk and login with your normal UCL user ID and password.
The page which appears is the UCL Wiki Dashboard. It lists the spaces (i.e. different areas in the wiki) to which you have access in a column on the left. You may be able to see some spaces without logging in, but you won't be able to do much.

How do I add a comment to a page?

As you navigate through pages in spaces, you will find Add Comment links on some pages. If you have a short comment about the page, you can use these. Someone else may reply to your comment, thus creating a threaded discussion. If your comment is more substantial, you may want to edit the page itself, if you have been given the right to do so (you can see the Edit tab at the top of the page).

How do I edit a page?

You may find it quicker to create content by using wiki markup. Using wiki markup is a powerful way to add design and functionality to your wiki pages. To do this, select the Wiki Markup tab after selecting the Edit tab. There is a summary of the markup system available from the full guide link in the right column. (This only appears when you're editing.) Common codes include:

h1. Biggest heading
h5. Smallest heading

*bold*
_italic_

---- for a horizontal line across the page

* for a bullet point
** for a sub-bullet
# for a numbered point

[British Library|http://www.bl.uk] for a link to a Web site

{panel} text of panel (which sticks out from the rest of the text) {panel}

{note:title=title of note} text of note
{note}

Biggest heading

Smallest heading

How to change the size of the build in headings

bold
italic
---- for a horizontal line across the page

  • for a bullet point
    • for a sub-bullet
  1. for a numbered point
    British Library for a link to a Web site

text of panel (which sticks out from the rest of the text)

text of note

Note that it is also possible to edit wiki pages in Word.

How do I add a new page?

Site map

Click on Browse Space and then Tree for a useful map of your wiki space.

How do I restrict access to a page?

If you want to apply restrictions in addition to the default ones on who can view or edit the page, select the EDIT link next to Restrictions at the bottom of the page whilst you are editing the page. Type the user's name or username (UCL user id) and click Search. Tick the relevant box and click Select User(s).

See the section on Creating a personal space for information about giving permissions to groups. For more information, please see our tutorial on Page Restrictionsand Managing Groups.

Notes

How do I insert a link?

Click the Insert/Edit Link icon (it looks like a chain) on the toolbar.
To link to a page in the UCL Wiki, search e.g. Global Spaces for the page. Put the name of the link in the Alias field. Click the link that appears after your search and click OK. (Attachments are included in the search.)
To link to a page on the Internet, click on the External Link tab and enter the address. (It may be safest to copy the address from your browser's Address field).

To get your link to open in a new browser window, use the following syntax:

{link-window:http://www.bl.uk}British Library{link-window}

To link to an e-mail address, click on the External Link tab and enter mailto: followed immediately by the address.

To link to an anchor (location in the middle of a Web page), link to pagename#anchorname e.g.: AboutWiki:Guide to the UCL Wiki#access

To insert the anchor in the page, use this syntax:

{anchor:anchorname}

Anchor names should be short and contain no capital letters or spaces.

How do I add an image?

Click the Insert/Edit Image icon (it looks like mountains) on the toolbar. Click Browse to locate the file. In fact images displayed in Confluence pages are attached to the page and you can see them on the Attachments tab.

How do I link to a YouTube video?

YouTube videos have addresses in the form: http://www.youtube.com/watch?v=-dnL00TdmLY

It's that bit after ?v= that you need. Click on the markup tag and add e.g. :

{youtube}-dnL00TdmLY{youtube}

where you want the video to appear on your page. Wow!

Can I import Word documents?

To import a Word document, click the Doc Import tab at the top of the page and select a Word document to be imported. If you just click Import, the converted document will completely replace the existing page, apart from the title, so you should use it on an empty page. Click the Advanced button for more options: the most useful of these is to split large documents into several wiki pages according to the headers in the original document - the pages will become children of the current page.

How do I attach a file to a page?

Attachments are inconvenient things; don't use them if you can get away with copying text into an ordinary wiki page. It is not possible to attach files larger than 10Mb. Check in Windows Explorer (PC) or Finder (Mac) before you upload a file.

How do I embed a Word document or Excel spreadsheet?

See Using the Office Connector.

How do I rename or move a page?

You may prefer to use the cut and paste method in markup with Ctrl-A (to highlight the whole text), Ctrl-X (to cut it), click Remove Page and then create a new page and use Ctrl-V to paste the text in the markup there. (If you're using a Mac, use Command instead of Ctrl!)

How do I save a Wiki page as a Word file or PDF?

How do I view changes or restore older versions of pages?

How do I remove pages?

How would I create a template in the wiki?

Templates are useful if there is content which stays the same on many pages or one wants to encourage people to lay pages out so that they look similar.

You need to be a space administrator to create a space template.

How do I create a page using a template?

What's all this about labels?

Labels are keywords or tags for a page. If a page has them, you will see them at the top.

By clicking on a label, you can search for other pages with the same label in that space or across the whole of UCL Wiki. Therefore, it is possible to use this functionality to create a simple online database, searchable by lables as keywords.

How do I add labels?

How do I read news posts about a page?

How do I post news about a page?

How do I watch for changes to my space?

Wiki space owners who allow UCL staff and students to edit or comment on pages, or who allow anonymous read permission to anyone on the internet should maintain an active awareness of contributions by applying the settings Watch a space or Subscribe to daily updates to that space.
You must be a space administrator (see the Browse Space link) to do this.

To watch your wiki space, go to Browse Space | Advanced | Start watching this space so you may be automatically notified of activity.

Can I get information about spaces visible to me?

You can also subscribe to a daily report which sends you an e-mail of changes in all spaces visible to you:

How do I create a personal wiki space and give access to it?

Notes

What's all this about global spaces?

So far the talk has been about personal spaces. The good news is that global spaces, the main part of the wiki with content from many people, not your personal bit, behave functionally very much the same as personal spaces.

You can apply for a global space on the UCL Wiki which is still in pilot by clicking here, but first you should consider how the space fits into your own structures: committees/subcommittees, projects/subprojects and the pros and cons of sharing a space.

Access rights

For more information on permissions, see: http://wiki.ucl.ac.uk/display/AboutWiki/UCL+Wiki+Permissions+Explained

Can I set up my own groups of people and assign rights to those groups?

It is not possible to create your own groups for assigning access rights in the case of a personal space. The procedure for doing it for a global space is:

It is better to use this feature, rather than granting permission to individuals, as it is a lot less work if you ever need to change the permissions in future.

Your profile

To edit details about yourself, add your photo etc., click on your name top right on the UCL Wiki homepage once logged in.

Click on Preferences top right and then the Edit Profile tab.

Note that information put in your profile is visible to anonymous users of the UCL Wiki.

How can I change the administrator of my space?

E-mail wiki-support@ucl.ac.uk and tell them who you want to be administrator. It needs to be a member of UCL staff.

How would I remove my space?

If you ever want to remove your space, click the Browse Space hyperlink top right and then the Space Admin tab. Click Remove Space.

Advanced formatting

Once you have mastered the basic functions detailed above, you may want to adopt some macros to make things look nice.

To enter macro code, click on the Wiki Markup tag.

Computer code

For computer code etc. you could use a
{noformat}

{noformat}
tag before and after e.g.

copy *.* s:\Training

copy *.* s:\Training

Actions etc.

The {note} tag before and after produces an exclamation mark:

Watch out for this!

Watch out for this!

Done

A

tag before and after produces a handsome green tick:

This was done.







This was done.

Table of contents

If you want to insert a table of contents at the beginning of your page, picking up headings in your text, use something like:

{toc:type=list|indent=10px|minLevel=2}

Columns

Here is the code for creating columns on your page:

{section}
{column:width=50%}
Column one text goes here.
{column}
{column:width=50%}
Column two text goes here.
{column}
{section}

Column one text goes here.

Column two text goes here.

Further information

A good general overview may be found at: http://www.atlassian.com/software/confluence/webinar.jsp
UCL specific documentation is here: http://wiki.ucl.ac.uk/display/AboutWiki/About+the+UCL+Wiki
For detailed documentation, see: http://confluence.atlassian.com/display/DOC/Confluence+Documentation+Home

Tips

  1. Do not navigate away from a page your editing (e.g. by clicking your browser's Back button) as you may lose content.
  2. Do not save your pages too often, as this creates many versions.
  3. Do not leave pages open in edit mode for a long time, as this puts a heavy load on the server.