LEO Guides

How to edit a wiki

A wiki is a collaborative tool that allows multiple users to add, edit and share ideas in a single space within your LEO unit. Starting with a single page, students may work in groups or individually to edit existing content and make new content, creating a body of work that can serve not only as an information resource, but also as part of an assessment activity.

A finished wiki appears much like a mini web site, with linked pages and a table of contents that is automatically generated. A wiki may take the form of a general information repository or learning resource, with categories and content decided upon by the authors of the wiki.

Editing existing wiki content

A wiki page consists of a Table of Contents, which is automatically generated based on headings used within the page content, and the content itself below this. To edit existing page content:

1. Access the wiki from your LEO unit page.

2. Navigate to the page you wish to edit, using the in-page text links or via the 'Map' link.

3. Click the 'Edit' button (indicated in the image below) to edit the entire page.

Alternatively, click one of the '[edit]' text links that accompanies each page heading to edit only that heading and the content that follows it. These [edit] links are found in the Table of Contents or in the general page content area.

The wiki page layout with the edit button selected

This will load the page into Edit mode. This interface loads the HTML editor window, which is a text editor with formatting functions similar to word processing programs such as Microsoft Word, where you can edit the page content. You will notice that most functions in this editor work just like Word, with some slight differences.

The HTML editor has a toolbar to access most common functions, such heading sizes, making lists,bold/italics formatting, and image or video insert functions. You can also click the 'toolbar toggle' button to access more options (indicated in the image below).

The HTML editor toolbar with toggle button highlighted

4. Using the HTML editor, edit the page content, headings, images, and any other content you require.

5. Click the 'Save' button to save your page changes.

The following sections explain some of the specific formatting functionality for editing wiki content.

Using proper headings in wiki pages is important, not only so that content is able to be read easily by your fellow students and your tutors, but also so that the Table of Contents for each page generates properly.

About Headings and Page Structure

There are pre-made headings you can use in your content (levels 1 to 6), which you can select using the Format drop-down box in the HTML editor window. By default, when you type in content, it will be entered as a Paragraph, which is just the default state for regular text. When you change this to a heading format, this whole section of text becomes a Heading.

Apart from the obvious visual difference in text size and weight between the heading sizes, the wiki page reads headings as separate sections and creates navigation based on the hierarchy on these age headings.

For example, this section of content on an example wiki page uses several headings to break up the text:

Wiki page text with heading separating content sections

If you structure your headings correctly, you can create a hierarchy of sections within the page. In the image below, you will see how the headings used in the image above create an automatic menu for the page, with each level of heading indented and numbered sequentially, giving structure and definition to your content. On the left is the heading level used (just for reference), and on the right is the actual menu with text used in headings.

The headings hierarchy showing heading levels

You should start with your main page topics as Heading 1, then use the other heading levels under this if you require sub-topics of each main topic. Use heading 2 under a heading 1, a heading 3 under a heading 2, and so on.

How to create a heading

1. Type your content into the HTML editor just using the default paragraphs, placing the heading text on its own line. At the end of a section of content, use the 'Enter' key to start a new line, type your heading text, then press 'Enter' again and continue typing your content.

Section of text without heading selected

In the image above you will see the section of text with the intended heading "The Colour Red" just as simple paragraph text on its own line. It is much easier to focus on content to begin with, then go back and add the correct formatting.

2. Click anywhere inside the intended heading text to place the cursor inside the heading.

3. Click the 'Format' dropdown box (which should by default read "Paragraph") and choose the desired heading level.

The same content section with the heading created

You will see the whole section of text now become a heading instead of a paragraph, as in the image above. When you save this content, this heading will become a clickable link in the Table of Contents for this page, along with all other headings used on this page.

You do not need to highlight the section of text to convert it to a heading. The entire text block will be converted from a paragraph to a heading. Once it is a heading, you can easily click in the text section again and change it to a different heading size if you wish.

Note: the way headings display visually in the HTML editor is not necessarily how they will display in View mode. Save your changes and return to View mode to see how your page content looks and is structured, then edit again as desired. Your tutor may have specific requirements around organising your wiki content.

You can create links in your wiki content to sites on the web outside of LEO using the Insert/edit link function in the HTML editor. Note: if you want to make a link to a new wiki page, please see the How to Make a New Wiki Page guide.

When designing links, try to make your text link contextually relevant as part of a sentence, and keep it short but descriptive.

With the whole page or page section open in the HTML editor:

1. Highlight the text you wish to use as the link and click the 'Insert/edit link' button (indicated in the image below):

Highlighted link text with user selecting Insert Link button

An Insert/edit link dialogue box will appear that has several options available to you. For most standard links:

2. Type (or paste) the address of the web site in the 'Link URL' field.

3. Use the 'Target' drop-down box to select the Open in new window (_blank) option (this will open the web address in a new browser window when the user clicks this link).

4. Click the green 'Insert' button.

You will then be returned to the editor, and the selected text will now be a link.

Editing or Deleting a Link

To edit a link:

  1. Click anywhere inside the link text and click the 'Insert/edit link' button.
  2. Modify the link information.
  3. Click the green 'Update' button.

To delete a link:

  1. Click anywhere inside the link.
  2. Click the 'Unlink' button (found next to the 'Insert/edit link' button, represented by a broken chain icon).

Inserting an image

1. In the HTML editor, press the 'Enter' key to create a blank line in the content where you wish to insert an image.

2. Place the cursor on this blank line and click the 'Insert/edit image' button in the tool bar.

3. When the Insert/edit image window loads, click the 'Find or upload an image...' button:

The insert image window with upload file button selected

4. In the File Picker window, click the 'Upload a File' button from the left menu. In the main section of this window you will see the following options. You should complete all parts of this form.

File picker with image information meta data entered

5. Click the 'Browse' button and locate the file on your computer to upload.

6. Enter a name for the new image resource in the 'Save as' field.

7. Add the name of the image author or owner (your own name, if you created the image yourself, or the owner of the image listed on the site you found it) in the 'Author' field. You are expected to properly attribute your image resources just as you would reference a quote.

8. Use the 'Choose license' dropdown box to select the appropriate copyright license for this image.

9. Click the 'Upload this file' button. You will be returned to the Insert/edit image window.

10. Enter a short, detailed description of the image in the 'Image description' field. This description is important. If the image for some reason will not load, the text will be used in its place. Also, if the visitor is using screen reader software to read the web page, this description will be read out loud to them.

The uploaded image with preview and description entered

11. Click the 'Insert' button. The image will be then placed into the HTML editor content.

Inserting a Kaltura video

If you have videos stored in Kaltura, the ACU streaming media service, you can easily embed these videos in your content. If you wish to learn more about Kaltura, visit the LEO Kaltura Guide.

1. In the HTML editor, press the 'Enter' key to create a blank line in the content where you wish to insert a video.

2. Place the cursor on this blank line and click the 'Embed Kaltura Media' button in the tool bar.

This will open a pop-up window that provides access to your personal saved media under My Media, your Media Galleries, and all videos saved into the Shared Repository.

3. Click the 'My Media' link (or the 'Media Galleries' or 'Shared Repository' link, if the video is not saved in your personal folder)

4. Choose the video you want to embed from the list of available media and click the 'Select' button for that video.

Note: the medium size video is usually chosen by default if you click the 'Select' button, however you can click the 'down arrow' next to the select button and choose the Large or Small size video instead.

5. On the next page, which shows a preview of the video, click the 'Embed Media' button.

The embedded Kaltura video will be added to the wiki page content. Embedded Kaltura videos appear as a short block of link text in the HTML editor, but as a video object when seen in View mode.

Inserting a YouTube video

If you are simply inserting a link to a video on YouTube (or a video from another streaming media website), copy the 'Share' link from the website, as shown in the image below:

YouTube video share option with video link highlighted

You can then paste this link into the 'Link URL' field when you add a link using the 'Insert/edit link' function (see the "Creating links to web pages" section above.

However, if you wish to embed this video in the page:

1. In the HTML editor, press the 'Enter' key to create a blank line in the content where you wish to add the video.

2. Place the cursor on this blank line and click the 'Insert/edit image' button in the tool bar.

3. Copy the 'Embed' code from the Share section, as shown in the image below:

YouTube sharing section with embed code highlighted

4. In the wiki page HTML editor, click the 'Edit HTML Source' button. This will open a window with the page code visible and editable.

5. Find the point in the page code where you wish to insert the video. In this case, you should find the empty paragraph that was created before. Each paragraph of text in the HTML code is surrounded by a <p> tag and a </p> tag. The empty paragraph should look something like the image below:

HTML code fragment with empty paragraph indicated

6. Delete the <p> and </p> tags here and paste the embed code copied from the site, such as in the image below:

HTML code fragment with embed code added

This places the video between the paragraph above and below it. Be careful not to modify the code around this area, as deleting opening or closing tags for other paragraphs or headings may make the HTML code stop working correctly.

7. Click the 'Update' button to return to the HTML editor. The video should now be visible as an object inside the editor.

Inserting a document or file download

You can link to a document just like you would a website using, using the 'Insert/edit link' function. You can include PDF or Word documents, or even video or sound files you want to upload. This is a very useful way to share files that may not be playable in the web browser.

1. Load the wiki page into the HTML editor by clicking on the 'Edit' link.

2. Type in and then highlight the text you wish to use as a link to the file and click the 'Insert/edit link' button.

3. When the link dialogue box loads, click the 'Browse' button next to the 'Link URL' field, as in the image below:

User selecting the Browse option in the insert link dialogue box

This will load the File Picker window (which is a similar window to the one used for inserting images).

4. In the menu on the left, choose the 'Upload a file' option. This will present you with the ability to upload a file and set some file information.

The upload interface with file information fields

5. Click the 'Browse' button and choose the file from your computer to upload.

6. Type a name for the file into the 'Save as' field and enter the name of the file creator into the 'Author' field.

7. From the 'Choose license' dropdown box, choose the copyright type for this item.

8. Click the 'Upload this file' button.

9. When you return to the Insert/edit link dialogue box, click the 'Insert' button.

The link to the file will now appear in the HTML editor in the wiki page content. You can continue working on the page or save your changes to finish.

ACU provides email and telephone support services for students and staff through its educational technology partner, Androgogic.

Please take the time to read through our Frequently Asked Questions as you may find the answer you are looking for there.

The Support Desk operating times are:

  • Monday to Friday, 8am - 10pm (Sydney Time)
  • Weekends and NSW Public Holidays, 9am - 5pm (Sydney Time)
  • Closed: Good Friday & Christmas

For Support Desk enquiries please contact us via:

  • Telephone on 1800 246 442
    • Calls made to the 1800 number from most fixed line telephones are free to the caller
    • Calls made from public/mobile telephones or from overseas may be charged at a timed rate