EDT4OL/Intermediate wiki skills/Pedagogical templates

From WikiEducator
Jump to: navigation, search
Blue-steps-red-wall.jpg


Icon summary line.svg
Mini challenge - Create and edit a pedagogical template in 4 steps
Summary: Learn how to publish instructional activities using WikiEducator's pre-defined pedagogical templates
Time7.svg
30 mins - 1 hour (Depending on prior knowledge of wiki text and general understanding of markup languages)
Font2.svg
Linked to final: Intermediate wiki skills challenge

In this challenge, you will learn how to use wiki text (markup) for pedagogical templates, while developing draft content for re-use in the learning materials you are developing in the course



Icon objectives line.svg
Purpose

The purpose of this learn-by-doing challenge is to:

  • Build your wiki skills for publishing pedagogical templates in WikiEducator
  • Discover the range of pre-defined pedagogical templates available in WikiEducator
  • Follow 'help' instructions published on WikiEducator
  • Learn how to customise these templates for your own authoring
  • Prepare initial drafts of templates for use in your own course



Start here

Icon inter line.svg
Web resources
  1. Read the summary of the three steps for publishing a pedagogical template below
  2. Bookmark and scan the quickstart guide for pedagogical templates (which can be accessed from the help link on the left-hand side of your browser on WikiEducator)



Vegetables 1370912 Nevit droste.jpg

The Mediawiki software has a powerful feature called templates, which enables more advanced features to help manage the layout and structure of elements more consistently in the wiki. So, for example, a template can be created to manage the display of a feature on a particular page in the wiki. Every time the template is used on any page in the wiki, it will re-produce the layout features defined in the original template without the need to code the wiki text on the page where it is used.

The layout for the Mini-challenge, Purpose, and Stimulus resources on this page was created using this pedagogical template feature.

Don't worry! In this course, you are not required to code new templates. You will be using templates we have already created. We will show you how to use a number of popular templates in WikiEducator. They are very easy to use once you know how. It's a simple process of:

  1. Copy the wiki text for the template
  2. Paste this on the page where you would like to use it
  3. Edit and customise the content of the template in the wiki


Exe RGB 72dpi.jpg
In WikiEducator, we use pedagogical templates to manage the layout and display of a range of pedagogical forms: objectives, case studies, reading activities, etc. We call these 'instructional devices' (or iDevices for short). Historically, the idea of isolating the iDevices of learning content was a primary aspect of the eXe Project, an open source development project, and the concept has been retained in WikiEducator.

A pedagogical template associates an icon with the type of activity and applies a distinctive layout to differentiate iDevices from normal body text. Consequently, templates provide a way to manage structure and form on wiki pages in a consistent way, not unlike styles used in word processing.

Step 1: Create a practice page for pedagogical templates

Create a subpage from your Sandbox page to practise editing pedagogical templates.

  1. Log in to WikiEducator and go to your Sandbox page
  2. Click on the edit link, then add a subpage for pedagogical templates using the following syntax: [[/Pedagogical templates/|Pedagogical templates]]. (Make sure that there is a "/" (forward slash) before and after the wiki page name. This is a shortcut for creating sub-pages from a parent page)
  3. You should see a red link for a new 'Pedagogical template' page which is a placeholder for creating the new subpage below

Step 2: Copy the wiki text for a pedagogical template

In wiki text, the beginning of a template is indicated by two curly braces like this {{ and is closed using two curly braces like this }}. These curly braces instruct the wiki software to apply the specified template's formatting, in our case the template called IDevice.

The pedagogical templates also support parameters. These are variables using pre-defined text phrases for manipulating the behaviour of the template. Each parameter is signaled by a vertical bar like this "|" followed by the name of the parameter. The variable text is entered after the equals sign ("="), which will be explained in Step 3 below.

All you need to do is to highlight and copy the wiki text for the template in the box below:

{{IDevice
|theme=line
|type=
|title=
|body=
}}

Step 3: Paste the wiki text for the template on your page

  1. Go to your Sandbox page and click on the red link for the 'Pedagogical template' subpage to create this new page
  2. Paste the wiki text you copied from Step 2 above onto this page
  3. Remember to save your page

If you have done this correctly, you should see the following example after you save the page:

Icon activity line.svg
Activity




Step 4: Edit and customise a pedagogical template

Theme, type, title, and body are parameters you can use for editing and customising your template. The parameter names are case sensitive and, in the case of pedagogical templates, they are all lower case. They will not function properly if, for example, you use "Theme=" instead of the lowercase "theme". The list below provides a summary of the parameters and options.

Parameter Purpose and options
theme The user can specify a theme which manages how templates are displayed in WikiEducator. The display of templates in the published course site will use the theme of the target website.

Check the name of the theme next to the theme parameter, which in our case will always be: theme=line

type
(Required)
Type specifies the associated icon for a pre-determined list of iDevices. Consult the list of options in the Quickstart guide
title
(Optional)
The title parameter enables the user to specify an alternate title associated with the designated icon for the corresponding type. So for example, the author could use "title=Next steps" to be associated with the icon for "type=Key point"
body
(Required)
This parameter is used to display the body text of the iDevice. It will accept any standard wiki text and formatting, including bold, italics, lists, images, etc.

Tasks

  1. Consult the list of options in the Quickstart guide and choose a 'type' of pedagogical template you can include in your online learning materials (for example: "Objectives")
  2. Prepare some draft text to provide learner instructions for the iDevice you have chosen
  3. Go to the Sandbox page you created in Step 2 above, and open the 'Pedagogical template' subpage in edit mode to start populating the variables of the Wiki markup you copied in Step 3
  4. Enter the type variable from the list after the "type=" parameter, for example: "|type=Definition"
  5. After the "body=" parameter, enter the body text you prepared to provide instructions for your learners
  6. Click on save to see what your template looks like in published view
  7. Now change the title for your iDevice, providing alternate text after the "title=" parameter; This demonstrates how you can change the default heading text associated with each icon in the style
  8. Experiment creating a few different iDevices from list of options