<div>Hello Deborah,<br></div><div><br></div><div>Thanks for the idea of adding the optional automatic narration parameter, I will aim to add it to all the page wizards that use narration in the next release.</div><div><br>
</div><div>I remember some discussion on the mail list that suggested that there may be some changes to the code that is used to implement narration, but as yet the current version of Xerte still uses the same code. Hence I have made no changes to narrationHandler.rlm. Should there be any changes to how the PageTemplates project wide template delivers narration in a future release then there may be an update to narrationHandler.rlm.</div>
<div><br></div><div>New Page Wizards cannot update existing pages in Xerte projects, as a Page Wizard is only used as a source of information by Xerte from which to create a new page, so existing pages are unaffected by an update to the Page Wizards.</div>
<div><br></div><div>
<div>The changes to a Page Wizard that provide support for optional automatic narration are all within the code of the page wizard (an extra line in the xwd file to implement the optional parameter and a small change to the getPageId code block that adds an extra "if" condition to the section that implements narration) so no change to the narrationHandler is required.</div>
<div><br></div><div><strong>Adding auto Narration to any existing page that offers narration</strong></div></div><div>If you wanted to add auto Narration to an existing page in one of your projects then this would be a simple 2 step process</div>
<div><br></div><div>Step 1 - add the optional parameter "narPlayback" to the xwd file. Simply open the xwd file in your favourite editor (not a word processor) - I use FlashDevelop and insert the line below, after the narration optional parameter, then save your change.</div>
<div><br></div><div>
<div><font color="#3366ff"><narPlayback type="ComboBox" label="Narration Playback" options="On user request,On page load" data="userRequest,pageLoad" defaultValue="On user request" width="150" optional="true"/></font><br>
<br></div><div>Step 2 - add an additional "if" block to the narration code in getPageId. Do this in Xerte by expanding the page structure and selecting the getPageId script icon.<br></div><div><br></div><div>// Old page version - no auto narration option</div>
<div><br></div><div>if (pageIcon.templateData.learningObject[0].modelAnswer[0].narration != undefined){<br> narration = pageIcon.templateData.learningObject[0].modelAnswer[0].narration;<br> rootIcon.broadcast('showAudio');<br>
}<br></div><div><br></div><div>// sample version from new version of gapFill Page Wizard</div><div><br></div><div>if (pageIcon.templateData.learningObject[0].gapFill[0].narration != undefined){<br> narration = pageIcon.templateData.learningObject[0].gapFill[0].narration;<br>
rootIcon.broadcast('showAudio');<br><br><font color="#3366ff"> if (pageIcon.templateData.learningObject[0].gapFill[0].narPlayback != undefined && pageIcon.templateData.learningObject[0].gapFill[0].narPlayback == "pageLoad"){<br>
nar.play();<br> }</font><br><br>}<br></div><div><br></div><div>The bit shown in blue above could be added to any page wizard that offers narration, you would just need to edit the references to the page wizard name to match the current page wizard, e.g. for modelAnswer code shown earlier would become</div>
<div><br></div><div>
if (pageIcon.templateData.learningObject[0].modelAnswer[0].narration != undefined){<br> narration = pageIcon.templateData.learningObject[0].modelAnswer[0].narration;<br> rootIcon.broadcast('showAudio');</div><div>
<br></div><div>
<font color="#3366ff"> if (pageIcon.templateData.learningObject[0].</font>
modelAnswer
<font color="#3366ff">[0].narPlayback != undefined && pageIcon.templateData.learningObject[0].</font>
modelAnswer
<font color="#3366ff">[0].narPlayback == "pageLoad"){<br> nar.play();<br> }</font>
</div><div><br>}</div></div><div>That should give your page auto narration option capability. Note the first two lines shown above are actually all one long line.</div><div><br></div><div><strong>Updating an existing page to use the new version of a Page Wizard</strong></div>
<div><br></div><div>If you wanted to update a learning object to take advantage of new features in a Page wizard then you could try the following.</div><div><br></div><div>Given an existing page called currentPage with its files saved in folder pages / currentPage</div>
<div><br></div><div>1 . Create a new page using the new version of the Page Wizard saving its files to pages / newPage</div><div><br></div><div>this would give you a folder pages / newPage containing the Page Wizard's .xml, .xwd and .rlm files</div>
<div><br></div><div>2. Rename the .xml file to something like orig.xml</div><div><br></div><div>3. Copy the .xml file from pages / currentPage to pages / newPage</div><div><br></div><div>This should give you a new copy of your original page that uses the new code for the page, has the new xwd file but benefits from all the settings of your original page.</div>
<div><br></div><div>But a word of warning. This should work in most instances of new page wizards, one thing could cause a problem.</div><div><br></div><div>If the new Version of the page wizard includes any new parameters that are NOT optional. </div>
<div><br></div><div>If the new version of the Page Wizard includes a non-optional parameter that did not exist in the previous version then the wizard may malfunction. To resolve the malfunction look in the original xml file (renamed to orig.xml above and identify the missing parameters. These will need to be copied into the active xml file i.e the copy from your original page.</div>
<div><br></div><div>Whether it is worth updating a page will probably depend on the changes that the new wizard introduces.</div><div><br></div><div>Hope this helps to answer your questions.</div><div><br></div><div>Kind regards</div>
<div><br></div><div>Johnathan</div><div><br></div><div>PS. Don't worry about asking silly questions - just ask for clarification if my answers are not adequate to meet your needs.</div><div> </div><div><br></div><div>
<br></div><br><div class="gmail_quote">On 20 April 2011 11:20, Deborah Delin <span dir="ltr"><<a href="mailto:admin@strivney.com">admin@strivney.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div dir="ltr"><font color="#000066"><font face="verdana,sans-serif">Hi Jonathan,</font></font><div><font color="#000066"><font face="verdana,sans-serif"><br></font></font></div><div><font color="#000066"><font face="verdana,sans-serif">Thanks very much for the new Page Wizards release. Great to have an optional parameter to specify automatic narration!</font></font></div>
<div><font color="#000066"><font face="verdana,sans-serif"><br></font></font></div><div><font color="#000066"><font face="verdana,sans-serif">Sorry if this is a silly question: I have downloaded the new release and replaced the files in my Xerte folder, but, in order for existing learning objects to be affected by the changes in the new release, do I have to re-create the learning objects from scratch? The release didn't contain a new narration handler - wouldn't I need to add an updated narration handler to the rlo? </font></font></div>
<div><font color="#000066"><font face="verdana,sans-serif"><br></font></font></div><div><font color="#000066"><font face="verdana,sans-serif">Thanks in advance for your reply. <br clear="all"></font></font><br>-- <br><div dir="ltr">
<div style="text-align:center"><div style="text-align:left"><font face="verdana, sans-serif"><font color="#333399">Deborah <br> <br></font></font></div></div></div>
<br>
</div></div>
<br>
<p>
This message and any attachment are intended solely for the addressee and may
contain confidential information. If you have received this message in error,
please send it back to me, and immediately delete it. Please do not use,
copy or disclose the information contained in this message or in any attachment.
Any views or opinions expressed by the author of this email do not necessarily
reflect the views of the University of Nottingham.
</p>
<p>
This message has been checked for viruses but the contents of an attachment
may still contain software viruses which could damage your computer system:
you are advised to perform your own checks. Email communications with the
University of Nottingham may be monitored as permitted by UK legislation.
</p>
<br>_______________________________________________<br>
Xerte mailing list<br>
<a href="mailto:Xerte@lists.nottingham.ac.uk">Xerte@lists.nottingham.ac.uk</a><br>
<a href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte" target="_blank">http://lists.nottingham.ac.uk/mailman/listinfo/xerte</a><br>
<br>
This message and any attachment are intended solely for the addressee and may contain confidential information. If you have received this message in error, please send it back to me, and immediately delete it. Please do not use, copy or disclose the information contained in this message or in any attachment. Any views or opinions expressed by the author of this email do not necessarily reflect the views of the University of Nottingham.<br>
<br>
This message has been checked for viruses but the contents of an attachment<br>
may still contain software viruses which could damage your computer system:<br>
you are advised to perform your own checks. Email communications with the<br>
University of Nottingham may be monitored as permitted by UK legislation.<br>
<br>
<br></blockquote></div><br>