Documentation for Hot Potatoes Source Files and Placeholders
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.
List of source files
hp6plainpage
ht_
This file is used by the Masher to create a plain HTML page using the basic Hot Potatoes exercise layout and style settings.
hp6
cs_
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.
hotpot6r
ht_
This file is used as the basis for the reading text component of an exercise.
jcloze6
ht_
The core HTML code used to create a standard JCloze exercise.
jcross6
ht_
The core HTML code used to create a standard JCross exercise.
jmatch6
ht_
The core HTML code used to create a standard JMatch exercise.
djmatch6
ht_
The core HTML code used to create a drag-drop JMatch exercise.
fjmatch6
ht_
The core HTML code used to create a flashcard JMatch exercise.
jmix6
ht_
The core HTML code used to create a standard JMix exercise.
djmix6
ht_
The core HTML code used to create a drag-drop JMix exercise.
jquiz6
ht_
The core HTML code used to create a standard JQuiz exercise.
hp6navbar
ht_
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.
hp6objecttags
ht_
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.
jcross6print
ht_
The source file for the JCross Export For Printing function on the File menu.
masher
ht_
HTML code used by the Masher to create its Index page.
mashernav
ht_
HTML code used by the Masher when it adds navigation bars to non-Hot Potatoes HTML pages.
jcloze6
js_
The core JavaScript code used to create a standard JCloze exercise.
jcross6
js_
The core JavaScript code used to create a standard JCross exercise.
jmatch6
js_
The core JavaScript code used to create a standard JMatch exercise.
djmatch6
js_
The core JavaScript code used to create a drag-drop JMatch exercise.
fjmatch6
js_
The core JavaScript code used to create a flashcard JMatch exercise.
jmix6
js_
The core JavaScript code used to create a standard JMix exercise.
djmix6
js_
The core JavaScript code used to create a drag-drop JMix exercise.
jquiz6
js_
The core JavaScript code used to create a standard JQuiz exercise.
hp6browsercheck
js_
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 testbrowsercheck.htm file in your browser.
hp6buttons
js_
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.
hp6card
js_
JavaScript code included in drag-drop pages, used for handling the drag-drop behaviour.
hp6checkshortanswer
js_
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.
hp6hotpotnet
js_
JavaScript code included in all pages, which handles communication with the hotpotatoes.net server.
hp6sendresults
js_
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.
hp6showmessage
js_
JavaScript code used to pop up the feedback messages in all exercises.
hp6timer
js_
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.
hp6utilities
js_
A range of multi-purpose JavaScript functions used in all the exercises.
scorm_1_2
js_
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.
List of placeholders used in source files (not yet complete)
[strTitleColor]
text; HTML colour designation
Replaced by the "title colour" setting chosen in the configuration screen. Becomes the font colour setting for the title area of the page.
hp6.cs_
masher.ht_
djmatch6.js_
djmix6.js_
hp6sendresults.js_
[strTextColor]
text; HTML colour designation
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).
hp6.cs_
masher.ht_
djmatch6.js_
djmix6.js_
hp6sendresults.js_
hp6card.js_
[strExBGColor]
text; HTML colour designation
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).
hp6.cs_
djmatch6.js_
djmix6.js_
hp6card.js_
masher.ht_
[strPageBGColor]
text; HTML colour designation
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).
hp6.cs_
djmatch6.js_
djmix6.js_
hp6sendresults.js_
[strGraphicURL]
text; relative or absolute URL
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).
hp6.cs_
masher.ht_
[strFontFace]
text; one or more comma-separated font names or families
Replaced by the "output font face" setting chosen in the configuration screen. Becomes the core font selection for the page.
hp6.cs_
masher.ht_
jcross6print.ht_
[strFuncLightColor]
text; HTML colour designation
Replaced by the colour used for the top and left borders of function buttons on the page.
hp6.cs_
[strFuncShadeColor]
text; HTML colour designation
Replaced by the colour used for the bottom and right borders of function buttons on the page.
hp6.cs_
[strNavLightColor]
text; HTML colour designation
Replaced by the colour used for the top and left borders of navigation buttons on the page.
hp6.cs_
[strNavShadeColor]
text; HTML colour designation
Replaced by the colour used for the bottom and right borders of navigation buttons on the page.
hp6.cs_
[strNavBarColor]
text; HTML colour designation
Replaced by the colour used for the background of the navigation bar.
hp6.cs_
[strLinkColor]
text; HTML colour designation
Replaced by the colour used for HTML links included in pages.
hp6.cs_
masher.ht_
[strVLinkColor]
text; HTML colour designation
Replaced by the colour used for visited HTML links included in pages.
hp6.cs_
masher.ht_
[strDublinCoreMetadata]
text; HTML meta tags
Replaced by meta tags formed from the Dublin Core metadata entered in the metadata screen.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strPlainTitle]
text
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.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strHeaderCode]
text; HTML code
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.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
hp6plainpage.ht_
[strUserDefined1], [strUserDefined2], [strUserDefined3]
text; anything, depending on the user
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.
[strStyleSheet]
text; CSS code
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.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
hp6plainpage.ht_
[strJS.....]
text; JavaScript code
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_).
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strExerciseTitle]
text; HTML code
This is replaced by the title of the exercise.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jcross6print.ht_
jquiz6.ht_
hp6sendresults.js_
[strExerciseSubtitle]
text; HTML code
This is replaced by the subtitle of the exercise, from the Configuration screen.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jcross6print.ht_
jquiz6.ht_
[strInstructions]
text; HTML code
This is replaced by the instructions for the exercise, from the Configuration screen.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strCheckCaption]
text; Button caption; HTML code
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.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strOKCaption]
text; Button caption; HTML code
This is replaced by the OK button caption setting from the Configuration screen.
jmatch6.ht_
djmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strRestartCaption]
text; Button caption; HTML code
This is replaced by the Restart button caption setting from the Configuration screen in JMix.
jmix6.ht_
djmix6.ht_
[strUndoCaption]
text; Button caption; HTML code
This is replaced by the Undo button caption setting from the Configuration screen in JMix.
jmix6.ht_
[strHintCaption]
text; Button caption; HTML code
This is replaced by the Hint button caption setting from the Configuration screen.
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
[strGuessCorrect]
text; Message; HTML code
This is replaced by the "Your guess is correct" setting from the Configuration screen.
jmatch6.js_
djmatch6.js_
jmix6.js_
djmix6.js_
[strGuessIncorrect]
text; Message; HTML code
This is replaced by the "Your guess is incorrect" setting from the Configuration screen.
jmatch6.js_
djmatch6.js_
jmix6.js_
djmix6.js_
[strYourScoreIs]
text; Message; HTML code
This is replaced by the "Your score is: " setting from the Configuration screen.
jmatch6.js_
djmatch6.js_
jmix6.js_
djmix6.js_
jquiz6.js_
jcloze6.js_
jcross6.js_
[boolShuffleQs]
Boolean (true/false)
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.
jmatch6.js_
djmatch6.js_
fjmatch6.js_
jquiz6.js_
[boolShuffleAs]
Boolean (true/false)
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.
jquiz6.js_
[QsToShow]
integer
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.
jmatch6.js_
djmatch6.js_
jquiz6.js_
[PreloadImageList]
text; list of image names
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.
jmatch6.js_
djmatch6.js_
fjmatch6.js_
jmix6.js_
djmix6.js_
jquiz6.js_
jcloze6.js_
jcross6.js_
[FixedArray]
text; JavaScript array
Array of items used for the left side of a JMatch drag-drop exercise. This array is created and inserted during the export routine.
djmatch6.js_
[DragArray]
text; JavaScript array
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.
djmatch6.js_
[strTimesUp]
text; Message; HTML code
Message shown when the timer runs out on an exercise. This is replaced by the setting in the Configuration screen Timer tab.
jmatch6.js_
djmatch6.js_
jmix6.js_
djmix6.js_
jcloze6.js_
jcross6.js_
jquiz6.js_
[strFullVersionInfo]
text
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.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
hp6plainpage.ht_
[strTopNavBar]
text
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_).
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strBottomNavBar]
text
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.
jmatch6.ht_
fjmatch6.ht_
jmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strPunctuation]
text; JavaScript; list of characters in JavaScript escape format
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.
djmix6.js_
jmix6.js_
[strOpenPunctuation]
text; JavaScript; list of characters in JavaScript escape format
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.
djmix6.js_
jmix6.js_
[strThisMuch]
text; JavaScript; message
This is replaced with the message "This much of your answer is correct" from the configuration screen.
djmix6.js_
jmix6.js_
[strTheseAnswersToo]
text; JavaScript; message
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.
djmix6.js_
jmix6.js_
[strNextCorrect]
text; JavaScript; message
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.
djmix6.js_
jmix6.js_
hp6checkshortanswer.js_
[boolCapitalizeFirst]
Boolean (true/false)
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).
djmix6.js_
jmix6.js_
[strTRows]
text; HTML code
This is found only in the JMatch flashcard output, and is replaced by the actual flashcard data, in the form of table rows.
fjmatch6.ht_
[strNextCaption]
text; button caption
This is found only in the JMatch flashcard output, and is replaced by the caption for the Next flashcard, from the configuration screen.
fjmatch6.ht_
[strDeleteCaption]
text; button caption
This is found only in the JMatch flashcard output, and is replaced by the caption for deleting a flashcard, from the configuration screen.
fjmatch6.ht_
[strReadingTitle]
text; HTML code
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.
hotpot6r.ht_
[strReadingText]
text; HTML code
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.
hotpot6r.ht_
[boolCaseSensitive]
Boolean (true/false)
This variable controls whether answer-checking is case-sensitive or not.
hp6checkshortanswer.js_
jcloze6.js_
[boolShowAlsoCorrect]
Boolean (true/false)
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.
hp6checkshortanswer.js_
[strPleaseEnter]
text; HTML code; message
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.
hp6checkshortanswer.js_
[intHybridTries]
integer
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.
hp6checkshortanswer.js_
[strPartlyIncorrect]
text; HTML code; message
This is replaced with the message "Your answer is partly incorrect" from the configuration screen of JQuiz.
hp6checkshortanswer.js_
[strCorrectList]
text; HTML code; message
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.
hp6checkshortanswer.js_
[strNextCorrect]
text; HTML code; message
This is replaced with the message "Next correct letter in the answer: " from the configuration screen of JQuiz, used when showing a hint.
jmix6.js_
djmix6.js_
hp6checkshortanswer.js_
[strBackCaption]
text; HTML code; button caption
This is replaced with the "Back button" caption setting from the navigation buttons settings in the configuration screen.
hp6navbar.ht_
[strContentsCaption]
text; HTML code; button caption
This is replaced with the "Go to Contents button" caption setting from the navigation buttons settings in the configuration screen.
hp6navbar.ht_
[strNextExCaption]
text; HTML code; button caption
This is replaced with the "Next exercise button" caption setting from the navigation buttons settings in the configuration screen.
hp6navbar.ht_
[strContentsURL]
text; relative or absolute URL
This is replaced with the Contents page URL setting from the navigation buttons settings in the configuration screen.
hp6navbar.ht_
[strNextExURL]
text; relative or absolute URL
This is replaced with the Contents page URL setting from the navigation buttons settings in the configuration screen.
hp6navbar.ht_
[strNavBarID]
text; identifier
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.
hp6navbar.ht_
[strWidth]
text; XHTML attribute
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.
hp6objecttags.ht_
[strHeight]
text; XHTML attribute
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.
hp6objecttags.ht_
[strFilePath]
text; XHTML attribute
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.
hp6objecttags.ht_
[strContent]
text; XHTML code
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.
hp6objecttags.ht_
[strFormMailURL]
text; URL
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.
hp6sendresults.js_
[strEMail]
text; email address
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.
hp6sendresults.js_
[strNamePlease]
text; message
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.
hp6sendresults.js_
[intSeconds]
integer
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.)
hp6timer.js_
[strClozeBody]
text; HTML code
This is replaced by the XHTML code for the JCloze exercise (the text and gaps).
jcloze6.ht_
[strKeypad]
text; HTML code
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.
jcloze6.ht_
jcross6.ht_
jquiz6.ht_
[strCorrect]
text; message; HTML code
This is replaced by the "Correct" message from the configuration screen. The message is shown when the exercise has been completed correctly.
jcloze6.js_
jcross6.js_
[strIncorrect]
text; message; HTML code
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.
jcloze6.js_
jcross6.js_
[strGiveHint]
text; message; HTML code
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.
jcloze6.js_
jcross6.js_
[strGridBody]
text; HTML code
This is replaced by the HTML code of the crossword grid created by JCross.
jcross6.ht_
[ShowHideClueList]
text; HTML attribute + value
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.
jcross6.ht_
[strCluesAcrossLabel]
text; label
This is replaced with the appropriate text from the JCross configuration screen, to indicate the list of Across clues.
jcross6.ht_
jcross6print.ht_
[strCluesDownLabel]
text; label
This is replaced with the appropriate text from the JCross configuration screen, to indicate the list of Down clues.
jcross6.ht_
jcross6print.ht_
[strCluesAcross]
text; label; HTML code
This is replaced with the list of Across clues generated by JCross.
jcross6.ht_
[strCluesDown]
text; label; HTML code
This is replaced with the list of Down clues generated by JCross.
jcross6.ht_
[strClueNum]
text; label; number
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.
jcross6.js_
[strClue]
text; HTML code
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.
jcross6.js_
[strBoxId]
text; XHTML identifier
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.
jcross6.js_
[strEditSize]
integer; XHTML attribute
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.
jcross6.js_
[strMaxLength]
integer; XHTML attribute
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.
jcross6.js_
[strEnterCaption]
text; Button caption; HTML code
This is replaced by the "Enter answer" button caption setting from the Configuration screen in JCross.
jcross6.js_
[strParams]
text; JavaScript function parameters
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.
jcross6.js_
[strLetterArray]
text; JavaScript array
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.
jcross6.js_
[strClueNumArray]
text; JavaScript array
This is replaced with a two-dimensional array representing the distribution of clue numbers in the grid in a JCross crossword.
jcross6.js_
[strGuessArray]
text; JavaScript array
This is replaced with an array in which student guesses are stored in a JCross crossword.
jcross6.js_
[strPrintExplanation]
text; message
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.
jcross6print.ht_
[StartBlankCell]
text; marker
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.
jcross6print.ht_
[EndBlankCell]
text; marker
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.
jcross6print.ht_
[StartLetterOnlyCell]
text; marker
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.
jcross6print.ht_
[EndLetterOnlyCell]
text; marker
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.
jcross6print.ht_
[StartNumLetterCell]
text; marker
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.
jcross6print.ht_
[EndNumLetterCell]
text; marker
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.
jcross6print.ht_
[StartCluesAcrossLoop]
text; marker
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.
jcross6print.ht_
[EndCluesAcrossLoop]
text; marker
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.
jcross6print.ht_
[Letter]
text; crossword grid letter
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.
jcross6print.ht_
[ClueNum]
text; crossword grid number
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.
jcross6print.ht_
[Clue]
text; crossword grid number
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.
jcross6print.ht_
[strMatchDivItems]
text; HTML code
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).
jmatch6.ht_
[strCorrectIndicator]
text; HTML code
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.
jmatch6.js_
jquiz6.js_
[strIncorrectIndicator]
text; HTML code
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.
jmatch6.js_
jquiz6.js_
[strRemainingWords]
text; message; HTML code
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.
jmix6.js_
[SegmentNumber]
integer; JavaScript function parameter
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.
jmix6.js_
[SegmentArray]
text; JavaScript array
This is replaced with a JavaScript array containing the list of segments in a JMix exercise.
djmix6.js_
jmix6.js_
[AnswerArray]
text; JavaScript array
This is replaced with a JavaScript array containing the list of acceptable answers in a JMix exercise.
djmix6.js_
jmix6.js_
[strShowAllQuestionsCaption]
text; button caption; HTML code
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.
jquiz6.ht_
[strShowAllQuestionsCaptionJS]
text; JavaScript string; button caption; HTML code
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].
jquiz6.js_
[strShowOneByOneCaptionJS]
text; JavaScript string; button caption; HTML code
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.
jquiz6.js_
[strLastQCaption]
text; button caption; HTML code
This is the caption for the button in a JQuiz exercise which allows the student to move to the previous question in the exercise.
jquiz6.ht_
[strNextQCaption]
text; button caption; HTML code
This is the caption for the button in a JQuiz exercise which allows the student to move to the next question in the exercise.
jquiz6.ht_
[strQuestionOutput]
text; HTML code
This placeholder is replaced by the XHTML code containing the questions in a JQuiz exercise (actually a set of embedded list objects).
jquiz6.ht_
[boolContinuousScoring]
Boolean (true/false)
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.
jquiz6.js_
[strCorrectFirstTime]
text; HTML code; message
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.
jquiz6.js_
[boolShowCorrectFirstTime]
Boolean (true/false)
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.
jquiz6.js_
[strDefaultRight]
text; HTML code; message
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.
jquiz6.js_
[strDefaultWrong]
text; HTML code; message
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.
jquiz6.js_
[strCompletedSoFar]
text; HTML code; message
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.
jquiz6.js_
[strExerciseCompleted]
text; HTML code; message
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.
jquiz6.js_
[strIndexTitle]
text; HTML code
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.
masher.ht_
[strPlainIndexTitle]
text; HTML code
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.
masher.ht_
[BeginIndexItem]
text; marker
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.
masher.ht_
[EndIndexItem]
text; marker
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.
masher.ht_
[strIndexItemURL]
text; URL
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.
masher.ht_
[strIndexItemTitle]
text; HTML code
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.
masher.ht_
[strNavBarStyle]
text; CSS code
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.
mashernav.ht_
[strClickToAdd]
text; tooltip; HTML attribute
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.
jmix6.js_
[strClueCaption]
text; Button caption; HTML code
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.
jcloze6.ht_
[strJSScorm_1_2]
text; JavaScript code
This is replaced by the contents of the scorm_1_2.js_ file whenever SCORM code is included in an exercise.
jmatch6.ht_
djmatch6.ht_
fjmatch6.ht_
jmix6.ht_
djmix6.ht_
jcloze6.ht_
jcross6.ht_
jquiz6.ht_