Teaching Guide Template - SIelearning · Web viewDocuments may be read without style sheets. The...

Technical Guide

Fitness Online Series 8 Flexible Learning Toolbox

Supporting Certificate IV in Fitness from the Fitness Training Package SRF04

12/10/2005: Version 1.2

flexiblelearning.net.au


© Commonwealth of Australia 2005

The views expressed herein do not necessarily represent the views of the Commonwealth of Australia.

This work is copyright. It may be reproduced in whole or in part for study or training purposes, subject to the inclusion of an acknowledgement of the source and it is not used for commercial use or sale.

Reproduction for purposes other than those indicated above requires the prior written permission from the Commonwealth. Requests and enquiries concerning reproduction and copyright should be addressed to the Branch Manager, Technology and Information Services Branch, Industry Skills Development Group, Department of Education, Science and Training, GPO Box 9880 Canberra City, ACT, 2601.


Contents

List of tables and figures....................................................................................................... ivIntroduction........................................................................................................................... 1System Requirements...........................................................................................................2

To Play............................................................................................................................. 2To Customize...................................................................................................................2To Serve........................................................................................................................... 2

Customizing Toolbox Content...............................................................................................3What features can be customized?...................................................................................3Editing Coursebuilder Interactions.....................................................................................4Basic Editing..................................................................................................................... 5Customising a Toolbox for single unit delivery...................................................................7Keeping to the Standards..................................................................................................7Visual Design.................................................................................................................... 8Navigation........................................................................................................................ 9File Structure.................................................................................................................. 10Accessibility.................................................................................................................... 10

Technical Support...............................................................................................................12Installation on a Web Server...........................................................................................12Installing into a SCORM compliant LMS..........................................................................12Producing CDs for distribution.........................................................................................13Known Issues................................................................................................................. 13The Help Desk................................................................................................................13

References......................................................................................................................... 14

Australian Flexible Learning Framework iii

Technical Guide


List of tables and figures

Table 1: Customizable Elements...........................................................................................3

Australian Flexible Learning Framework iv

Technical Guide


IntroductionThis Technical Guide has been developed to support you in delivering the Certificate IV in Fitness from the Fitness Training Package SRF05.

This technical guide provides instructions on how to install the toolbox resources onto a server or use as a CD ROM and how to customise the toolbox resources. The guide also describes the technical nature of the structure and operation of the toolbox resources directories and files. The Technical Guide should be read in conjunction with the Teacher's Guide which provides a detailed description of the toolbox resources and how they may be used for a range of learning outcomes to meet the needs of different learier groups.

The hardware and software required to use the toolbox are also listed.

This Technical Guide is divided into three sections:

System Requirements

Customizing Toolbox Content

Technical Support

Australian Flexible Learning Framework 1

Technical Guide


System Requirements

To PlayThe following hardware and software is required to view the resources within this toolbox

600 MHz or Pentium III or equivalent running Windows 2000/ME/XP orMacintosh PowerPC 500 MHz or above running OS9 or OSX

128 MB RAM

800 x 600 screen resolution with minimum 16 bit colour

1.44 MB floppy drive for saving student files.

Netscape (version 6.2 or later) or Internet Explorer (version 6.0 or later) Macromedia Flash 7 Plug in (available from http://www.macromedia.com)

Adobe Acrobat 5 plug in or later

JavaScript enabled

CD-ROM

Internet Access 28.8 Kbps or above (To follow links)

Microsoft Word 97, 2000 or 2003

To CustomizeThe following are the recommended requirements to customise the toolbox resources. Where global changes are required it is recommended that Macromedia Dreamweaver be used as it can modify the templates on which the HTML files are based.

600 MHz or Pentium III or equivalent processor

Macromedia Dreamweaver (or equivalent HTML editor)

Flash MX2004 development software

XML SPY or equivalent XML editing tool

Photoshop/Fireworks (or equivalent) for editing still images

SoundEdit16 (or equivalent) for editing sound content

Premiere (or equivalent) for editing video content

To Serve Internet Information Server 5.0 or

Apache Web Server

SCORM compatible Learning Management System (For LOs)

300 MB Available hard disk space

High bandwidth internet connection


Technical Guide


Customizing Toolbox ContentIn most cases Toolboxes are able to be modified and redistributed with minimal licensing or copyright encumbrance. However, before commencing any modifications we recommend that you check the license details of the Toolbox, to ensure that any customisation undertaken does not contravene the conditions of that license.

For licensing conditions visit: http://www.flexiblelearning.net.au/toolbox/license.htm

Remember to retain the original files in their CD-ROM format so that you always have an original copy of the Toolbox as a backup.

What features can be customized?Toolboxes can be customized by users under the flexible licensing arrangements, as long as they are not on-sold. You are therefore encouraged to customize the Toolboxes. However, before embarking on any modifications or customization, we suggest that you:

Check the licensing details of the Toolboxes to ensure that any customization does not contravene the conditions of the licence.

You have the required trained personnel.

Remember to retain the original files in the CD-ROM format as a backup (should you require them at a later stage).

Some design aspects of the Toolboxes can be easily customizable. However, there are other aspects of the Toolboxes that are more difficult. For this complex customization we recommend that you proceed only if you have the relevant trained technical personnel.

Table 1: Customizable Elements

Element To CustomizeDescription Location

Introduction Screen

This is constructed in Flash and the contents drawn from XML pages. The information presented can be changed by simply altering the content of the XML file

index.htmfront_end\index.xmlfront_end\fit009_scenarios.xml

Student Guide Text

Most text in is standard HTML, browse to the location in the Toolbox, take note of the URL, and use that to find the appropriate file in the generic directory.

Open the file in Dreamweaver (or a text editor) and make the changes.

generic\student_guide.htm


Technical Guide

http://www.flexiblelearning.net.au/toolbox/license.htm

Multiple Choice and text input Interactions

The questions and answers have been created using the CourseBuilder extension to Macromedia Dreamweaver. To change the text of a question or answer locate the appropriate HTML page as above and modify the parameters.If you want to change how the multiple choice interactions work, you will need to use Coursebuilder as it codes the responses. See below for Steps required.

The .js include files are located in \scripts directory in each content directory

\fit007_1\*.htm\scripts\ behActions.js

Flash Interactions

Most of these interactions can be customised by anyone with basic Macromedia Flash design skills. However some are more complex, and require actionscript knowledge.Most Flash interactions in this Toolbox are self contained, but some may pull in external data from an XML file. See below for methods of customising using XMLTo customise open the page in Dreamweaver and select the Flash object that you wish to change. Under the properties of the object, you will see a filename such as fit007_1_1.swf. You cannot change this directly, but must rebuild it from the source code.Using Flash MX or MX2004 authoring software, browse to the source directory and locate a .fla file with the same name as the .swf.

This is the file you need to edit. Open it up inside Flash and look for comments in the actionscript attached to the first frame. These comments will point you in the right direction.

\fit007_1_res\*.swffit007\source\*.flafit007\res\*.xmlfit007\res\*.jpg

Editing Coursebuilder InteractionsFollow these steps;

1. Open the html file in Dreamweaver and, in Design View, click on one of the elements in the Interaction.

2. Click on Code View

3. A few lines above the cursor, you will find a line that starts  where the contents of the ‘object’ attribute (G22 in the above example) are the same as those noted in Step 4.

6. Delete all instances of  on that line.

7. Click back to Design View.

8. Make sure your cursor is still within the Interaction.


Technical Guide

9. Now go to Modify | Coursebuilder | Edit Interaction.

10. A popup window now appears titled ‘Copy Support Files’. Leave both checkboxes the way they are and click ‘OK’. The support files will now be loaded. Ignore any error messages.

11. You can now edit the interaction as required, ignoring any error messages.

12. When all the changes have been made to the Interaction, go back to Code View and fine the line above the Interaction starting <interaction name= . This is the line you found in Step 3.

13. Insert  to the end of the line.

14. Scroll down to the line you found in Step 5 and add  to the end of the line.

15. Now scroll up to near the top of the page and look for some lines starting like <script language=”JavaScript”. There will be some lines with the ‘type’ attribute defined as “text/javascript” and some lines without the ‘type’ attribute defined. Delete those lines that do not have the ‘type’ attribute defined.

16. Editing is now complete

The Teacher Guide includes a ‘high-level’ overview of customization. That guide refers to this one for further information.

Basic EditingThere are numerous ways of editing the content of this Toolbox. The approach is similar to editing pages that might be found on any website.

The two simplest ways are:

1. Using a Web development package (MS FrontPage or Macromedia Dreamweaver)

2. Using a straight text editor (MS Notepad or your favourite text editor)

A basic understanding of HTML and the software package is useful.

Web Development Software Package

Download the complete Toolbox contents onto your machine.

Identify the pages you would like to edit (these are displayed in the address bar at the top of the browser page when viewing).

Locate these files in the downloaded files, following the paths displayed in the browser.

Open each file in your Web Editing Software Package (i.e. MS FrontPage or Macromedia Dreamweaver) and make appropriate changes.

Save each file.

Check your edits in a web browser to see if it displays properly.

Text Editor (i.e. MS Notepad) Download complete Toolbox Contents onto your machine.


Technical Guide


Locate the file you wish to edit, following the paths displayed in the browser.

Open the file using a text editor (i.e. MS Notepad) Make appropriate changes, following the CSS styles, some of which

are:o <h1> (Main Headings) larger blue font in caps,

o <h2> (Sub headings) green fonts,

o <p> (main content i.e. paragraphs) black text. Save each file. Check your edits in a web browser to see if it displays properly.

Replacing images with customised All images are named in relation to the page on which they are

displayed eg fit007_2_2.jpg in the associated res directory. Create and name the replacement image file the same as the one

you are replacing Copy the file into the res directory and overwrite the file you want to

replace. Alternatively you can remove the file from the res directory and place

the new one in the directory. This allows you to keep the removed file for future use.

Modifying flash interactions that use XML as dynamic source Open the xml file in a text editor or Dreamweaver Change the content of the particular nodes in the XML file

For example in the flash resources in fit007_2_18 which provides video in the form of .swf files, mp3 audio files and text subtitles as well as parameters for different exercises

<menu>

<item name="1">

<sub name="1: Bar Bell Bench Press" reps="8-12" sets="2" heartrate="82" image="image.jpg" audio="audio1.mp3" subtitle="Subtitle text as declared in XML document"></sub>

<sub name="1: Assisted Chin-ups" reps="12" sets="3" heartrate="86" image="XMLexerciseImgTemp.swf" audio="audio2.mp3" subtitle="Second subtitle"></sub>

The contents of the audio files and images or video can be changed by replacing the file name with the one that is required. Make sure the file is located in the directory with the XML file. Change the values of the parameters by altering the text in the areas such as heartrate ="86" to heartrate ="72"


Technical Guide


Customising a Toolbox for single unit deliveryYou may only want to offer one or two units from the Toolbox, or limit access to certain units and/or streams.

To disable access to units, open the competencies.xml file in the front_end folder in Dreamweaver, and remove the reference to the unit you wish to disable. The unit will no longer appear.

To alter what is being shown in the introduction to the competency or scenario open the XML file and edit the content between the appropriate tags

For example changing the content between the <competencyBlurb> </competencyBlurb> tags will alter what the learner sees as an introduction to the competency

<competency>

<competencyTitle>SRFFIT007B - Undertake relevant exercise planning and programming</competencyTitle>

<competencyBlurb>In this competency the learner uses the principles of planning to develop exercise plans for clients. This involves the learner undertaking client screening, the writing of plans to meet specific client needs and then evaluating and modifying the plan once it has been implemented.</competencyBlurb>

If you want to distribute a smaller version by pruning the unnecessary content, you will need to follow the above process, and in addition delete the appropriate folders in the specific scenario or learning resource directory eg fit007_1 directory.

The directories are labelled using the following convention

XXXYYY_# where XXXYYY is the competency code (eg fit007) and # is the number of the scenario in the competency. A learning resource directory has "lr" after the scenario number eg fit007_1_lr2 is the second learning resource in scenario 1 of competency fit007.

To use only one scenario or learning resource, copy the required directory and the whole generic directory at the root level. You can link directly to the XXXYYY_#_0.htm file (eg fit007_1_0.htm) to access the setting the scene file in the scenario rather than entering via the index.htm file.

Keeping to the StandardsThis Toolbox has been developed in accordance with a number of internal conventions and international standards. These standards may be related to accessibility, cross-browser compatibility, or just to enable the easy location and customization of content.

Keep this in mind when you are customizing, as whatever you produce will need to be accessible, cross-browser compatible, and able to be further customized.

Try to ensure that any changes you make are conformant with the following standards.

W3C Priority One - Web Accessibility Initiative - http://www.w3.org/WAI/

HTML 4.01 - http://www.w3.org/TR/1999/REC-html401-19991224/


Technical Guide

http://www.w3.org/TR/1999/REC-html401-19991224/

http://www.w3.org/WAI/


CSS 2 - http://www.w3.org/TR/REC-CSS2/

Visual DesignThis Toolbox uses Cascading style sheets (CSS2) for visual layout and site structure.

If your browser or browsing device does not support style sheets at all, the content and menu structure of each page is still readable. It will be displayed as you browser's default font setting

Standardised images are used as buttons for choice selection, and page navigation. These are located in the generic_res directory of the generic directory at the root level. Replacing these images will replace the buttons globally.

Global formatting with CSS

This Toolbox has been created with Cascading Style Sheets (CSS). This will enable you to make global changes to the look and feel of this Toolbox. If you don’t have a good understanding of HTML and at least a beginner’s level understanding of CSS you may wish to get somebody to help you.

The main CSS file is located at generic\stylesheets\main.css

CSS Style List

H1 - Used at the top of each page for the Competency Name

font: bold 65% arial, helvetica, sans-serif;

color: #FF6600;

background-color: #ffffff;

margin-top: 15px;

border-bottom-width: thin;

border-bottom-style: solid;

border-bottom-color: #064D83;

text-align: right;

text-transform: uppercase;

font-style: italic;

margin-bottom: 15px;

H2 - Used at the top of each page for the Scenario Name


color: #FF6600;


text-align: right;

font-style: italic;

H3 - Provides the heading level for the main title of the page


color: #0C8FBA;



Technical Guide

http://www.w3.org/TR/REC-CSS2/


H4 - Provides the sub heading


color: #064D83;


H5 - Provides a level of emphasis in text areas


color: #333333;


Body - redefines the html text when no other style is applied

font-family: arial, helvetica, sans-serif;

color: #333333;

margin: 10px;

padding: 0px;

background: #ffffff;

You can find out more about CSS at: http://www.htmlhelp.com/reference/css/.

NavigationNavigation between scenes within a scenario uses links to "choices" buttons at the foot of each page. These are direct html links to the other files. They will load the linked page in the current frame in a frame set or the same window if viewing the file outside of a frame set.

The Teachers Guide provides flow diagrams of the paths that learners may follow as they work though the scenarios.

The "scene selector" page that is available from the navigation frame within the scenario framesets loads a selected file into the content frame of the frame set. To customise this file open the scene.htm file in the appropriate scenario generic folder (eg fit007_1_gen directory) in a text editor or Macromedia Dreamweaver. Alter the required link address or the text (shown below as highlighted)

<li><a href="javascript:;" onClick="MM_callJS('swap(\'../fit007_2/fit007_2_2.htm\')')">Access the details of Karen Hendrichs</a></li>


Technical Guide

http://www.htmlhelp.com/reference/css/


File StructureThe root folder has the following sub-folders:

generic which includes all scripts, styles etc that are used in the Toolbox - it must be on every CD or server copy of the Toolbox.

source_code which contains the Flash .fla files. These are not required for viewing the toolbox materials but can be used for customising or creating new resources,

Directories named fit007_1, fit007_2 etc contain scenario based learning content files. These directories contain a folder called fit007_1_res (for example) which contain the associated image, doc and swf files for the files in the parent directory.

Directories named fit007_1_lr1, fit007_1_lr2 etc contain all learning resources materials that are associated with the corresponding scenario directory

Templates which contains macromedia Dreamweaver templates that can be modified and applied to all files based on the template

front_end which contains the flash and xml files for the entry pages.

AccessibilityThe following W3C General (Priority 1) Guidelines are relevant to this toolbox and have been applied.

Text equivalents are provided for every image using "alt" tags.

All information conveyed with colour is also available without colour.

Documents may be read without style sheets.

The Style Sheet redefines HTML tags so all pages will work without style sheets

Clearest and simplest language appropriate for a site's content.

A maximum reading age to grade 8 and readability 70% has been used

Row and column headers are identified for data tables.

Table header tags <th> and "scope" attributes

Frames are titled to facilitate frame identification and navigation.

All frames named with logical frame name eg navigation, content

Pages are usable when scripts, applets, or other programmatic objects are turned off or not supported. Equivalent information on an alternative accessible page is provides where this is not possible.

In this toolbox text only alternative pages provided for flash interactions page with details of the outcomes of interactions.

An auditory description provide of the important information of the visual track of a multimedia presentation.


Technical Guide


In this toolbox audio files and text subtitles are provided in all flash movies. Where an accessible page has not been able to be created a link is provided to an alternative page that uses W3C technologies, is accessible, has equivalent information (or functionality), and is updated as often as the inaccessible (original) page.

The site is compliant with W3C Content Accessibility Priority 1 guidelines, XHTML Transitional.

Each Flash multimedia component has a link from the page in which it is embedded to an associated text only page that describes the activity. This page also gives the results of the activities that the learner carries out in the Flash file. It should be noted than that if the scenarios in the toolbox are being used for assessment purposes it may be appropriate to remove the links to these pages.

Text equivalents of rich elements

All content images used in this site include descriptive ALT attributes. Complex media are supported by a link on the host page to a text only description of the multimedia file. Purely decorative graphics include null ALT attributes. Most flash movies also have an audio and subtitles facility to support low literacy or

Links

Links from a page to other resources from text based links that describe the resource which is being linked to. This enables screen readers to make sense of them out of context.


Technical Guide


Technical SupportTechnical support is available from the help desk, which is detailed at the end of this section, however, before calling, or emailing, please make sure that the answer you seek is not located elsewhere in this section.

Installation on a Web ServerCopy the fit_tb directory and index.htm file (except for autorun.inf , autorun.exe and the source directory) to the appropriate directory on your web server. If you are only copying selected Units to your server or CD, you must make sure the entire generic, front_end and associated folders are also copied as well as the index.htm, index.swf and index.xml files. This will usually involve directory with the same competency code and scenario number (eg all files commencing fit007_1 such as fit007_1, fit_007_gen, fit007_1_lr1 etc)

There are no server side technologies utilised by this Toolbox, so no server configuration will be necessary.

To disable the link to Teacher's Guide

To disable the link to the Teacher's Guide make the following changes to these sections of code in the index.htm file in the fit_tb directory. These are located in the object tag for the flash swf file. Change true to false in the two locations as described below. Make sure no spaces are included.

<param name="movie" value="index.swf?allowButton=true" />

<param name="movie" value="index.swf?allowButton=false" />

and

<embed src="index.swf?allowButton=true" quality="high" bgcolor="#064d83"

<embed src="index.swf?allowButton=false" quality="high" bgcolor="#064d83"

Installing into a SCORM compliant LMSIf you wish to make content from this Toolbox available through your LMS, and your LMS is SCORM compliant, then you can install the relevant Learning Objects (LOs) by using the following process:

1. Browse to the Toolbox Repository at http://Toolbox.flexiblelearning.net.au/.

2. Search on the name of this Toolbox, you will find a number of Learning Objects, each relating to a section of the Toolbox CD.

3. Download each object that you wish to place on your LMS. They will be delivered as IMS content packages, which look exactly like .zip files.

4. Follow your LMS’s specific instructions for uploading these IMS content packages.

Be aware that not all LMSs are SCORM compliant, and that some that claim they are compliant cannot process IMS content packages (therefore they aren’t).

Please refer issues with the uploading of content to your LMS administrator, not the Toolbox Help Desk. The administrator or LMS vendor will contact us if necessary.


Technical Guide

http://toolbox.flexiblelearning.net.au/


Producing CDs for distributionWhether producing one-off copies of CDs, or class sets, use the following procedure:

1. Start up your favourite CD burning software

2. Select the Data CD option (don’t simply copy the whole CD)

3. Drag and drop the content of the fit_tb directory.

4. If you place the autorun.inf and shellexe.exe files in the fit_tb directory the CD should auto start when loaded into a computer.

5. You may wish to delete the teacher guide and technical guide. (See "Installing on a web server" for instructions on how to de-activate teachers guide button.

6. Burn the CD-ROM

Before you burn yourself a class set, it might be wise to test that the first one works as expected.

Known IssuesThe following are known technical issues that users may experience when using this Toolbox.

IIS 6.0 will not serve content of unknown MIME type. Pages display strangely on IE 5.5 due to incompatibilities with it’s

implementation of the CSS standard. Flash detection issues in WebCT (Version x.x) Lotus Notes based training environments don’t allow pop-ups. Issues with pop-up blocking by Windows XP SP2, and others (i.e. Google). Browser printing (right hand edge of page may be cut off). Issues trying to use Dreamweaver templates inside FrontPage. Toolbox does not function correctly when the computer’s power switch is set to

the “OFF” position.

The Help DeskIf you need technical assistance with a Toolbox, a single Help Desk call is all that is needed.

email: [email protected]

phone: 1300 736 710

Before Contacting the Help Desk The Toolbox Help Desk is here to help you with installing Toolboxes and

solving technical issues. Before contacting the Help Desk please assist us by following these steps: Check if your question has already been answered in the Frequently Asked

Questions (FAQs) section of this website. Find the Toolbox stock code that identifies the Toolbox e.g: atp9107 Please provide:

o the Toolbox name and product code o Your name, phone number and email address o The problem you need help with.

The Flexible Learning Toolbox Help Desk will contact you as soon as possible.


Technical Guide


ReferencesW3C (1998). Cascading Style Sheets, level 2, http://www.w3.org/TR/REC-CSS2/..


Technical Guide

http://www.w3.org/TR/REC-CSS2/

Teaching Guide Template - SIelearning · Web viewDocuments may be read without style sheets. The...

Documents

Transcript of Teaching Guide Template - SIelearning · Web viewDocuments may be read without style sheets. The...