<?xml version="1.0" encoding="ISO-8859-1"?>
<?xml-stylesheet type="text/xsl" href="sourcefiles.xsl" ?>
<hotpot-documentation>
<title>Documentation for Hot Potatoes Source Files and Placeholders</title>
<introduction>
This file contains two main components: a list of source files (templates) used to create Hot Potatoes exercises, and a list of the placeholders inside those files, which are replaced with key exercise data when the exercise pages are built. The two tables are linked to each other so you can easily move between descriptions of source files and explanations of the placeholders they contain. You can use this information to help you customize the source files, in order to change the appearance or behaviour of the exercises to suit your own situation.
</introduction>
<source-file-list>
<title>List of source files</title>
<sf>
<name>hp6plainpage</name>
<extension>ht_</extension>
<explanation>This file is used by the Masher to create a plain HTML page using the basic Hot Potatoes exercise layout and style settings.</explanation>
</sf>
<sf>
<name>hp6</name>
<extension>cs_</extension>
<explanation>All of the CSS stylesheet code used in all the exercises. Most of it is general, but some selectors and styles are specific to one or more exercise types only.</explanation>
</sf>
<sf>
<name>hotpot6r</name>
<extension>ht_</extension>
<explanation>This file is used as the basis for the reading text component of an exercise.</explanation>
</sf>
<sf>
<name>jcloze6</name>
<extension>ht_</extension>
<explanation>The core HTML code used to create a standard JCloze exercise.</explanation>
</sf>
<sf>
<name>jcross6</name>
<extension>ht_</extension>
<explanation>The core HTML code used to create a standard JCross exercise.</explanation>
</sf>
<sf>
<name>jmatch6</name>
<extension>ht_</extension>
<explanation>The core HTML code used to create a standard JMatch exercise.</explanation>
</sf>
<sf>
<name>djmatch6</name>
<extension>ht_</extension>
<explanation>The core HTML code used to create a drag-drop JMatch exercise.</explanation>
</sf>
<sf>
<name>fjmatch6</name>
<extension>ht_</extension>
<explanation>The core HTML code used to create a flashcard JMatch exercise.</explanation>
</sf>
<sf>
<name>jmix6</name>
<extension>ht_</extension>
<explanation>	The core HTML code used to create a standard JMix exercise.</explanation>
</sf>
<sf>
<name>djmix6</name>
<extension>ht_</extension>
<explanation>The core HTML code used to create a drag-drop JMix exercise.</explanation>
</sf>
<sf>
<name>jquiz6</name>
<extension>ht_</extension>
<explanation>The core HTML code used to create a standard JQuiz exercise.</explanation>
</sf>
<sf>
<name>hp6navbar</name>
<extension>ht_</extension>
<explanation>The HTML code used to add navigation bars to all exercise types. Also used by the Masher when it adds navigation bars to non-Hot Potatoes pages.</explanation>
</sf>
<sf>
<name>hp6objecttags</name>
<extension>ht_</extension>
<explanation>Blocks of HTML code used by the Insert Media Object function in the Potato programs to create media player objects. Not used when exporting to create Web pages.</explanation>
</sf>
<sf>
<name>jcross6print</name>
<extension>ht_</extension>
<explanation>The source file for the JCross Export For Printing function on the File menu.</explanation>
</sf>
<sf>
<name>masher</name>
<extension>ht_</extension>
<explanation>HTML code used by the Masher to create its Index page.</explanation>
</sf>
<sf>
<name>mashernav</name>
<extension>ht_</extension>
<explanation>HTML code used by the Masher when it adds navigation bars to non-Hot Potatoes HTML pages.</explanation>
</sf>
<sf>
<name>jcloze6</name>
<extension>js_</extension>
<explanation>The core JavaScript code used to create a standard JCloze exercise.</explanation>
</sf>
<sf>
<name>jcross6</name>
<extension>js_</extension>
<explanation>The core JavaScript code used to create a standard JCross exercise.</explanation>
</sf>
<sf>
<name>jmatch6</name>
<extension>js_</extension>
<explanation>The core JavaScript code used to create a standard JMatch exercise.</explanation>
</sf>
<sf>
<name>djmatch6</name>
<extension>js_</extension>
<explanation>The core JavaScript code used to create a drag-drop JMatch exercise.</explanation>
</sf>
<sf>
<name>fjmatch6</name>
<extension>js_</extension>
<explanation>The core JavaScript code used to create a flashcard JMatch exercise.</explanation>
</sf>
<sf>
<name>jmix6</name>
<extension>js_</extension>
<explanation>	The core JavaScript code used to create a standard JMix exercise.</explanation>
</sf>
<sf>
<name>djmix6</name>
<extension>js_</extension>
<explanation>The core JavaScript code used to create a drag-drop JMix exercise.</explanation>
</sf>
<sf>
<name>jquiz6</name>
<extension>js_</extension>
<explanation>The core JavaScript code used to create a standard JQuiz exercise.</explanation>
</sf>
<sf>
<name>hp6browsercheck</name>
<extension>js_</extension>
<explanation>JavaScript code included in every page, used for "sniffing" the browser version so that other functions can allow for slight differences between browsers. You can test this code by loading the <strong>testbrowsercheck.htm</strong> file in your browser.</explanation>
</sf>
<sf>
<name>hp6buttons</name>
<extension>js_</extension>
<explanation>JavaScript code included in every page, used for controlling the behaviour of navigation and function buttons on the page. This controls the changing of the button styles when you mouseover a button, or click it.</explanation>
</sf>
<sf>
<name>hp6card</name>
<extension>js_</extension>
<explanation>JavaScript code included in drag-drop pages, used for handling the drag-drop behaviour.</explanation>
</sf>
<sf>
<name>hp6checkshortanswer</name>
<extension>js_</extension>
<explanation>JavaScript code included in JQuiz pages that have short-answer or hybrid question types, used for checking guesses against predicted right and wrong answer sets.</explanation>
</sf>
<sf>
<name>hp6hotpotnet</name>
<extension>js_</extension>
<explanation>JavaScript code included in all pages, which handles communication with the hotpotatoes.net server.</explanation>
</sf>
<sf>
<name>hp6sendresults</name>
<extension>js_</extension>
<explanation>JavaScript code included exercises when you use the CGI submission options in the configuration screen to send results to the FormMail.pl PERL script. There is no support for this code.</explanation>
</sf>
<sf>
<name>hp6showmessage</name>
<extension>js_</extension>
<explanation>JavaScript code used to pop up the feedback messages in all exercises.</explanation>
</sf>
<sf>
<name>hp6timer</name>
<extension>js_</extension>
<explanation>JavaScript code included exercises when you use the timer option in the configuration screen. This controls display and countdown of the timer, and what happens when the time runs out.</explanation>
</sf>
<sf>
<name>hp6utilities</name>
<extension>js_</extension>
<explanation>A range of multi-purpose JavaScript functions used in all the exercises.</explanation>
</sf>
<sf>
<name>scorm_1_2</name>
<extension>js_</extension>
<explanation>JavaScript functions used to communicate with a SCORM-compliant LMS (VLE) system. This code is included in an exercise if you choose to create a SCORM package (from the File menu) or if you check "Include SCORM 1.2 support" in the Configuration screen.</explanation>
</sf>
</source-file-list>

<placeholder-list>
<title>List of placeholders used in source files (not yet complete)</title>
<ph>
<name>[strTitleColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the "title colour" setting chosen in the configuration screen. Becomes the font colour setting for the title area of the page.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>masher.ht_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>hp6sendresults.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strTextColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the "text colour" setting chosen in the configuration screen. Becomes the font colour setting for the body of the page (the exercise area).</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>masher.ht_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>hp6sendresults.js_</sfn>
<sfn>hp6card.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strExBGColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the "exercise background colour" setting chosen in the configuration screen. Becomes the background colour setting for the body of the page (the exercise area).</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>hp6card.js_</sfn>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strPageBGColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the "page background colour" setting chosen in the configuration screen. Becomes the background colour setting for the outer areas of the page (outside the the exercise area).</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>hp6sendresults.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strGraphicURL]</name>
<type>text; relative or absolute URL</type>
<explanation>Replaced by the "background graphic URL" setting chosen in the configuration screen. Becomes the background graphic for the outer areas of the page (outside the the exercise area).</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strFontFace]</name>
<type>text; one or more comma-separated font names or families</type>
<explanation>Replaced by the "output font face" setting chosen in the configuration screen. Becomes the core font selection for the page.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>masher.ht_</sfn>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strFuncLightColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the colour used for the top and left borders of function buttons on the page.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
</used-in>
</ph>
<ph>
<name>[strFuncShadeColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the colour used for the bottom and right borders of function buttons on the page.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
</used-in>
</ph>
<ph>
<name>[strNavLightColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the colour used for the top and left borders of navigation buttons on the page.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
</used-in>
</ph>
<ph>
<name>[strNavShadeColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the colour used for the bottom and right borders of navigation buttons on the page.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
</used-in>
</ph>
<ph>
<name>[strNavBarColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the colour used for the background of the navigation bar.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
</used-in>
</ph>
<ph>
<name>[strLinkColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the colour used for HTML links included in pages.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strVLinkColor]</name>
<type>text; HTML colour designation</type>
<explanation>Replaced by the colour used for visited HTML links included in pages.</explanation>
<used-in>
<sfn>hp6.cs_</sfn>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strDublinCoreMetadata]</name>
<type>text; HTML meta tags</type>
<explanation>Replaced by meta tags formed from the Dublin Core metadata entered in the metadata screen.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strPlainTitle]</name>
<type>text</type>
<explanation>This is found in the HTML title tag in the page head tag. It is replaced by the exercise title, but without any HTML tags that may have been included in the title. The tags are removed because the title text is usually displayed in the caption of the Web browser, and tags would not function in that context.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strHeaderCode]</name>
<type>text; HTML code</type>
<explanation>This is found in the HTML page head tag. It is replaced by whatever is typed into the "header code" text box in the User Strings section of the configuration screen. It would normally be used to add custom stylesheets or JavaScript functions to the page.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
<sfn>hp6plainpage.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strUserDefined1], [strUserDefined2], [strUserDefined3]</name>
<type>text; anything, depending on the user</type>
<explanation>These placeholders are not actually found in any of the source files, but you can insert them yourself, and then use them as instructed in the Hot Potatoes documentation for the User-Defined Strings functionality.</explanation>
<used-in>
</used-in>
</ph>
<ph>
<name>[strStyleSheet]</name>
<type>text; CSS code</type>
<explanation>This is found in the style element in the HTML page head tag. It is replaced by the CSS code in the hp6.cs_ file.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
<sfn>hp6plainpage.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strJS.....]</name>
<type>text; JavaScript code</type>
<explanation>Placeholders with the form [strJS....], such as [strJSBrowserCheck], are found in the script element in the HTML page head tag. They are replaced by the JavaScript code in the related .js_ file (so [strJSBrowserCheck] is replaced by the contents of hp6browsercheck.js_).</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strExerciseTitle]</name>
<type>text; HTML code</type>
<explanation>This is replaced by the title of the exercise.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jcross6print.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
<sfn>hp6sendresults.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strExerciseSubtitle]</name>
<type>text; HTML code</type>
<explanation>This is replaced by the subtitle of the exercise, from the Configuration screen.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jcross6print.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strInstructions]</name>
<type>text; HTML code</type>
<explanation>This is replaced by the instructions for the exercise, from the Configuration screen.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strCheckCaption]</name>
<type>text; Button caption; HTML code</type>
<explanation>This is replaced by the Check button caption setting from the Configuration screen. In JQuiz, this placeholder is not actually in the source file; it's generated by the output routine and placed into the source file code, then replaced later in the output procedure.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strOKCaption]</name>
<type>text; Button caption; HTML code</type>
<explanation>This is replaced by the OK button caption setting from the Configuration screen.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strRestartCaption]</name>
<type>text; Button caption; HTML code</type>
<explanation>This is replaced by the Restart button caption setting from the Configuration screen in JMix.</explanation>
<used-in>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strUndoCaption]</name>
<type>text; Button caption; HTML code</type>
<explanation>This is replaced by the Undo button caption setting from the Configuration screen in JMix.</explanation>
<used-in>
<sfn>jmix6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strHintCaption]</name>
<type>text; Button caption; HTML code</type>
<explanation>This is replaced by the Hint button caption setting from the Configuration screen.</explanation>
<used-in>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strGuessCorrect]</name>
<type>text; Message; HTML code</type>
<explanation>This is replaced by the "Your guess is correct" setting from the Configuration screen.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>jmix6.js_</sfn>
<sfn>djmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strGuessIncorrect]</name>
<type>text; Message; HTML code</type>
<explanation>This is replaced by the "Your guess is incorrect" setting from the Configuration screen.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>jmix6.js_</sfn>
<sfn>djmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strYourScoreIs]</name>
<type>text; Message; HTML code</type>
<explanation>This is replaced by the "Your score is: " setting from the Configuration screen.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>jmix6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>jquiz6.js_</sfn>
<sfn>jcloze6.js_</sfn>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[boolShuffleQs]</name>
<type>Boolean (true/false)</type>
<explanation>This is what determines whether the sequence of items on the page will be shuffled or not when the page loads. It is set by the equivalent setting in the configuration screen.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>fjmatch6.js_</sfn>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[boolShuffleAs]</name>
<type>Boolean (true/false)</type>
<explanation>This is what determines whether the sequence of answers in each question on the page will be shuffled or not when the page loads. It is set by the equivalent setting in the configuration screen.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[QsToShow]</name>
<type>integer</type>
<explanation>This is what determines how many questions will be shown, randomly selected from the total number of questions in the exercise. It is set by the equivalent setting in the configuration screen.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[PreloadImageList]</name>
<type>text; list of image names</type>
<explanation>May be obsolete. Used to preload lists of graphic files used in the page, but this may not be necessary in XHTML pages. If this proves to be the case, it will be removed.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>fjmatch6.js_</sfn>
<sfn>jmix6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>jquiz6.js_</sfn>
<sfn>jcloze6.js_</sfn>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[FixedArray]</name>
<type>text; JavaScript array</type>
<explanation>Array of items used for the left side of a JMatch drag-drop exercise. This array is created and inserted during the export routine.</explanation>
<used-in>
<sfn>djmatch6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[DragArray]</name>
<type>text; JavaScript array</type>
<explanation>Array of items used for the right (draggable) side of a JMatch drag-drop exercise. This array is created and inserted during the export routine.</explanation>
<used-in>
<sfn>djmatch6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strTimesUp]</name>
<type>text; Message; HTML code</type>
<explanation>Message shown when the timer runs out on an exercise. This is replaced by the setting in the Configuration screen Timer tab.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>djmatch6.js_</sfn>
<sfn>jmix6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>jcloze6.js_</sfn>
<sfn>jcross6.js_</sfn>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strFullVersionInfo]</name>
<type>text</type>
<explanation>This is found in the head of the page, inside an HTML comment. It is replaced with the full version number (x.x.x.x) of the Potato used to build the page.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
<sfn>hp6plainpage.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strTopNavBar]</name>
<type>text</type>
<explanation>This is found in the body of the page. It is replaced with the navigation bar code (which in turn is created from the contents of hp6navbar.ht_).</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strBottomNavBar]</name>
<type>text</type>
<explanation>This is found in the body of the page. It is replaced with the navigation bar code (which in turn is created from the contents of hp6navbar.ht_). It is not included in drag-drop formats, because these do not have bottom navigation bars.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strPunctuation]</name>
<type>text; JavaScript; list of characters in JavaScript escape format</type>
<explanation>This is found in the JavaScript section of JMix output pages (both standard and drag-drop). It is replaced with a list of the punctuation characters used in the exercise. The page needs to be able to identify punctuation characters so that it can correctly join elements of the sentence together.</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strOpenPunctuation]</name>
<type>text; JavaScript; list of characters in JavaScript escape format</type>
<explanation>This is found in the JavaScript section of JMix output pages (both standard and drag-drop). It is replaced with a list of the opening punctuation characters used in the exercise. The page needs to be able to identify punctuation characters, and know which of them are opening punctuation, so that it can correctly join elements of the sentence together.</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strThisMuch]</name>
<type>text; JavaScript; message</type>
<explanation>This is replaced with the message "This much of your answer is correct" from the configuration screen.</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strTheseAnswersToo]</name>
<type>text; JavaScript; message</type>
<explanation>This is found in the JavaScript section of JMix output pages (both standard and drag-drop). It is replaced with the message "These answers are also correct" from the configuration screen.</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strNextCorrect]</name>
<type>text; JavaScript; message</type>
<explanation>This is found in the JavaScript section of JMix (both standard and drag-drop) and JQuiz output pages. It is replaced with the message "The next correct part is: " from the configuration screen.</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
<sfn>hp6checkshortanswer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[boolCapitalizeFirst]</name>
<type>Boolean (true/false)</type>
<explanation>This is found in the JavaScript section of JMix (both standard and drag-drop) pages. It is replaced with true or false, and determines whether the first letter in an answer or guess will be capitalized (as it would normally be at the beginning of a sentence in English).</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strTRows]</name>
<type>text; HTML code</type>
<explanation>This is found only in the JMatch flashcard output, and is replaced by the actual flashcard data, in the form of table rows.</explanation>
<used-in>
<sfn>fjmatch6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strNextCaption]</name>
<type>text; button caption</type>
<explanation>This is found only in the JMatch flashcard output, and is replaced by the caption for the Next flashcard, from the configuration screen.</explanation>
<used-in>
<sfn>fjmatch6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strDeleteCaption]</name>
<type>text; button caption</type>
<explanation>This is found only in the JMatch flashcard output, and is replaced by the caption for deleting a flashcard, from the configuration screen.</explanation>
<used-in>
<sfn>fjmatch6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strReadingTitle]</name>
<type>text; HTML code</type>
<explanation>This is found only in the HotPot reading text source file, and is replaced by the title of the reading text from the Add Reading screen.</explanation>
<used-in>
<sfn>hotpot6r.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strReadingText]</name>
<type>text; HTML code</type>
<explanation>This is found only in the HotPot reading text source file, and is replaced by the text of the reading from the Add Reading screen.</explanation>
<used-in>
<sfn>hotpot6r.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[boolCaseSensitive]</name>
<type>Boolean (true/false)</type>
<explanation>This variable controls whether answer-checking is case-sensitive or not.</explanation>
<used-in>
<sfn>hp6checkshortanswer.js_</sfn>
<sfn>jcloze6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[boolShowAlsoCorrect]</name>
<type>Boolean (true/false)</type>
<explanation>This variable controls whether or not, when a correct answer has been supplied by the student, a list of alternative correct variants is also shown to the student.</explanation>
<used-in>
<sfn>hp6checkshortanswer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strPleaseEnter]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the message "Please enter a guess" from the configuration screen of JQuiz, invoked when a student tries to check an answer without entering anything in the answer box.</explanation>
<used-in>
<sfn>hp6checkshortanswer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[intHybridTries]</name>
<type>integer</type>
<explanation>This is replaced with the number of tries specified in the configuration screen of JQuiz, after which the short answer part of a hybrid question is over, and a multiple-choice question is presented instead.</explanation>
<used-in>
<sfn>hp6checkshortanswer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strPartlyIncorrect]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the message "Your answer is partly incorrect" from the configuration screen of JQuiz.</explanation>
<used-in>
<sfn>hp6checkshortanswer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strCorrectList]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the message "Correct answers: " from the configuration screen of JQuiz, introducing the list of other correct answers variants that may be shown when a question is answered correctly.</explanation>
<used-in>
<sfn>hp6checkshortanswer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strNextCorrect]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the message "Next correct letter in the answer: " from the configuration screen of JQuiz, used when showing a hint.</explanation>
<used-in>
<sfn>jmix6.js_</sfn>
<sfn>djmix6.js_</sfn>
<sfn>hp6checkshortanswer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strBackCaption]</name>
<type>text; HTML code; button caption</type>
<explanation>This is replaced with the "Back button" caption setting from the navigation buttons settings in the configuration screen.</explanation>
<used-in>
<sfn>hp6navbar.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strContentsCaption]</name>
<type>text; HTML code; button caption</type>
<explanation>This is replaced with the "Go to Contents button" caption setting from the navigation buttons settings in the configuration screen.</explanation>
<used-in>
<sfn>hp6navbar.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strNextExCaption]</name>
<type>text; HTML code; button caption</type>
<explanation>This is replaced with the "Next exercise button" caption setting from the navigation buttons settings in the configuration screen.</explanation>
<used-in>
<sfn>hp6navbar.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strContentsURL]</name>
<type>text; relative or absolute URL</type>
<explanation>This is replaced with the Contents page URL setting from the navigation buttons settings in the configuration screen.</explanation>
<used-in>
<sfn>hp6navbar.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strNextExURL]</name>
<type>text; relative or absolute URL</type>
<explanation>This is replaced with the Contents page URL setting from the navigation buttons settings in the configuration screen.</explanation>
<used-in>
<sfn>hp6navbar.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strNavBarID]</name>
<type>text; identifier</type>
<explanation>This is replaced with "BottomNavBar" or "TopNavBar" on export, as appropriate. Enables the bottom nav bar to be targetted for deletion if required to get around IE layout bugs.</explanation>
<used-in>
<sfn>hp6navbar.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strWidth]</name>
<type>text; XHTML attribute</type>
<explanation>This is replaced with the user-entered setting for an object tag created using the Insert Media Object dialog box. This source file is used only when inserting an object tag, not when exporting.</explanation>
<used-in>
<sfn>hp6objecttags.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strHeight]</name>
<type>text; XHTML attribute</type>
<explanation>This is replaced with the user-entered setting for an object tag created using the Insert Media Object dialog box. This source file is used only when inserting an object tag, not when exporting.</explanation>
<used-in>
<sfn>hp6objecttags.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strFilePath]</name>
<type>text; XHTML attribute</type>
<explanation>This is replaced with the user-entered setting for the file path to a media file embedded in the exercise using an object tag created using the Insert Media Object dialog box. This source file is used only when inserting an object tag, not when exporting.</explanation>
<used-in>
<sfn>hp6objecttags.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strContent]</name>
<type>text; XHTML code</type>
<explanation>If the user chooses to add a simple link as a fallback for an object tag, in case the player(s) required are not available in the target browser, then the link is used to replace this placeholder, as the actual content of the object tag. This source file is used only when inserting an object tag, not when exporting.</explanation>
<used-in>
<sfn>hp6objecttags.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strFormMailURL]</name>
<type>text; URL</type>
<explanation>When using the (unsupported) FormMail/CGI functionality available in the configuration screen, the user provides the path to the FormMail script on their server. This is the placeholder for that path.</explanation>
<used-in>
<sfn>hp6sendresults.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strEMail]</name>
<type>text; email address</type>
<explanation>When using the (unsupported) FormMail/CGI functionality available in the configuration screen, the user provides the email address to which the results will be sent. This is the placeholder for that address.</explanation>
<used-in>
<sfn>hp6sendresults.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strNamePlease]</name>
<type>text; message</type>
<explanation>When using the (unsupported) FormMail/CGI functionality available in the configuration screen, the page will ask the student to provide their name before doing the exercise. This is the placeholder for the item in the configuration screen which provides the message shown to the user, requesting the name.</explanation>
<used-in>
<sfn>hp6sendresults.js_</sfn>
</used-in>
</ph>
<ph>
<name>[intSeconds]</name>
<type>integer</type>
<explanation>When a timer is included in the exercise, this placeholder is replaced by the number of seconds the timer will count down. (Minutes and seconds in the configuration screen are converted to a pure seconds value for the JavaScript functions.)</explanation>
<used-in>
<sfn>hp6timer.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strClozeBody]</name>
<type>text; HTML code</type>
<explanation>This is replaced by the XHTML code for the JCloze exercise (the text and gaps).</explanation>
<used-in>
<sfn>jcloze6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strKeypad]</name>
<type>text; HTML code</type>
<explanation>This is replaced by the XHTML code for the onscreen keypad which can be included in JQuiz, JCross and JCloze exercises, to assist students in typing non-Latin characters. The inclusion of the keypad depends on selection of the appropriate checkbox in the configuration screen.</explanation>
<used-in>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strCorrect]</name>
<type>text; message; HTML code</type>
<explanation>This is replaced by the "Correct" message from the configuration screen. The message is shown when the exercise has been completed correctly.</explanation>
<used-in>
<sfn>jcloze6.js_</sfn>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strIncorrect]</name>
<type>text; message; HTML code</type>
<explanation>This is replaced by the "Some answers incorrect" message from the configuration screen. The message is shown when the exercise checked, but some items are incorrect.</explanation>
<used-in>
<sfn>jcloze6.js_</sfn>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strGiveHint]</name>
<type>text; message; HTML code</type>
<explanation>This is replaced by the "Next correct letter added" message from the configuration screen. The message is shown when the student asks for a hint, and a letter is added to the answer.</explanation>
<used-in>
<sfn>jcloze6.js_</sfn>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strGridBody]</name>
<type>text; HTML code</type>
<explanation>This is replaced by the HTML code of the crossword grid created by JCross.</explanation>
<used-in>
<sfn>jcross6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[ShowHideClueList]</name>
<type>text; HTML attribute + value</type>
<explanation>If the checkbox for "Show all clues below the crossword grid" is checked in the JCross configuration screen, this placeholder is replaced with nothing; otherwise, it is replaced with "style="display: none;", to hide the list of clues.</explanation>
<used-in>
<sfn>jcross6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strCluesAcrossLabel]</name>
<type>text; label</type>
<explanation>This is replaced with the appropriate text from the JCross configuration screen, to indicate the list of Across clues.</explanation>
<used-in>
<sfn>jcross6.ht_</sfn>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strCluesDownLabel]</name>
<type>text; label</type>
<explanation>This is replaced with the appropriate text from the JCross configuration screen, to indicate the list of Down clues.</explanation>
<used-in>
<sfn>jcross6.ht_</sfn>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strCluesAcross]</name>
<type>text; label; HTML code</type>
<explanation>This is replaced with the list of Across clues generated by JCross.</explanation>
<used-in>
<sfn>jcross6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strCluesDown]</name>
<type>text; label; HTML code</type>
<explanation>This is replaced with the list of Down clues generated by JCross.</explanation>
<used-in>
<sfn>jcross6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strClueNum]</name>
<type>text; label; number</type>
<explanation>This is replaced with the number of a specific clue in JCross when the clue is opened for editing (i.e. when the student clicks on the clue number in the grid, and the clue is shown above, with a text box for entering the answer). This is replaced during the operation of the exercise, not during the export procedure.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strClue]</name>
<type>text; HTML code</type>
<explanation>This is replaced with the text of a specific clue in JCross when the clue is opened for editing (i.e. when the student clicks on the clue number in the grid, and the clue is shown above, with a text box for entering the answer). This is replaced during the operation of the exercise, not during the export procedure.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strBoxId]</name>
<type>text; XHTML identifier</type>
<explanation>This is replaced with an id that identifies the box uniquely for the purposes of accessing the student's guess, when the clue is opened for editing (i.e. when the student clicks on the clue number in the grid, and the clue is shown above, with a text box for entering the answer). This is replaced during the operation of the exercise, not during the export procedure.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strEditSize]</name>
<type>integer; XHTML attribute</type>
<explanation>This is replaced with an integer that sizes the text box, when the clue is opened for editing (i.e. when the student clicks on the clue number in the grid, and the clue is shown above, with a text box for entering the answer). The size of the box may vary depending (for instance) on the type of text which will be typed into it; Chinese characters may require a larger box. This is replaced during the operation of the exercise, not during the export procedure.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strMaxLength]</name>
<type>integer; XHTML attribute</type>
<explanation>This is replaced with an integer that limits the length of text that can be typed into the text box, when the clue is opened for editing (i.e. when the student clicks on the clue number in the grid, and the clue is shown above, with a text box for entering the answer). The size of the box may vary depending (for instance) on the type of text which will be typed into it; Chinese characters may require a larger box. This is replaced during the operation of the exercise, not during the export procedure.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strEnterCaption]</name>
<type>text; Button caption; HTML code</type>
<explanation>This is replaced by the "Enter answer" button caption setting from the Configuration screen in JCross.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strParams]</name>
<type>text; JavaScript function parameters</type>
<explanation>This is replaced with JavaScript parameters that allow the student's guess to be entered into the grid when they press the Enter button in a JCross crossword.  This is replaced during the operation of the exercise, not during the export procedure.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strLetterArray]</name>
<type>text; JavaScript array</type>
<explanation>This is replaced with a two-dimensional array representing the distribution of letters in the grid in a JCross crossword. It's used for checking the correctness of answers, and for providing hints.</explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strClueNumArray]</name>
<type>text; JavaScript array</type>
<explanation>This is replaced with a two-dimensional array representing the distribution of clue numbers in the grid in a JCross crossword. </explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strGuessArray]</name>
<type>text; JavaScript array</type>
<explanation>This is replaced with an array in which student guesses are stored in a JCross crossword. </explanation>
<used-in>
<sfn>jcross6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strPrintExplanation]</name>
<type>text; message</type>
<explanation>This is replaced with a short message which is shown when the JCross print export page is loaded into a browser. The source of the message is inside the Hot Potatoes program, but it can be changed through the use of a translation file. The message explains how the basic printable output works.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[StartBlankCell]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[EndBlankCell]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[StartLetterOnlyCell]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[EndLetterOnlyCell]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[StartNumLetterCell]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[EndNumLetterCell]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[StartCluesAcrossLoop]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for various sections, and uses these blocks when building the output for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[EndCluesAcrossLoop]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. [Start...] and [End...] elements bracket these blocks of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[Letter]</name>
<type>text; crossword grid letter</type>
<explanation>When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. This placeholder is replaced by the relevant letter for the grid.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[ClueNum]</name>
<type>text; crossword grid number</type>
<explanation>When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. This placeholder is replaced by the relevant clue number in the grid, and also in the clue list.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[Clue]</name>
<type>text; crossword grid number</type>
<explanation>When exporting to create a printable Web page, the JCross program looks in the source file to get blocks of HTML code for three different types of grid cell, and uses these blocks when building the output grid for the page. This placeholder is replaced by the relevant clue.</explanation>
<used-in>
<sfn>jcross6print.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strMatchDivItems]</name>
<type>text; HTML code</type>
<explanation>This placeholder is replaced with the HTML code for the exercise elements in a standard JMatch exercise (the item list on the left, and the drop-down lists on the right).</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strCorrectIndicator]</name>
<type>text; HTML code</type>
<explanation>This placeholder is replaced with the "Correct indicator" from the configuration screen (by default a "smiley"). It is used to mark a correct answer on the page.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strIncorrectIndicator]</name>
<type>text; HTML code</type>
<explanation>This placeholder is replaced with the "Incorrect indicator" from the configuration screen (by default a letter "X"). It is used to mark an incorrect answer on the page.</explanation>
<used-in>
<sfn>jmatch6.js_</sfn>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strRemainingWords]</name>
<type>text; message; HTML code</type>
<explanation>This placeholder is replaced with the "Remaining words" message from the configuration screen. It is used to introduce the list of words or segments not yet added into the answer in a JMix exercise.</explanation>
<used-in>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[SegmentNumber]</name>
<type>integer; JavaScript function parameter</type>
<explanation>This is replaced with an integer indexing the segment which is being clicked on when the student is doing the exercise. This is replaced during the operation of the exercise, not during the export procedure.</explanation>
<used-in>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[SegmentArray]</name>
<type>text; JavaScript array</type>
<explanation>This is replaced with a JavaScript array containing the list of segments in a JMix exercise.</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[AnswerArray]</name>
<type>text; JavaScript array</type>
<explanation>This is replaced with a JavaScript array containing the list of acceptable answers in a JMix exercise.</explanation>
<used-in>
<sfn>djmix6.js_</sfn>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strShowAllQuestionsCaption]</name>
<type>text; button caption; HTML code</type>
<explanation>This is the caption for the button in a JQuiz exercise which allows the student to see the complete list of questions in the exercise.</explanation>
<used-in>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strShowAllQuestionsCaptionJS]</name>
<type>text; JavaScript string; button caption; HTML code</type>
<explanation>This is the caption for the button in a JQuiz exercise which allows the student to see the complete list of questions in the exercise. This variant is found in JavaScript, so the text string is appropriately escaped compared with [strShowAllQuestions].</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strShowOneByOneCaptionJS]</name>
<type>text; JavaScript string; button caption; HTML code</type>
<explanation>This is the caption for the button in a JQuiz exercise which allows the student to view questions in the exercise one at a time.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strLastQCaption]</name>
<type>text; button caption; HTML code</type>
<explanation>This is the caption for the button in a JQuiz exercise which allows the student to move to the previous question in the exercise.</explanation>
<used-in>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strNextQCaption]</name>
<type>text; button caption; HTML code</type>
<explanation>This is the caption for the button in a JQuiz exercise which allows the student to move to the next question in the exercise.</explanation>
<used-in>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strQuestionOutput]</name>
<type>text; HTML code</type>
<explanation>This placeholder is replaced by the XHTML code containing the questions in a JQuiz exercise (actually a set of embedded list objects).</explanation>
<used-in>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[boolContinuousScoring]</name>
<type>Boolean (true/false)</type>
<explanation>This is what determines whether the score in a JQuiz exercise will be shown after each question is answered correctly, or only at the end of the exercise. It is set by the equivalent setting in the configuration screen.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strCorrectFirstTime]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the message "Questions answered correctly first time:" from the configuration screen of JQuiz. It introduces a readout at the end of the exercise showing how many of the questions were answered correctly on the first try.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[boolShowCorrectFirstTime]</name>
<type>Boolean (true/false)</type>
<explanation>This is what determines whether, at the end of a JQuiz exercise, the student will be shown a readout of the number of questions which were answered correctly on the first try. It is set by the equivalent setting in the configuration screen.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strDefaultRight]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the "Guess correct" message from the JQuiz configuration screen. It is used as feedback for a correct answer, if the author has not specified any feedback.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strDefaultWrong]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the "Guess incorrect" message from the JQuiz configuration screen. It is used as feedback for an incorrect answer, if the author has not specified any feedback.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strCompletedSoFar]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the "Questions completed so far" message from the JQuiz configuration screen. It is used to tell the student how many of the questions in the quiz have been completed.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strExerciseCompleted]</name>
<type>text; HTML code; message</type>
<explanation>This is replaced with the "You have completed the exercise" message from the JQuiz configuration screen. It appears when the student has completed all of the questions in the exercise.</explanation>
<used-in>
<sfn>jquiz6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strIndexTitle]</name>
<type>text; HTML code</type>
<explanation>This is replaced by the title of the unit or chapter, specified in the Masher interface. It forms the title of the Index page which the Masher creates.</explanation>
<used-in>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strPlainIndexTitle]</name>
<type>text; HTML code</type>
<explanation>This is found in the HTML title tag in the page head tag. It is replaced by the unit or chapter title from the Masher interface, but without any HTML tags that may have been included in the title. The tags are removed because the title text is usually displayed in the caption of the Web browser, and tags would not function in that context.</explanation>
<used-in>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[BeginIndexItem]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create an index page for a chapter or unit, the Masher program looks in the source file to get a block of HTML code to use when creating each link. [Begin...] and [End...] elements bracket this block of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[EndIndexItem]</name>
<type>text; marker</type>
<explanation>This is more of a marker than a placeholder. When exporting to create an index page for a chapter or unit, the Masher program looks in the source file to get a block of HTML code to use when creating each link. [Begin...] and [End...] elements bracket this block of code. They are removed from the output itself.</explanation>
<used-in>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strIndexItemURL]</name>
<type>text; URL</type>
<explanation>When the Masher builds an index page with a list of links pointing to exercises in a unit or chapter, this is replaced by the relative URL of an exercise.</explanation>
<used-in>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strIndexItemTitle]</name>
<type>text; HTML code</type>
<explanation>When the Masher builds an index page with a list of links pointing to exercises in a unit or chapter, this is replaced by the title of an exercise, and forms the text of a link to it.</explanation>
<used-in>
<sfn>masher.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strNavBarStyle]</name>
<type>text; CSS code</type>
<explanation>When the Masher adds a navigation bar to a non-Hot-Potatoes page in creating a unit of materials, the CSS and JavaScript for making the navigation bar consistent with the rest of the materials must be inserted into the page. This placeholder is replaced by the relevant CSS code from hp6.cs_, allowing the inserted navigation bar to be styled correctly.</explanation>
<used-in>
<sfn>mashernav.ht_</sfn>
</used-in>
</ph>
<ph>
<name>[strClickToAdd]</name>
<type>text; tooltip; HTML attribute</type>
<explanation>This is replaced with the equivalent item from the JMix configuration screen. It becomes the tooltip (HTML title attribute) for each segment in a standard JMix exercise.</explanation>
<used-in>
<sfn>jmix6.js_</sfn>
</used-in>
</ph>
<ph>
<name>[strClueCaption]</name>
<type>text; Button caption; HTML code</type>
<explanation>This is replaced by the Clue button caption setting from the JCloze Configuration screen. This placeholder is not actually in the source file; it's generated by the output routine and placed into the source file code, then replaced later in the output procedure.</explanation>
<used-in>
<sfn>jcloze6.ht_</sfn>
</used-in>
</ph>

<ph>
<name>[strJSScorm_1_2]</name>
<type>text; JavaScript code</type>
<explanation>This is replaced by the contents of the scorm_1_2.js_ file whenever SCORM code is included in an exercise.</explanation>
<used-in>
<sfn>jmatch6.ht_</sfn>
<sfn>djmatch6.ht_</sfn>
<sfn>fjmatch6.ht_</sfn>
<sfn>jmix6.ht_</sfn>
<sfn>djmix6.ht_</sfn>
<sfn>jcloze6.ht_</sfn>
<sfn>jcross6.ht_</sfn>
<sfn>jquiz6.ht_</sfn>
</used-in>
</ph>

</placeholder-list>

</hotpot-documentation>