The general wiki editing space does not have a set hierarchy of pages and sub-pages. This means that wiki editors have a lot of flexibility when deciding on the structure of the wiki, but this can also lead to disadvantages, including it being difficult to find pages and/or to understand the relationships between pages.
For these reasons, when authoring online course content in a wiki we recommend that you:
- use sub-pages to reflect the logical hierarchy of the materials you are developing, and
- familiarise yourself with the Mediawiki software features to help find and keep track of related pages that you and/or others have created.
In this section, we will use the analogy of a ‘family tree’ of two generations to represent the hierarchical structure of a course website. In this wiki to WordPress publishing model, the navigation of a course website is restricted to three hierarchical levels, and in the explanations that follow we will refer to:
- parent pages,
- children pages, and
- grandchildren pages.
Setting up sub-pages in the wiki
In the context of this course, an ‘Outline page’ is a page in the wiki that lists the collection of sub-pages of a course site that will be published to a WordPress site using the snapshot process.
The ‘Outline page’ becomes the parent page for its respective children and grandchildren.
In this section, we will show you how to:
- Create sub-pages in the wiki
- Use Mediawiki software features to track sub-pages
- Establish an outline page for authoring materials
Wiki markup to create sub-pages
The standard markup to create and link to a page is based on the use of forward slashes (
/) to distinguish parents from their children and grandchildren.
So, for example, a ‘Child page’ can be created as follows:
[[Parent/Child|Display text of child page]]
This example has two hierarchical levels:
- Child (which is a sub-page of the parent)
Alternatively, a ‘Grandchild page’ can be created as follows:
[[Parent/Child/Grandchild|Display text of the grandchild page]]
This example has three hierarchical levels:
- Child (which is a sub-page of the parent)
- Grandchild (which is a sub-page of the child page, but also a sub-sub-page of the parent page).
- Wiki page names are case sensitive, so remember to be consistent with the use of uppercase and lowercase letters in your page names
- To link to the ‘Grandchild’ sub-sub-page, you use the following syntax:
[[Parent/Child/Grandchild|This links to the Grandchild sub-sub-page]]
Shortcut to create a sub-page from a parent page
From any page, you can quickly create a sub-page of that page. So, for example, if you are on the sub-page called: [[Parent/Child|Child]], and you add the following syntax on that page, a sub-page will be created without the need to include the full prefix of the corresponding parentage.
- The name of the sub-page must be included between two forward slashes (
/) to instruct the wiki to create that page as a sub-page of the parent where the syntax is added.
- This only works for creating a sub-page of the parent, not subsequent children in the generation.
Mediawiki software features to track pages
The Mediawiki software provides valuable features to help you find associated pages. From the ‘Tools’ menu, there are two links that will help you find pages associated with any page in the wiki:
- What links here: From any page in the wiki, using the ‘What links here’ option, you can generate a list of every page that links to that page. In the context of developing a course, this is useful when trying to locate any ‘Outline’ page that is using a given page in the wiki.
- Sub-pages: From any page that has sub-pages associated with it, you can click on the ‘Sub-pages’ option to generate a list of all the children pages associated with that page.
Finally, sometimes when you are developing course materials, you may create a page and forget to include this as a sub-page on your outline page. When you are logged into the wiki, there is a ‘Contributions’ link associated with your Userpage. Clicking on this link will generate a list of every page where you have contributed edits. This is a useful feature to locate pages on which you have been working.
For the purposes of this course, you will create an ‘Outline’ page as a sub-page of your Userpage in the wiki. This will make it easier for your facilitator and fellow learners to find the pages you are working on.
When developing online course sites in the future, the ‘Outline’ page is normally set up in the main wiki area (rather than your user page). Should you wish to develop course materials in the future and re-use any of the pages you created on this course, it will be easy to copy or move these to a new outline page.
Purpose: Create an outline page as a sub-page of your Userpage.
Part 1: Create an ‘Outline’ sub-page
- Log in to WikiEducator and go to your userpage. (After logging in, click on your Username link at the top of the wiki to go to your Userpage.)
- Click on the ‘Edit’ button at the top of the page.
- Copy and paste the wiki markup below at the bottom of your Userpage. Remember to click on the ‘Save page’ button.
==My EDT4OL development project==
- If you have done this correctly, the ‘Outline page’ will appear in the published view of the wiki as a red link under the ‘My EDT4OL development project’ heading, indicating that the link is a place-holder for creating a new sub-page.
Part 2: Insert boiler plate wiki text to create sub-sub-pages on your ‘Outline’ sub-page
To create your new page:
- Click on the red ‘Outline page’ sub-page link from your Userpage to open the editing window.
- Copy and past the wiki markup below into the new ‘Outline” sub-page. Remember to click on the ‘Save page’ button.
* [[/Homepage/|Replace this text with title of your course site]]
* Learning pathways
**Replace this text with title of your learning pathway
***[[User:YourUsername/Short title of learning pathway/First page|First page display text]]
***[[User:YourUsername/Short title of learning pathway/Second page|Second page display text]]
***[[User:YourUsername/Short title of learning pathway/Third page|Third page display text]]
- We will edit and refine this wiki markup when you carry out the tasks for the Snapshot Challenge.
- With the exception of the wiki ‘namespaces’ like the template namespace (indicated by
Template:Name_of_templatein the wiki URL), or the user namespace (indicated by
User:Usernamein the wiki URL)