Deadly Jam Music Toolbox - SIelearning€¦ · Web viewTo install the Deadly Jam ... The...

Deadly Jam Music Toolbox

Technical Guide

Table of Contents

Toolbox Installation 2

Viewer Requirements 3

Directory Structure of the Toolbox 4

Overall Structure 4

Individual Unit Structure 5

` Customisation 6

Delivering Individual Units 6

Changing the order of screens within each unit 6

Changing the contents of individual pages 7

Customising the Shockwave Based Activities 7

Customising the Quiz 7

Customising the Worksheets 8

Customising the Glossary 9

Appendix I – List of Worksheets 10

Appendix II – List of Shockwave Activities 12

Deadly Jam Music Toolbox – Technical Guide 1

Toolbox Installation

To install the Deadly Jam Music Toolbox onto your server, please follow these steps:

1. Insert the Deadly Jam Music Toolbox Cd-rom into your Cd-rom drive

2. Open a directory browser on the server and navigate to the Cd-rom drive

3. Copy all files and directories from the ‘Web’ folder of the Cd-rom to the appropriate directory on your server. If you wish to only make specific units of the Deadly Jam Music Toolbox available on your server, please consult the Customisation section of this document.

The Deadly Jam Music Toolbox does not require any server side technologies. It is not necessary to install any programs or components on your server. Access to the Toolbox material is simply a matter of opening a web browser and accessing the appropriate directory on your server.

If you make changes to the names of files or directories within the Deadly Jam Music Toolbox you will need to update the appropriate links and paths through-out all of the units within the toolbox.

If you have trouble accessing the content in the toolbox, it may be necessary to set the appropriate mime types for various toolbox elements. The mime types required by this toolbox are as follows:

Director Shockwave .dcr application/x-directorFlash Shockwave .swf application/x-shockwave-flashHTML .html text/htmlCascading Style Sheets .css text/css

JavaScript .js application/x-javascriptXML .xml text/xml

These mime types are likely to be already set for most installations


Viewer Requirements

In order to access the Deadly Jam Music Toolbox users need a computer that meets or exceeds the following specifications:

o IBM compatible computer with 300 MHz processor (OR Macintosh equivalent)

o 64 Mb of RAMo 800 x 600 - 16bit colour display (1024 x 768 recommended)o CD ROM driveo 85 mgb hard disk spaceo Recommended 56k modem or bettero Sound card and Speakerso Internet Browser: Netscape version 6.2 or Internet Explorer 5 or highero JavaScript and CSS support enabledo Adobe Acrobat Reader (version 5 or higher)o Macromedia Flash Player (version 6.0.29 or higher)o Macromedia Shockwave Player (version 8.5 or higher)

The browser plugins that are listed above are available at the following URLs:

o Macromedia Shockwave Playero www.macromedia.com/go/getshockwaveplayer

o Macromedia Flash Playero www.macromedia.com/go/getflashplayer

o Adobe Acrobat Readero www.adobe.com/products/acrobat/readstep.html


http://www.adobe.com/products/acrobat/readstep.html

http://www.macromedia.com/go/getflashplayer

http://www.macromedia.com/go/getshockwaveplayer

Directory Structure of the Toolbox

Overall Structureindex.html Entry page for the toolbox

./_config/This directory contains a variety of assets which are shared through-out the units of the toolbox. This includes css files and swf files amongst other things. This folder is always required.

./_homeimg/This folder contains image and flash elements that are used on the home page of the site. These assets are not used in any other site pages

./_sharedimg/The directory contains all the image elements that are shared through-out the toolbox. These images are used on multiple pages and include the template design. This folder is always required.

./backstage/The backstage directory is the area specified for communication tools such as the discussion board. This contains a single guide page only.

./bandmananger/This directory contains all material for the Band Manager pathway of the Toolbox. This contains three units along with the pathway index and images.

./eventmanager/This directory contains all material for the Event Manager pathway of the Toolbox. This contains four units along with the pathway index and images.

./expert/ This directory contains the information about the various experts who are featured through-out the toolbox.

./musician/This directory contains all material for the Musicians pathway of the Toolbox. This contains six units along with the pathway index and images.

./site/This folder contains the various pages which support the toolbox. This consists of a series of HTML pages. Pages such as help, credits, disclaimer are found here

./soundtechnician/This directory contains all material for the Sound Technician pathway of the Toolbox. This contains four units along with the pathway index and images.

./teacher/This directory contains the material for the teacher section of the toolbox. This includes the teacher’s guide as well as links to the competencies.

./templates/This directory contains various Dreamweaver templates. These are helpful for HTML developers using Dreamweaver to update site elements.


Each of the units within the four pathways has been developed with a common structure which is outlined below:

Individual Unit Structureindex.html This is the start page for the particular unit.

Other html pages

The various sections of the unit are all found at the root level of the unit directory along with the html for any pop-up windows. The page names for the sections of each unit are preceeded with a number to show the current order. Pages without numbers at the start of the title are the pop-up pages

./imgs/ This folder contains all the static image elements which are specifically used in the unit.

./pdf/ This folder contains all the worksheets which are specific to each unit. These worksheets are provided in PDF format

./quiz/

This directory contains a single XML file and a series of images which are used in the unit quiz. Each unit can have a quiz with up to ten questions. Please see the customization section of this document for further information.

./shockwave/ This directory contains all Flash and Director Shockwave files which are used in the unit.

./video/

This directory contains all video assets that are used in each unit. The video is played through a shared player (located in _config) with the content being in this folder. It consists of XML files to describe each video set with SWF files for each video clip.


Customisation

To fully customise the Deadly Jam Music Toolbox, you will need to edit the HTML files using an HTML editor such as Dreamweaver, Front Page, Homesite, or even a text-based editor such as Notepad. Dreamweaver Templates have been supplied to assist the customization process for those using Dreamweaver

Some interactions are designed using JavaScript, a language used to create interactive web pages. Anyone with a working knowledge of JavaScript can edit these interactions.

A vast number of activities in the Deadly Jam Music Toolbox have been created using Macromedia Flash. These activities can be customised by a developer using Macromedia Flash MX. The ‘Riff King’ activity in the Musicians strand has been created using Macromedia Director 8.5 and as such it can only be customised by someone proficient with this program.

If these activities are deemed as unsuitable to the target audience they can be removed from the toolbox by editing the HTML of the page that contains the activity.

Delivering individual units

The Deadly Jam Music Toolbox has been structured to allow for you to choose which units you wish to deliver on your server. The units have all been assembled in their own directories within each of the four pathways:

o Musicians (6 units)o Band Manager (3 units)o Event Manager (3 units)o Sound Technician (4 units)

In each of the pathways there is a single directory. In order to deliver a single unit you can copy that directory to the server along with the shared directories (‘_config’ and ‘_sharedimg’). For more information about the individual directories please consult the ‘Directory Structure’ section of this document.

Changing the Order of Screens within each unit

The order of each unit within the Deadly Jam Music Toolbox has been created to help facilitate the progression of content in each unit. If it is desireable to change the order of content within an individual unit you can follow the following steps:

o Change the order of the links located on the introduction screen of the unit in question. This file will be index.html within the specific unit directory


o Change the forward and back navigation links on the all pages affected by the order change. Page filenames can also be changed if required.

If you wish to remove a page from view within a particular unit, the simplest method is to remove the link on the introductory screen and to change the ‘forward’ link on the page prior to the page being removed and to change the ‘back’ link on the page that follows the page to be removed.

Changing the Contents of the Individual Pages

The contents of each page within all units of the Deadly Jam Music Toolbox are displayed as HTML documents. To change the order of content on a page or to add or remove content you will need to use a text editor or HTML editor (such as Dreamweaver) to edit the page.

All graphics, worksheets and activities are located in the sub directories of the unit directory (see the Directory Structure section of this document). These items may also be edited.

Customising the Shockwave Based Activities

The various interactive activities through-out the Deadly Jam Music Toolbox have been authored using Macromedia Flash MX and Macromedia Director 8.5. These activities can be customised by developers with access to those particular software packages. The content of the Quiz for each unit can be customised without requiring Flash MX (please see the following section for further detail).

A full list of the Shockwave based activities is located in Appendix II of this document. The source files for each of these activities is located in the ‘Source’ folder of the Deadly Jam Music Toolbox Cd-rom. The source files can be found in the directory corresponding to the unit that they exist in within the Toolbox. For example an activity located in the ‘m1’ unit will have source files located in the m1 directory within the ‘musicians’ directory of the ‘Source’ directory.

Customising the Quiz

The final page in each of the units that make up the Deadly Jam Music Toolbox is ‘Test, Reflect and Share’. A key component of this page is a quiz activity. The quiz has been developed using Flash MX with the content for each of the questions being stored in separate XML files.

The content can be changed by edited these XML files using any text editor. Each unit has a ‘quiz’ sub-directory which contains the XML file and associated


images. Each quiz can contain up to 10 questions which each have four possible answers.

The data structure of the quiz XML file can be viewed by opening any of the quiz files located in the Deadly Jam Music Toolbox. An outline of the structure is as follows:

o datao question container (<question>)

text of question (<qtext>) image for question (<qimage>) answer for question (<qanswer>) answer choices (<qchoices>)

choice A (<choice id=”A”>) choice B (<choice id=”B”>) choice C (<choice id=”C”>) choice D (<choice id=”D”>)

Each question has seven elements, as shown above, within the question container. The content of each question container can be edited by editing the text that appears between the various xml tags. For example a question is shown as follows:

<qtext>This is a Question</qtext>

This can be edited by editing the text that is shown in italics. The XML tags should be left as they are. The image reference refers to a jpg image that should be placed in the quiz folder with other images and the XML file. Any images used should be saved in JPG format and be 180 pixels wide and 180 pixels high. The image may be used to illustrate the concept or as a specific part of the question.

Customising the Worksheets

Worksheets have been made available through-out the Deadly Jam Music Toolbox as Adobe Acrobat PDF files. These files are located in the ‘pdf’ folder of each of the specific units.

In order to customize the Worksheets you can access the ‘Source’ directory of the Deadly Jam Music Toolbox Cd-rom where they are all located in original Microsoft Word format. A full list of all worksheets within the Toolbox can be found in Appendix I of this document.

The source files can be found in the directory corresponding to the unit that they exist in within the Toolbox. For example a worksheet located in the ‘m1’ unit will


have a Microsoft Word version of the file located in the m1 directory within the ‘musicians’ directory of the ‘Source’ directory.

Customising the Glossary

The Deadly Jam Music Toolbox includes a comprehensive glossary which is split over four html pages. To add, edit or remove glossary terms you will need to edit the appropriate html file for the list below. These html files are located in the ‘site’ folder of the Toolbox.

Glossary Filesglossary.html Contains terms that begin with A, B, C, Dglossary2.html Contains terms that begin with E, F, G, H, I, J, K, Lglossary3.html Contains terms that begin with M, N, O, Pglossary4.html Contains terms that begin with Q, R, S, T, U, V, W, X


Appendix I – List of Worksheets

The following table lists all of the PDF Worksheets that are available through-out the Cd-rom. Microsoft Word versions of these documents are available in the ‘Source’ directory of the Cd-rom.

Musicians Pathwaym1 – guitar Tuning Worksheet

m1 – chords Open Chords Worksheet

m1 – chords Chord Reference Sheet

m1 – rhythm guitar Chord Progression Worksheet

m2 – song structure Song Structure Worksheet

m2 – ideas for your song Lyrics Worksheet

m2 – copyrighting your song Written Agreement

m2 – copyrighting your song Copyright Worksheet

m3 – starting out Starting Out Worksheet

m3 – finding new members Finding New Members Worksheet

m3 – auditioning Auditioning Worksheet

m4 – planning to record Studio Feedback and Project Budget Worksheet

m5 – find a venue Festival Application Form

m6 – choosing a manager Written Agreement

m6 – choosing a manager Booking Contract Worksheet

m6 – choosing a manager Application Form

Band Manger Pathwayb1 – negotiating deals Baggage Limits

b1 – negotiating deals Festival Budget Worksheet

b1 – applications and contracts Application Form

b1 – applications and contracts Booking Contract Worksheet

b1 – applications and contracts Application Form

b1 – preparing for a gig Band Contact Sheet

b1 – preparing for a gig Rehearsal Room Booking Sheet

b1 – preparing for a gig Press Release

b1 – preparing for a gig Press Release Worksheet

b2 – the big gig Industry Contact List

b3 – administration Tax Invoice

b3 – administration Tax Invoice Worksheet


Sound Technician Pathways2 – analyse audio requirements Festival Details

s2 – plan the P.A equipment Audio Specifications

s2 – plan the P.A equipment Planning the PA Worksheet

s3 – roles and responsibilities Roles and Responsibilities Worksheet

s3 – final preparations Audio Specifications

s3 – final preparations Band Specifications

s3 – final preparations Running Sheet

s3 – final preparations Project Schedule Worksheet

s4 – packing up Tax Invoice Worksheet

Event Manager Pathwaye1 – roles and responsibilities Funding Application Worksheet Section 1

e1 – roles and responsibilities Funding Application Worksheet Section 2

e1 – budget and funding Funding Application Worksheet Section 3

e2 – festival artists Booking Contract

e2 – festival artists Schedule Sheet

e3 – communication Chain of Command Worksheet

e3 – production and logistics Schedule Template

e3 – production and logistics Running Sheet

e4 – final tasks Packing up Worksheet

e4 – final review Festival Acquittal Report Worksheet


Appendix II – List of Shockwave Activities

The following table lists all of the Shockwave based interactive resources that are available through-out the Cd-rom. These activities have been all been developed with Macromedia Flash MX with the exception of ‘Riff King’ which was developed with Macromedia Director 8.5.

Musicians Pathwaym1 – guitar Types of Guitar Activity

m1 – guitar Guitar Parts Activity

m1 – chords Open Chords Activity

m1 – chords Open Chords Assessment Activity

m1 – chords Barre Chords Activity

m1 – rhythm guitar Chord Progression Activity

m1 – lead guitar Riff King Activity

m2 – ideas for your song Chord Progression Activity

m2 – ideas for your song Melody Activity

m2 – remembering ideas Writing a Lead Sheet Activity

m3 – starting out Getting Together Activity

m3 – auditioning Forming a Band Activity

m4 – planning to record Recording Studios Activity

m4 – recording Mixing Desk Activity

m5 – promotional package Promotional Package Activity

m5 – performing Set List Activity

m6 – choosing a manager Answering Machine Activity

Band Manger Pathwayb1 – negotiating deals Travel and Accommodation Expenses Activity

b1 – applications and contracts Answering Machine Activity

b1 – applications and contracts Stage Plan Activity

b2 – the big gig Set List Activity

Sound Technician Pathways1 – dealing with enquiries Email Activity

s2 – analyse audio requirements Stage Plan Activity

s2 – plan the P.A equipment Equipment List Activity

s2 – quoting Quote Activity


s4 – packing a truck Loading the Truck Activity

s4 – mixing the gig Mixing Desk Activity

Event Manager Pathwaye1 – roles and responsibilities Committee Roles and Responsibilities Activity

e1 – budget and funding Budgeting for a Festival Activity

e2 – festival artists Stage Plan Activity

e2 – marketing and promotion Festival Brochure Activity

e2 – infrastructure Setting up Festival Site Activity

e3 – communication Chain of Command Activity

e4 – final tasks Removing Infrastructure Activity


Deadly Jam Music Toolbox - SIelearning€¦ · Web viewTo install the Deadly Jam ... The...

Documents

Transcript of Deadly Jam Music Toolbox - SIelearning€¦ · Web viewTo install the Deadly Jam ... The...