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

File name Function Placeholders
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. View
djmatch6.ht_ The core HTML code used to create a drag-drop JMatch exercise. View
djmix6.ht_ The core HTML code used to create a drag-drop JMix exercise. View
fjmatch6.ht_ The core HTML code used to create a flashcard JMatch exercise. View
hotpot6r.ht_ This file is used as the basis for the reading text component of an exercise. View
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. View
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. View
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. View
jcloze6.ht_ The core HTML code used to create a standard JCloze exercise. View
jcross6.ht_ The core HTML code used to create a standard JCross exercise. View
jcross6print.ht_ The source file for the JCross Export For Printing function on the File menu. View
jmatch6.ht_ The core HTML code used to create a standard JMatch exercise. View
jmix6.ht_ The core HTML code used to create a standard JMix exercise. View
jquiz6.ht_ The core HTML code used to create a standard JQuiz exercise. View
masher.ht_ HTML code used by the Masher to create its Index page. View
mashernav.ht_ HTML code used by the Masher when it adds navigation bars to non-Hot Potatoes HTML pages. View
djmatch6.js_ The core JavaScript code used to create a drag-drop JMatch exercise. View
djmix6.js_ The core JavaScript code used to create a drag-drop JMix exercise. View
fjmatch6.js_ The core JavaScript code used to create a flashcard JMatch exercise. View
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. View
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. View
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. View
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. View
hp6utilities.js_ A range of multi-purpose JavaScript functions used in all the exercises.
jcloze6.js_ The core JavaScript code used to create a standard JCloze exercise. View
jcross6.js_ The core JavaScript code used to create a standard JCross exercise. View
jmatch6.js_ The core JavaScript code used to create a standard JMatch exercise. View
jmix6.js_ The core JavaScript code used to create a standard JMix exercise. View
jquiz6.js_ The core JavaScript code used to create a standard JQuiz exercise. View
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)

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