Hotpot7 Help
Hotpot7 Help
Hotpot7 Help
Contents 4
General introduction and help 4
What do these programs do? 4
Conditions for using Hot Potatoes 4
Notes for upgraders 4
What's new in this version? 5
Getting started 6
What do I need to use Hot Potatoes? 7
How do the programs work? 7
Entering and saving data 7
Configuring the output 8
Adding a reading text 10
Adding a timer 11
Adding graphics 11
Adding links 12
Inserting an object 13
Using Unicode 13
Creating Web pages 14
Creating a zip package 15
How to link a series of exercises 15
Giving students an onscreen keyboard 16
Using Hot Potatoes in other languages 16
What is the Masher? 16
The hotpotatoes.net hosting service: No longer available 17
The Toolbar and Menus 17
The Toolbar 17
The File menu 17
The Edit menu 18
The Insert menu 18
The Manage Questions menu 19
The Manage Grid menu 19
The Options menu 19
The Help menu 20
Help on specific programs 20
JQuiz 20
The main JQuiz screen 20
JQuiz question types 21
JQuiz configuration details 22
Beginner and Advanced modes 22
JCloze 23
The main JCloze screen 23
Adding alternate correct answers & clues 23
JCloze configuration details 24
JCross 24
The main JCross screen 25
Entering clues 25
JCross configuration details 26
Printing in JCross 26
© Half-Baked Software, Inc., 1998-2019
p2
Case sensitivity in JCross 26
JMix 27
The main JMix screen 27
Breaking up the sentence into segments 27
Brackets and quotation marks in JMix 28
JMix configuration details 28
JMatch 28
The main JMatch screen 28
JMatch output 29
JMatch configuration details 29
Registering the programs 30
How to register 30
Frequently-asked questions 30
Can I make separate config files? 30
Will Hot Potatoes read my old files? 30
Can I insert graphics into my Web pages? 31
Can I insert sound and video? 31
Must I always run the front end program? 31
Why do Win and Mac versions differ? 31
How does the scoring work in JQuiz? 32
How does the scoring work in JCloze? 32
How does the rest of the scoring work? 32
Can I get students' results by e-mail? 33
Support and credits 33
Technical support 33
Internet help 33
About the authors 33
Acknowledgements 34
The future of Hot Potatoes 36
For power-users 36
Custom configuration (user strings) 36
W3C standards support 37
Dublin Core Metadata 37
SCORM 1.2 support 37
Making separate JavaScript files 38
Keystroke shortcuts for HTML tags 38
Editing the source files 39
How the programs use source files 39
Translating the interface 40
Installing and uninstalling 41
Installing and uninstalling Hot Potatoes 41
What is installed with the programs? 42
The JQuiz program creates question-based quizzes. Questions can be of four different types, including
multiple-choice and short-answer. Specific feedback can be provided both for right answers and
predicted wrong answers or distractors. In short-answer questions, the student's guess is intelligently
parsed and helpful feedback to show what part of a guess is right and what part is wrong. The student
can ask for a hint in the form of a "free letter" from the answer.
The JCloze program creates gap-fill exercises. Unlimited correct answers can be specified for each
gap, and the student can ask for a hint and see a letter of the correct answer. A specific clue can also
be included for each gap. Automatic scoring is also included. The program allows gapping of selected
words, or the automatic gapping of every nth word in a text.
The JCross program creates crossword puzzles which can be completed online. You can use a grid of
virtually any size. As in JQuiz and JCloze, a hint button allows the student to request a free letter if help
is needed.
The JMix program creates jumbled-sentence exercises. You can specify as many different correct
answers as you want, based on the words and punctuation in the base sentence, and a hint button
prompts the student with the next correct word or segment of the sentence if needed.
The JMatch program creates matching or ordering exercises. A list of fixed items appears on the left
(these can be pictures or text), wth jumbled items on the right. This can be used for matching
vocabulary to pictures or translations, or for ordering sentences to form a sequence or a conversation.
In addition, there is a sixth program called the Masher. This is designed to create complete units of
material in one simple operation. If you are creating sequences of exercises and other pages that should
form a unit, you may find the Masher useful. The Masher can also be used to upload Web pages not
created with Hot Potatoes to the www.hotpotatoes.net server.
-o-
-o-
If you are upgrading from version 6.x to 7.0 or above, please bear in mind that the source files as well as
the applications have changed significantly. Version 7 should be installed alongside version 6, in a different
folder, so if you want to keep both versions, you can do so. If you install over the top of your old version of
Hot Potatoes, you will only be able to create XHTML5 pages rather than the original XHTML 1.1 pages
created by previous versions. In most cases this should not make much difference, but if you have been
using customized source files, you may encounter some problems which require you to create new
customized versions from the new source files.
If you are upgrading from version 4.x or 5.x, you have two options:
1. Just install the new version over the top of your old version, replacing it.
2. Install version 6 to a different location. This means that your old version will be unchanged, and will still
function properly; you can therefore use both versions until you're happy with the transition. You can
continue to use a previous version to create old output formats for old browsers, if you need to do that.
If you have been using a personalized configuration file in version 4 or 5, you will need to load that file into
version 6 as well. Note that some new configuration items have been added, so you may need to update
your old configuration file. You should be able to share the same configuration files between both versions
without problems.
Hot Potatoes versions 4 and above are a substantial upgrade from version 3. All the file structures, source
files and configuration files have changed completely.
Therefore, if you are upgrading, you should install version 6 of Hot Potatoes over the top of version 3,
overwriting it. We do not recommend keeping both versions on your machine, unless you understand quite
thoroughly how the programs work (especially with regard to source files).
If you have configuration files that you need to convert from version 3 to version 4+, here is the best way to
do it:
With the next Potato, follow the same steps -- load the OLD file, and save it with the new name. Do each
Potato in turn, gradually transferring all the old configuration information from the old file to the new one.
You will notice that there are some new configuration settings in versions 4 and 5 that were not there in
version 3; you can set these as you go along, if you wish.
-o-
Version 6.3 has no new features, except that it is free. You will be prompted to register when you start the
application. This process simply asks for your name, and stores it in the system registry; your name will be
inserted into exercises you create with Hot Potatoes, identifying you as the author of the exercises. It will
not be sent to us or to anyone else.
Version 6.2.4.0 adds two new menu items: The Options menu now has two menu items to choose the
source file location, and reset it to the default. See Editing the source files for more information on this.
Version 6.2.3.1 adds a new Show tooltips command on the Options menu.
In Version 6.2.2.0, JQuiz has some refinements in the information shown to students doing the exercises.
After each question, the student can now see how many questions they have completed so far, and when
all the questions are completed, they're told that they've finished. This helps avoid the problem where
students skip questions and then forget that they haven't answered all of them.
Version 6.2.0.9 of Hot Potatoes introduces only one new feature: case sensitivity in JCross. You can now
create crosswords which use lower-case letters, and have answers accepted or rejected based on case.
Version 6.2 of Hot Potatoes introduces support for SCORM 1.2. You can now output your exercises in the
form of SCORM packages which can be imported into learning management systems that support SCORM.
Version 6.1 of Hot Potatoes introduces one new feature, Create zip package, which enables you to create
a portable zip archive of your exercise, along with any related media files.
From version 6.0.4.18, this Help file is in the form of an HTMLHelp (.chm) file. That means that a recent
version of Internet Explorer must be installed in Windows before the file will work. It is assumed that
anyone working regularly on Web-based materials will be updating Windows regularly, as a
common-sense measure for their own protection, so this will not be an issue for users of Hot Potatoes.
Version 6.0 is a major rewrite of Hot Potatoes. These are the most important new features:
All the applications now support Unicode data and configuration on Windows 2000 and XP. This
means you can create exercises in Chinese, Japanese, Arabic etc.
The V6 output format has been extensively rewritten to make it 100% XHTML 1.1-compliant.
All exercises can now have time-limits placed on them (instead of on the reading text).
JQuiz now handles four question types, including multiple-choice and short-answer, and you can mix
question types in one exercise. (The old JBC no longer exists, because JQuiz does all question-based
formats.)
JQuiz questions can be weighted, and answers can be designated as (for example) "30% correct", to
enable more sophisticated scoring.
Exercise output has been designed so that it's easier to edit in common Web editor programs such as
DreamWeaver. For instance, the text of a gapfill exercise is now part of the XHTML body, and can be
edited WYSIWYG-style.
Source files have been modularized to make them easier to understand, edit and maintain.
A new Insert Object wizard allows you to create nested XHTML object tags to embed common media
players into exercises.
All old output formats have been removed, to simplify the applications and keep bloat to a minimum.
However, if you still want to use v5 output, you can continue to run version 5 alongside version 6.
The suite has a new-look interface, with new icons which we hope are clearer and more colourful than
the old ones., and many changes have been made to increase support for accessibility.
-o-
Getting started
If you have worked with previous versions of Hot Potatoes, the interfaces of these programs will be
familiar to you, and you will probably want to jump right in and start work. However, if the programs are new
to you, we recommend that you work through the tutorial before you start. You can run the tutorial by
clicking on Tutorial in the main Hot Potatoes screen, or by double-clicking the Tutorial icon in the Hot
Potatoes folder.
Also, once you start using the applications, remember that they all have context-sensitive help. Simply
press F1 at any time, and you should see a Help screen appropriate to the task you're working on.
-o-
Windows 98, ME, NT4, 2000, XP, Vista or Windows 7. Windows 10 should also work, although we do
not test on Windows 10. To use Unicode text, 2000 or above is required. You can also run these
Windows programs on Linux using WINE.
A modern Web browser (Firefox, Safari, Opera, Chrome, Chromium, etc.)
Access to a Web server (if you wish to deliver your exercises on the Internet).
If you know HTML and JavaScript, you will be able to exercise more control over the final format and style
of your exercise pages, but this is not a requirement for creating useful interactive pages with Hot Potatoes
.
To use the exercises, your students will also need an appropriate browser. They do NOT need Hot
Potatoes itself.
-o-
You type in the questions, answers, feedback etc. which forms the basis of the exercise. See Entering and
saving data for more information on this.
The "configuration" is a set of information used to compile the Web pages. It includes instructions for the
student, captions for navigation buttons, and other information which is not likely to change much between
exercises. See Configuring the output for more details.
This is simply a matter of pressing the "Export to Web" button on the toolbar, choosing a file name, and
letting the program do the rest. See Creating Web pages for further information.
-o-
JQuiz: .jqz
JCloze: .jcl
JCross: .jcw
JMix: .jmx
JMatch: .jmt
If you want to make changes to your exercise later, you can reload the data file, make the changes, and
create new Web pages. Please note that you CANNOT RELOAD THE WEB PAGES INTO THE
PROGRAMS, so it is important to save your data files.
-o-
Each program provides an interface to the configuration file, accessible through the Configuration button
Here is another page in the configuration dialog. As above, you can click on the graphic to get more
information about the items:
Adding a timer
You can add a timer to your exercise by specifying this in the Timer tab of the Configuration screen.
Check the checkbox to include the timer, and set the time limit in minutes and seconds. When the timer
runs out, the student's work so far will be scored, and the score displayed; after that, no further work on the
exercise will be possible.
Please note that the student can always reload the page and start again, but they'll have to do all the work
a second time to complete the exercise.
-o-
Adding graphics
It is possible to type HTML tags directly into most of the Hot Potatoes text boxes, in order to insert images
or links into the Web pages. However, if you want to insert a graphic, you can use one of the built-in
functions to help you. With your cursor in a Hot Potatoes text box, click on the Insert menu and choose
Picture / Picture from Local File. A dialog box will appear, allowing you to select an image from your hard
drive. Then you will see the screen below. From this screen, you can configure the information which will
create the IMG SRC tag and insert it in the text box. Note that Hot Potatoes is NOT a WYSIWYG Web
page editor; the tools on the Insert menu are only intended to help you create HTML code for the page, and
you will not see the image until you actually compile the page. Also, note that the program automatically
creates a relative file path between your data file (your .jqz, .jcl or other Hot Potatoes file) and the image
file on your hard drive. If you do not intend to put your HTML pages in the same place as your data file
relative to your image files, then you will need to configure the relative path manually to ensure that the
image appears on your page. This will be much easier if you understand basic HTML.
Here is the Insert picture screen. Click on the graphic to get more information about how it works.
Adding links
You may wish to insert a link to another Web page in one of the fields in your exercise. To make a simple
link to a Web page, click on the Insert menu and choose Link / Link to Web URL, and you will see the
screen below. You can also insert a link to a page on your hard drive by choosing Link / Link to Local File;
if you do this, you will see a dialog box from which you can choose the file to link to, and a relative path
between your data file and that file will be created automatically. Note that if the file structure you plan to
use on the Web server is not the same as that on your hard drive, or if you store your Hot Potatoes data
files separately from your HTML pages, you will have to edit the relative path manually to make the link
work. This means understanding some basic HTML.
Here is the Insert link screen. Click on the graphic to get more information about it.
You can use these link functions to add sound and video to your pages -- see Inserting an object for more
information on this.
Inserting an object
The XHTML5 specification includes a sophisticated system for embedding audio and video players. You
can use this system to include (for example) an mp3 audio file or an mp4 video on your Web page, by
using the Insert / Media Object menu command. Just as when you insert a picture, all you need to do is to
place your cursor in the position where you want to insert the object, and click on the menu item. You'll see
a screen that looks like this:
At the top is a Browse button that enables you to find the media file you want to insert (in this case, an mp3
file). Once you have selected the file, a "Play" button will appear, so you can check that you have the right
file by listening to or watching it. Below that, you'll see Width and Height settings; these will determine the
size of the player in the page. If you're only inserting an audio file, these will be ignored, but if you're
inserting video, don't forget to make the object large enough to include both the video display and the
control panel for playing it.
Finally, at the bottom, you get the chance to include a link to the media file, just in case the browser cannot
play your file. We recommend that you always do this, because you can never be sure what capabilities
any given browser may have.
When you press OK, the required code will be generated by the program and added to the Hot Potatoes
text box. (The source for this code is the source file hp7objecttags.ht_, so you can modify it if you know
HTML well.)
-o-
Using Unicode
Unicode is a standard system for encoding characters from almost all human languages in such a way that
languages can be mixed easily in the same document, and displayed reliably without the need for special
fonts. Windows 2000 and all later versions support Unicode natively, and Hot Potatoes version 6 makes
use of this to enable you to create exercises in virtually any language (or a mixture of languages).
First, you need to make sure that you have configured Windows to support the language(s) you want to
use. There are three components to this:
1. Language support
2. Fonts
3. Keyboards/Input method editors
For example, if you want to use Japanese in any of your Windows programs, you need to go to the Control
Panel, open Regional and Language Options, click on Languages and Details, and add the appropriate
Japanese language and input method editor settings. You may also need to install fonts for Asian
languages if they're not already installed.
None of this has anything to do with Hot Potatoes; if you're having trouble with this, then you need to
consult your Windows documentation or get help from another user who is familiar with using this language
in Windows. Once Windows is set up for input in a particular language, you should be able to switch to that
language in the language bar or the Control Panel, and then type directly into Hot Potatoes in that
language. You may need to change the font used in Hot Potatoes (Options / Font...) in order to make the
characters show up correctly. Once you are able to type your language into the Hot Potatoes text boxes,
everything else should work automatically; when you export your exercise, the Unicode text should show
up as expected in your Web browser.
Note that if you are using a right-to-left language in your exercise, you should check the option in the Other
tab of the Configuration screen to ensure that the exercise is processed for right-to-left functionality. This
will adjust relative font sizes and alignment so that your right-to-left text looks good on the Web page.
-o-
All of the Potatoes use the same command to create a single HTML file. You can post this file on your
server, and the exercise will appear when you load it. If you are using JMix or JMatch, there are other
options, however. JMatch has two other output types: one is a flashcard output, which you can use to let
your students practice or memorize something before quizzing them on it, and the other is a drag-and-drop
form of the exercise. JMix also has a drag-and-drop format.
You should choose an output format based on the needs of your users, the type of material, and the kind of
screen resolution you can expect your users to have. For example, if you are using JMatch, and you know
some of your users have only 15" screens with a resolution of 800 by 600, don't create drag-drop exercises
with more than five or six items, because they won't fit on the screen; either use the "standard"
non-drag-drop output, or make your exercises smaller by reducing the number of items in each exercise.
When you have selected the type of output you want, and specified a file name, the Web page will be
created. The program will then ask you if you wish to see the exercise in a browser. If you say yes, then
your default browser program will be launched, and the exercise will be loaded into it. You can check that
the results match your expectations.
If you enter a file name containing a space, the program will warn you that this is not a good idea; the
reason for this is that on many Web servers, spaces will be replaced with "%20", and therefore the URL of
your document may not be what you expect it to be. It's best to avoid spaces in the file and folder names of
Web pages.
If you are upgrading from Hot Potatoes version 5, you will find that the old output formats are no longer
available in version 6 of Hot Potatoes. We have removed them to improve the standards-compliance of the
-o-
When you click on Create zip package, you'll be asked to choose a location for your zip file. Then the
program will create a zip file containing the following files:
1. An HTML file of your exercise, with all links to media files converted to simple file names.
3. A JavaScript code file (if Create separate JavaScript file is checked in the Configuration screen).
You can take this zip file and move it anywhere, and as long as you extract all of its files into the same
folder, the exercise should work.
-o-
In any of the Potatoes, if you go to the Configuration screen and click on the Buttons tab, you will see
settings for these three buttons. You can decide whether or not to include the buttons, and you can set the
caption that will appear on the buttons. If you want the buttons to work, though, you will have to tell the
program where the next exercise and the contents page actually are, so the button can jump to them. To
do that, just enter the URL or path to the next exercise in the correct box, then do the same with the
contents page. Note that these can be complete URLs, beginning with http://..., or they can be relative
URLs. In the simplest case, if the current exercise and the next exercise will be in the same folder, then all
you need to enter is the filename of the next exercise.
Here's an example:
You're making a page called exercise1.htm, and you want to link it to exercise2.htm. Both of these files
will be in the same folder.
You should see a Next Exercise button on the page. When you click on it, the browser will go to
exercise2.htm (providing that exercise2.htm exists).
The Contents button works the same way as the Next Exercise button, but the Back button is different --
all that does is to take you back to whatever page you were on before (like pushing the back button on your
browser toolbar).
If this all seems rather complicated to you, have a look at the Masher, which is designed to do this kind of
linking automatically.
For cases like this, in JQuiz and JCloze you can provide an "onscreen keyboard" consisting of a set of
buttons on the exercise Web page. You'll find this option on the Other tab of the Configuration screen. If
you simply check the option "Include a keypad to help the student type non-roman characters", when
the exercise is created, the program will provide a button for every character included in the answers. If you
want to add more buttons to the keyboard, you can type the relevant characters into the box below. When
you create the exercise, you'll see a set of buttons below the answer boxes. Clicking in an answer box and
then pressing one of the buttons will "type" that character into the page.
Under normal circumstances, the items in the keypad are automatically sorted into alphabetical order.
However, sometimes that doesn't quite work as you expected (it can depend on the dominant locale in your
Windows installation), and sometimes it's not what you want. Therefore you can override this setting by
adding a slash character (/) as the first character in the text box in the configuration screen. If you do this,
then all the characters in the box will appear in the keypad in the order in which they appear in the box.
-o-
You can type exercise and configuration text in any language supported by the Unicode standard. See
Using Unicode for more information on this.
When you first started up Hot Potatoes, you were probably asked which language you wanted to use in the
interface, and presented with a range of options. The range of languages in which the interface of the
programs can be displayed is limited to languages based on the 256 characters in the ANSI character set.
This includes all the accented characters such as é, è, ö etc. used in many European languages.
If your language falls into this group, but there is no translation for it available yet, you might want to
contribute one. See Translating the interface for more information on this. All the interface translations
distributed with the program have been contributed by members of our user community.
-o-
The Masher has its own Help file -- to view the Help, start the Masher program by double-clicking on its
icon in the Hot Potatoes folder, then press F1. It also has its own tutorial, accessible from the Tutorial link
on the Help menu.
-o-
-o-
This is the complete range of toolbar buttons. You can jump to the relevant menu page to find out about
individual items.
-o-
-o-
-o-
-o-
-o-
JQuiz
The main JQuiz screen
JQuiz is used to create question-based quizzes. A JQuiz exercise can contain an unlimited number of
questions, from four different question types, and each question can contain an unlimited number of correct
or incorrect answers, each with feedback. Here is the main screen of the program. Click on the graphic to
get information about each feature.
In multiple-choice questions, the student chooses an answer by clicking on a button. If the answer is
correct, the button caption will change to a smiley face :-), and if it's wrong, it will change to an X (you can
configure these bits of text in the configuration screen). In either case, the student will see feedback
specific to that answer, explaining why it's right or wrong (assuming you write the feedback when you make
the exercise!). If the answer is wrong, the student can continue choosing answers until a correct answer is
selected. The score for each question is based on the number of tries taken to get a correct answer. Once
a correct answer is chosen, the scoring is "frozen", but the student can still click on buttons to see the
feedback for other answers without penalty.
In short-answer questions, the students has to type the answer into a text box on the page, and press a
Check button to see if it is correct. The page will try to match the student's answer to a list of correct or
incorrect answers you have defined. If a match is found, the feedback for that answer will be shown. If not,
then the page will try to find the nearest match among the specified correct answers, and signal to the
student which parts of their answer are right and which parts are wrong. The score for each question is
based on the number of attempts the student makes before getting a correct answer. You can also include
a Hint button, which will give the student one letter of the answer; using the Hint button incurs a penalty on
the score.
Finally, a multi-select question asks the student to select several of a specific set of items. The idea here
is that the student must select all the correct items, and not select all the wrong items. This type of question
might take the format "Which of the following are nouns?", followed by a list of words. The student must
check all the nouns, but not check any answers which are not nouns, then press a Check button. If the
answer is not completely correct, the student will see a readout of the number of correct choices, and one
piece of feedback; this would be the feedback from the first item in the list which was either selected when
it shouldn't be selected, or not selected when it should be selected.
-o-
Also, note that you can choose whether to make answer-checking case sensitive or not. In normal
circumstances, if you are making short-answer quizzes, it would probably make sense to have
case-sensitivity switched off, so that it doesn't matter whether the student enters an answer in upper case
or lower case. However, if your quiz asks for answers in sentences (as for example in the case of a
grammar exercise), then using the correct case where necessary might be part of the exercise. In this
case, case-sensitivity should be turned on.
Finally, both JQuiz and JCloze include the option to add an onscreen keyboard for students to type
non-roman characters into answer boxes.
For more information on the configuration screen and configuration files, see Configuring the output.
-o-
Question Weighting
With this option, you can change the relative importance of different questions in the overall score. For
instance, you could set one question to be worth only 10, while another is worth 100 (the range is 0-100); in
this case, the score for the second question would be worth ten times as much as a component of the
overall quiz score than the score for the first question.
Another use for question weighting might be to give students one or two "trial questions" at the beginning of
a quiz, in case they're new to online exercises. If you set the question weighting to zero, then the student
can do the question without penalty; there will be no effect on their score.
This option allows you to designate that an answer should be "accepted as correct" if the student chooses
it, even if its percentage correctness is not 100%. This has the effect of "finishing" the question on the Web
page, so that no further tries will be accepted. If you want your exercise to behave like a traditional test,
where only one attempt is allowed, then you could set all your answers to "accept as correct".
-o-
JCloze
The main JCloze screen
JCloze creates gap-fill or cloze exercises. This is the main screen of JCloze. Click on the graphic to learn
more about its functions.
-o-
1. Instead of text boxes, each gap will show as a drop-down list, consisting of a list of all the gapped
words in the exercise.
2. The hint button will not be shown (because there's no need for hints if the words are all shown in the
list).
3. The keypad will not be shown (because there's no need to type answers).
Make answer-checking case sensitive allows you to switch on or off case-sensitivity on the Web page
(as you can do in JQuiz). Include word list with text allows you to include a list of the gapped words from
the text, mixed up, in a box at the top of the page, to make the exercise a little easier.
The fourth setting is Include clue button for each gap, which is on the Buttons page. If you have
specified clues for your gaps, check this option to make sure that a button will appear next to each gap
which has a clue associated with it, so the student can see the clue. See Adding alternate correct answers
and clues for more information on this.
Both JQuiz and JCloze include the option to add an onscreen keyboard for students to type non-roman
characters into answer boxes.
For more information on the configuration screen and configuration files, see Configuring the output.
-o-
JCross
© Half-Baked Software, Inc., 1998-2019
p24
The main JCross screen
This is the main screen of JCross. Click on the graphic for more information on each item.
-o-
Entering clues
When you have created your grid, you can click on the Add Clues button to enter clues for all your words.
At this point, the program will work out the numbers of the words, and show you the screen below. Note
that even after this, you can make any changes you wish to the grid; the program will remember the clues
you already entered and match them up with the correct words again, even if you move the words around
on the grid.
This is the Add Clues screen. Click on the graphic to get more information.
For more information on the configuration screen and configuration files, see Configuring the output.
-o-
Printing in JCross
If you use the File / Export for printing option in JCross, the output is a Web page, and in order to print
this properly, you will need to set the print options in your browser correctly. For example, in Internet
Explorer, you will need to check the option "Print background colour and images". The same applies if your
students are trying to print a JCross crossword from their Web browser.
-o-
Beginning with version 6.2.0.6, JCross allows you to create case-sensitive crosswords. There are two
distinct controls involved:
First, you need to be able to enter lower-case letters into the grid. Normally, JCross upper-cases letters
you type into the grid automatically. On the Manage Grid menu, you'll find a menu item Force upper case.
-o-
JMix
The main JMix screen
This is the main screen of JMix. Click on the graphic to get more information on how the program works.
-o-
Yes
,
we
have
no
bananas
Note that the comma and period are also on separate lines, so that they become separate segments. You
can of course have longer segments consisting of multi-word phrases such as "University of Victoria". Also,
you can break up one word into individual letters, to create a mixed-up word puzzle.
-o-
In a JMix jumbled sentence exercise, it is difficult for the program to tell which of these is intended. The
single quotation is therefore always treated as an apostrophe; if you want to use quotation marks, please
use the double quotation ( " ) in JMix. It's probably best to avoid quotation marks altogether if you can.
Also, the angle bracket characters ( < and > ) are sometimes problematic on Web pages since they are the
delimiters for HTML tags, so these should be avoided unless you are using HTML tags on purpose -- for
example, by creating a drag-and-drop output page which uses pictures instead of words.
-o-
The Prompts/Feedback page of the Configuration screen has a checkbox item, Always capitalize first
letter. When this option is checked, the first letter of the student's answer will be capitalized (as it should
be in a normal sentence) while the exercise is being completed. If you are compiling for drag-and-drop
output, note that this option can cause slightly annoying behaviour under Internet Explorer; it can cause the
text on multiple segments to become selected. You might therefore want to turn the option off if many of
your users will be using IE. Also, if you are creating mixed-up-word puzzles (by breaking up one word into
separate letters), then you will probably want to turn this off.
For more information on the configuration screen and configuration files, see Configuring the output.
-o-
JMatch
The main JMatch screen
This is the main screen of JMatch. Click on the graphic to get more information about how the program
works.
JMatch output
JMatch includes many different output options; it has standard V7 output, drag-and-drop output, and also a
flashcard option that you can use to help your students memorize matching items. JMatch feedback
capabilities are limited to right/wrong and scoring. However, for basic matching and ordering exercises, we
feel that this limited interface is sufficient.
The drag-and-drop output is in some ways much more effective than the standard output, in that it allows
you to include pictures in both the left hand (fixed) items and the right-hand (draggable) ones. However,
both types of output have their place. A drag-and-drop exercise can be very difficult to do if the page is too
big for the user's screen; he or she will have to scroll around quite a lot, and may end up frustrated. The
simpler standard output is much more effective if you want to include a large number of items on one page.
We recommend using the drag-and-drop output only if you have fewer than 12 items, and preferably no
more than eight. For exercises with more than 10 or 12 items, the standard output is usually better.
Starting in version 7, JMatch allows more complex exercise items. For example, you can include
distractors on the left by leaving the right cell empty; this will create a left item in the output which has no
match. You can include distractors on the right by leaving the corresponding left cell empty; this will create
a right item that does not match anything, and therefore should not be chosen. Finally, you can have
duplicate items on the left or on the right. JMatch should handle these situations elegantly in the web
output, marking any acceptable match correctly. However, if you make use of these complex features,
make sure that your instructions are clear, otherwise students may feel they ought to match all items on
both sides.
-o-
For more information on the configuration screen and configuration files, see Configuring the output.
-o-
Hot Potatoes v. 6.3 and above is freeware. You are welcome to use it for any project you like, for as long
as you like. You will be prompted to register when you start the application. This process simply asks for
your name, and stores it in the system registry; your name will be inserted into exercises you create with
Hot Potatoes, identifying you as the author of the exercises. It will not be sent to us or to anyone else.
You must insert a user name in order to unlock all the features of the programs.
-o-
Frequently-asked questions
Can I make separate config files for each app?
By default, all of these programs share one configuration file (for example, english5.cfg), which resides in
the program folder. This ensures that if, for example, you change the caption of the Check button in one
program, the caption will be changed in all the other programs too.
However, there may be circumstances when you don't want this behaviour. For example, you may be
creating gap-fills in German and crosswords in French. In this case, you need to create separate
configuration files for each program. First, start up one of the programs and go to the configuration screen.
Choose Save As, and save the current configuration with another name. This new file will henceforth be
the default configuration file for this program. Now you can make all the changes you want to make, and
save the file again.
If, later, you want to go back to using the default configuration file, just go to the configuration screen and
reload english5.cfg.
-o-
Versions 2 and above of Hot Potatoes will not read data files from version 1 of JBC or JQuiz. However, all
future versions will read data files from version 2 onwards. In other words, there should be no file
incompatibilities from version 2 onwards -- all programs should read all data files produced by previous
versions.
We apologise for "orphaning" version 1 files in this way, but the exercise and file structures are so different
that it seemed better to make a clean break.
You can in fact insert ANY HTML code you wish into the textboxes of Hot Potatoes programs, and in most
cases the results should display on the Web page. For example, if you want to add a graphic to a question
in JQuiz, you can simply insert the HTML code <img src="mygraphic.gif" /> into the question box, next
to the question, and the image should show up on the page. There are odd exceptions to this, depending
on what the text in question is actually going to be used for -- see, for example, Using brackets and
quotation marks in JMix. However, with a little experimentation you should be able to achieve the effects
you require. For precise control over the appearance of the page, however, it is probably best to edit the
Web page AFTER it has been produced by one of the Hot Potatoes programs, being careful not to change
or delete anything which might interfere with the proper operation of the JavaScript code.
If you do find yourself inserting a lot of HTML into the pages, check out the Keystroke shortcuts for HTML
tags -- they will probably save you a lot of typing.
-o-
-o-
All of the Hot Potatoes programs (in the Windows version) are standalone applications, and you can run
them individually by double-clicking any of the icons in the Hot Potatoes folder. You can also add the ones
you use most to the Start menu if you wish -- see Windows Help on how to do this.
-o-
However, the basic functionality of the programs is the same in both versions, and the exercises produced
by each are the same. In addition, the file formats are standardized, so you can share data, configuration
and source files between Windows and Macintosh versions. You cannot, however, share interface
translation files.
-o-
On each question, one "wrong try" is recorded for each time you make a guess, until you hit the correct
answer. Thus for Q1, if you hit a wrong answer once, then a right answer, you have one wrong try. You
also lose points for using the Hint button in a short-answer quiz, or checking an answer which turns out to
be wrong. Once you get the correct answer for any given question, a score for that question is calculated
and stored; that score is based on the number of possible wrong answers and the number of wrong tries.
The score overall is calculated by totalling the scores for all the questions that have been answered so far,
and turning the result into a percentage. If question weighting has been used (see Beginner and Advanced
modes), the final score will take account of the weighting of the question, so that questions with more
weight contribute more to the overall score.
Once you get a multiple-choice question right, you're at liberty to hit all the wrong answers without any tries
being recorded, so that you can investigate other answers without penalty. This can be the source of some
confusion; if you get a right answer first time on any question, no more tries are recorded for that question,
and therefore no "marks" appear when you click on an answer; however, the correct feedback is shown.
This seemed to us, after much thought, to be the fairest system (although it certainly isn't easy to explain!).
However, if you'd like to use a different one, you can change the scoring system by editing the JavaScript
code which calculates it.
-o-
2. Asking for a hint on any gap will reduce the score for that gap proportionately to the number of letters in
that answer. In other words, if you ask for a hint on a five-letter word, then one-fifth of the score for that
word will be lost.
3. Asking for a clue on any gap will cut the score for that word by half.
4. Every time you click on Check, if the answer is not completely correct, there is a penalty.
In other words, if a student uses hints and clues repeatedly while completing an exercise, his or her score
will be reduced considerably, and may even end up at zero. Students should complete the whole exercise
before pressing the Check button; if they check each answer as they enter it, they will lose a lot of points.
-o-
a) There are five items. You make your selections, and check your answer.
b) One of your items is wrong, so you incur one penalty point for a Check with a wrong answer.
c) You correct your mistake, and check again. Your final score is:
5 correct out of 5, minus one penalty point for your incorrect check, which is 4 / 5 => 80%.
-o-
-o-
http://tech.groups.yahoo.com/group/hotpotatoesusers/
-o-
Internet help
We no longer provide technical support for Hot Potatoes version 6.
On the Hot Potatoes Web site, there is a page of Frequently Asked Questions along with old bug
reports and update information. In addition, there is a bulletin board (
http://tech.groups.yahoo.com/group/hotpotatoesusers/) where you can post questions and get help
from other users.
-o-
http://hcmc.uvic.ca/
Half-Baked Software Inc. is a legal corporation, which handles the commercial aspects of Hot Potatoes.
The Half-Baked Software home page is at:
http://www.halfbakedsoftware.com
This version of Hot Potatoes was written by Martin Holmes using Borland Delphi version 5. All code (with
the exception of freeware and open source components mentioned in the Acknowledgements), and all
content and ideas are copyright Martin Holmes, Half-Baked Software and the University of Victoria
Humanities Computing and Media Centre, 1997-2019.
Acknowledgements
We owe profound thanks to many people for their help, suggestions, beta-testing and checking. We are a
team of two programmers, and we have very little time to devote to Hot Potatoes, so we need all the help
we can get in terms of testing, proof-reading and so on. Almost all of this help is provided by people from
our user community.
A special thanks must go to Troy Wolbrink, whose freeware Unicode components are the basis for the
Unicode support available in version 6 and 7 of Hot Potatoes.
The following people have helped with beta-testing and translation of versions 6 and 7:
Agnès Simonet
Michael Slater
Rodolphe Maurel
Manuel Borges da Silva (Portuguese resources and translations)
Paolo Cutini (Italian resources and translations)
Predrag Pale and Saida Deljac (Croatian translation)
Stefan Stefanov (Bulgarian translation)
Wynand Boshoff (Afrikaans translation)
Maria Lucka (Slovak translation)
Niyazi Çelik (Turkish translation)
Lee, Chan-young (Korean translation)
Geir Håkon Eikland (Norsk bokmal translation)
Elek Mathe (Magyar translation)
Luciano Saul Cardoso (Brazilian Portuguese translation)
Yiannis Salonikides (Greek translation)
Lidija Kralj (Croatian configuration file)
Dzmitry Sokal (Russian translation)
Marina Aalto (Russian configuration file)
Dusan Klemencic (Slovenian translation)
Anders Berggren (Swedish translation)
Michael Rottmeier (worked really hard on version 5.5/hotpotnet -- thanks indeed!)
Bernard Dyer, for several years of steady and useful input
Jouni Paakkinen (Finnish translation)
Thom Hiemstra (Dutch translation)
Hans Le Roy (Dutch configuration file)
Fabien Olivry (French translation)
Lars Acou (Dutch translation)
Daniel Sedlbauer (French translation)
Guida Querido (Portuguese translation)
Richard Nisius (German translation)
Henny Jellema
Stefan Eberhard
Fernanda Rodrigues
Maria Kyung Overgaard (helped on testing Arabic)
Randy Laws
Jørgen Brenting
Glenys Hanson
Chris Bey
Jens Østergaard Petersen
Portions of this software (specifically, the components underlying the network communication capabilities
used for uploading files to hotpotatoes.net) are Copyright (c) 1993 - 2001, Chad Z. Hower (Kudzu) and the
Indy Pit Crew - http://www.nevrona.com/Indy/. Indy is an open-source software project which comprises a
large set of network communication components for Delphi.
Also, thanks go to Jan Goyvaerts for the use of his free Delphi units enabling me to link the applications to
the HTMLHelp .chm files.
Thanks to all, and to others too numerous to mention who have expressed support and given feedback on
the development of these programs over the last two decades and more.
-o-
We have created version 7 of Hot Potatoes as a way to keep the project moving forward into the era of
HTML5, and if we ever have the chance, we would love to create a fully-modernized version 8, but that
depends on our work schedules and priorities. Most maintenance and updating is now done in our free
time, which is precious and limited.
-o-
For power-users
Custom configuration (user strings)
The Custom tab in the Configuration screen allows you to make customized modifications to the source
files which behave like ordinary configuration items. This is how it works:
Imagine that you have a particular bit of text that you want to use in your Web pages -- for example, you
want all your exercises to include "Unit 1", "Unit 2" or whatever is appropriate. You could put this into the
Exercise Title or Subtitle fields, but you might want the text to show up somewhere different. You could
modify the source files to include your text, and then use your modified source files to create the exercises,
but then you have a problem: each time you need to create a new unit, you'll need to edit the source files
again.
The Custom configuration items can solve this problem. This is what you would do:
1. Edit the source files to add this placeholder wherever you want the string to appear:
[strUserDefined1]
2. In each exercise, insert "Unit 1", "Unit 2" or whatever into the first User-defined string box.
Whenever you export using your modified source file, [strUserDefined1] will be replaced with the text in
the box.
The fourth, larger box has a slightly different purpose. Anything inserted into this box will be placed inside
the HTML <head> element in the output page. If you would like to define your own JavaScript functions or
CSS code, you can add it here, and it will be placed in the page header automatically (without any need to
modify the source files).
All version 7.0 output is now XHTML5 compliant. This means that the exercises are also valid XML files,
and you can also include metadata in Dublin Core format. We have included the appropriate HTML5
document type declaration at the top of the pages.
In addition, Hot Potatoes data files are standard XML files that can be used in any other application
capable of parsing XML.
-o-
If you click on File / Add Metadata (or the equivalent toolbar button), or press the Control + M, you will
see a screen that enables you to add metadata to your exercise files. Clicking on the drop-down element
list allows you to choose from the 15 Dublin Core elements; you can then add one or more instances of the
element by typing the data in the data box. If you need more than one instance of an element, use the spin
button to add more. According to the standard, you can have as many instances of each element as you
wish.
As you add the data, you will see the XML output box display it. You don't need to do anything with this
information; the program will automatically insert it into the relevant places in the data file and the output.
-o-
When you insert it into your LMS, the exercise will be able to report back to the LMS about the actions
taken by the student, including the time spent on the exercise, the student's score, and the way it finished
(completed, incomplete, timed-out, etc.). Other information may be reported to the LMS as well, depending
on the exercise type itself, and the capabilities of the LMS system. Please note that various learning
management systems support SCORM in different ways, and to different degrees; some will store only the
score and timing of the exercise, while others will store all the information submitted by the exercise. Hot
Potatoes exercises submit quite a lot of information, including all answers chosen or checked by the
student (including incorrect answers) and, for JCloze and JQuiz, scores for each individual item in the
exercise.
One warning is in order: don't use spaces or other punctuation in the filenames of your exercises. It's not a
good idea to do that in any circumstances, but it can be more problematic in a SCORM package. Spaces
If you like to create your own SCORM packages, you can take another approach. In the Configuration
screen, on the Other tab, you'll find a checkbox for including SCORM 1.2 support in the exercise. If you
check this checkbox, the code that the exercise uses for communicating with the LMS system will be
included, so the exercise will be able to tell the LMS about scores etc. You could then build your SCORM
package with an external tool, specifying your own metadata and so on, or make the Hot Potatoes exercise
part of a larger SCORM package which includes other materials.
You can also use the Masher to create a larger SCORM package for an entire unit of materials. See the
Masher Help for more information on this.
To learn more about SCORM, visit the Advanced Distributed Learning Website:
http://www.adlnet.gov/scorm/
-o-
When you create a Web page, all the JavaScript code which is normally in the head of the exercise (and
which contains the questions, answers etc.) will be separated out into a separate file, with the same file
name, but with the extension .js instead of .htm. Both files will be needed for the exercise to work, and they
must be placed in the same folder on your Web server. This might be useful if you want to make it a little
more difficult for students to see the source code and read the answers and feedback while doing the
exercise. Note that this certainly does not make it impossible to read the files; any technically-competent
user can find the relevant browser cache file and open it.
-o-
There are also keystroke shortcuts to help enter common HTML codes quickly and easily into the
programs, so these have been added. Here is a list of the shortcuts:
For container tags, first select some text if you want to place the text inside the container tag. Hold down
Control and Shift, then press:
Note that in some situations, inserting HTML tags is NOT a good idea; you may cause exercises to fail if
you put the wrong tag in the wrong place. If you do insert tags, make sure you test your pages thoroughly to
make sure the tags have not interfered with the ordinary functioning of the pages.
-o-
-o-
Each source file contains all the code necessary for creating a page. All the elements in the page which are
entered from the data (questions, answers etc.) are placed into the page at compile time. The source files
contain placeholders for these elements, surrounded by square brackets. For example, you may see the
placeholder [strExerciseTitle] in the source file. This will be replaced at compile time by the title of the
particular exercise you are making.
Making changes to the source files is a risky and unpredictable business unless you know what you are
doing. In particular, you may cause problems if you eliminate any of the placeholders. However, as long as
you make changes to copies of the files (see below), and leave the originals alone, you have nothing to
lose!
Source files are stored in the \source\ folder, inside the Hot Potatoes program folder. They are named
according to their application and function -- for example:
Each program looks for source files in a folder you specify; the default is the \source\ folder inside the Hot
Potatoes program folder. Here's an example of how you might edit a source file:
Supposing you want to go back to using the normal source folder in JQuiz? Simply choose "Reset Default
Source Folder" on the Options menu, or press Control + Alt + Shift + T to reset the program to the default
source folder. When you do this, the path to the custom folder will disappear from the status bar at the
bottom left of the screen.
http://hotpot.uvic.ca/howto/hacking_workshop/
http://hotpot.uvic.ca/howto/editsource.htm
http://hotpot.uvic.ca/hotpot/howto/hacking_hotpot.htm
You can set the source folder location for all the programs at once by using the main Hot Potatoes
interface (the one with all the Potatoes) and choosing Project Settings from the Options menu.
-o-
If you click on Options / Interface / Translate the interface, you'll see this screen. Click on the graphic to
get more information about how the translation process works. Note that if you intend to translate all the Hot
Potatoes programs, you should use the same translation file for each one, to avoid duplicating your work.
Translate the first one, then load that translation file into the screen below in the next Potato before
continuing your translation. There is a rudimentary search engine in this screen -- press Control + F to
access it.
The translation files which ship with the program are stored in a folder called translations inside the Hot
Potatoes 7 program folder. However, when you save your own translation file, you will need to save it
outside the Hot Potatoes program folder, in a location where you have write access. If you would like to
contribute your translation back to the project, you can post a message on the Hot Potatoes Users' Group
on Yahoo, which you can also access through the Internet Help items on the Help menu of all the Potatoes:
http://tech.groups.yahoo.com/group/hotpotatoesusers/
If you are a system administrator, you may also want to do a silent install, or customize some aspect of the
installation. The Hot Potatoes Windows installers are created with the excellent Inno Setup program, which
allows the following command-line parameters for silent installs (this text is a stripped down quotation from
Jordan Russell's Inno Setup documentation):
/SP-
Disables the This will install... Do you wish to continue? prompt at the beginning of Setup.
/SILENT, /VERYSILENT
Instructs Setup to be silent or very silent. When Setup is silent the wizard and the background window are
not displayed but the installation progress window is. When a setup is very silent this installation progress
window is not displayed. Everything else is normal so for example error messages during installation are
displayed and the startup prompt is (if you haven't disabled it with '/SP-' command line option explained
above)
/SUPPRESSMSGBOXES
/LOG
Causes Setup to create a log file in the user's TEMP directory detailing file installation and actions taken
during the installation process.
The log file is created with a unique name based on the current date. (It will not overwrite or append to
existing files.)
The information contained in the log file is technical in nature and therefore not intended to be
understandable by end users.
/LOG="filename"
Same as /LOG, except it allows you to specify a fixed path/filename to use for the log file. If a file with the
specified name already exists it will be overwritten. If the file cannot be created, Setup will abort with an
error message.
/NOCANCEL
Prevents the user from cancelling during the installation process, by disabling the Cancel button and
ignoring clicks on the close button. Useful along with '/SILENT' or '/VERYSILENT'.
/DIR="x:\dirname"
Overrides the default directory name displayed on the Select Destination Location wizard page. A fully
qualified pathname must be specified.
/GROUP="folder name"
Overrides the default folder name displayed on the Select Start Menu Folder wizard page.
-o-
All the program files are installed in the main program folder or in subfolders.
One shared ActiveX control, keyhelp.ocx, is installed into the Common Files folder, which is normally
"C:\Program Files\Common Files" on 32-bit Windows and "C:\Program Files (x86)\Common Files" on
64-bit Windows. This file is required to make popups work in CHM Help files. It is provided free by
Keyworks.net. This file may be used by more than one program, so be wary of deleting it. When you
uninstall Hot Potatoes, you will be offered the option to delete it if no other programs are using it.
NO FILES ARE INSTALLED ANYWHERE ELSE (i.e. nothing goes into the windows or windows\system
folders).
In the main folder are the program files, dlls, help files and configuration files. These are essential.
In the translations subfolder are the configuration and interface files for languages other than English. If
In the source subfolder are the source files used for generating Web pages. These are essential.
In the srcbackup subfolder are duplicate copies of the source files. These are used when source files are
restored to their original state. It's a good idea to leave these files alone.
In the tutorial subfolder are all the files related to the tutorial. If you have done the tutorial, you can delete
these files. However, you might find it useful to keep them around, because you can analyze the example
data files to find out how particular exercises are created.
Under HKEY_CLASSES_ROOT:
.jbc (included for backwards compatibility with early versions of Hot Potatoes)
.jqz
.jcl
.jcw
.jmx
.jmt
.jms (Masher files)
.bjm (Masher batch files)
HotPotJQuizFile
HotPotJClozeFile
HotPotJCrossFile
HotPotJMixFile
HotPot JMatchFile
HotPotMasherFile
Under HKEY_CURRENT_USER:
An entry is created under Software for HalfBaked, and below this an entry for HotPotatoes. This contains
all the configuration information for the suite. Version 7 information is stored in HotPotates\7\.
-o-
- -
configuration, JMatch 29
features, new in this version 5
menu, edit 18
scoring in JBC 32
-.-
.js files 38
-3-
3, version, source file changes 4
-A-
About the authors 33
accented characters 16
Acknowledgements 34
Adding a reading text 10
Adding a timer 11
Adding alternate correct answers 23
Adding graphics 11
Adding links 12
answers, hiding from students 38
authors, about 33
-B-
Basic instructions 7
Beginner and Advanced modes 22
bold 38
Breaking up the sentence into segments 27
browser versions 7
bundle 15
-C-
calculating scores in other apps 32
Can I insert graphics into my Web pages? 31
Can I insert sound and video? 31
Can I make separate config files for each app? 30
capital letters in the JCross grid 26
case sensitivity (JCross)
Case sensitivity in JCross 26
clues, JCross 25
Conditions for using Hot Potatoes 4
-D-
data, entering and saving 7
DHTML output 14
Do I need to run the "front end" all the time? 31
double-byte characters, inserting 13
Dublin Core Metadata 37
-E-
E-Mailing of student results 33
edit menu 18
Editing the source files 39
Entering and saving data 7
Entering clues 25
Export to Web 14
-F-
file menu 17
files 15
files from previous versions 30
files installed with the programs 42
font tags, HTML 38
foreign languages 16
frames, not used in JMatch 29
freeware conditions 4
future developments of Hot Potatoes 36
-G-
getting scores from Web pages 33
Getting started 6
glossing a word 38
Graphics in Webpages 31
graphics, adding 11
-H-
Help menu 20
Help, Internet 33
Hot Potatoes, conditions for using 4
Hot Potatoes, future developments 36
-I-
Insert menu 18
insert picture 11
Inserting an object 13
inserting graphics 11
Inserting Unicode characters 13
installation -- what is installed? 42
installing 41
installing and uninstalling Hot Potatoes 41
interface translation 40
Internet help 33
Introduction 4
Introduction to the Masher 16
italics 38
-J-
JavaScript files, separate 38
JBC, reading text 10
JBC, scoring 32
JCloze configuration details 24
JCloze, alternate correct answers 23
JCloze, main screen 23
JCloze, scoring 32
JCross case sensitivity 26
JCross configuration details 26
JCross printing 26
JCross, entering clues 25
JCross, main screen 25
JCross: capital letters in the grid 26
JMatch configuration details 29
JMatch output 29
JMatch, main screen 28
JMix configuration details 28
JMix, brackets in 28
JMix, main screen 27
JMix, quotation marks in 28
JQuiz configuration details 22
JQuiz question types 21
JQuiz, main screen 20
js files 38
-K-
© Half-Baked Software, Inc., 1998-2019
p46
keystroke shortcuts for HTML tags 38
-L-
languages, interface 40
languages, non-latin 13
learning management systems 37
linking a series of exercises 15
linking to other files 12
links, adding 12
LMS 37
loading old files 30
-M-
Making separate JavaScript files 38
making Web pages 14
Manage Grid menu 19
Manage Questions menu 19
Masher 16
menu, file 17
menu, Help 20
menu, Insert 18
menu, Manage Grid 19
menu, Manage Questions 19
menu, Options 19
Metadata, Dublin Core 37
multi-select 21
multimedia files 31
multiple correct answers in JCloze 23
multiple-choice 21
-N-
navigation 15
navigation buttons 15
new features 5
Next Exercise button 15
Notes for upgraders 4
-O-
objects, inserting 13
old JBC and JQuiz files 30
Options menu 19
output from JMatch 29
output to DHTML 14
output to HTML 14
-P-
package 15
pictures, inserting 11
popup gloss 38
printing crosswords 26
Printing in JCross 26
-R-
RDF 37
reading text, adding to JBC 10
registering the programs 30
registration 30
requirements 7
Requirements for using Hot Potatoes 7
results, retrieving and storing 17
-S-
scores and results, e-mailing 33
scores, retrieving and storing 17
scoring in JCloze 32
scoring in other apps 32
SCORM 1.2 37
short-answer 21
shortcut keys for HTML tags 38
sound files, inserting 31
source files, changes in version 3 4
source files, editing 39
source files, how they work 39
subscript 38
superscript 38
support and feedback 33
support and help 33
support for W3C standards 37
-T-
Technical support 33, 33
technical support 33, 33
The Edit menu 18
The File menu 17
The future of Hot Potatoes 36
The Help menu 20
The hotpotatoes.net hosting service: No longer available 17
The Insert menu 18
The main JCloze screen 23
The main JCross screen 25
The main JMatch screen 28
The main JMix screen 27
The main JQuiz screen 20
The Manage Grid menu 19
The Manage Questions menu 19
the Masher 16
The Options menu 19
The Toolbar 17
time limit 11
timer 11
Toolbar buttons 17
Translating the interface 40
-U-
underline 38
Unicode characters, inserting 13
uninstalling 41
upgrading, notes 4
upper-ASCII characters 16
Using Hot Potatoes in other languages 16
Using quotation marks in JMix 28
-V-
V3 output 14
V4 output 14
version 5
version 3, source file changes 4
video files, inserting 31
-W-
W3C standards support 37
W3C standards, support for 37
Web pages produced by JMatch 29
What do I need to use the programs? 7
What do these programs do? 4
What is installed with the programs? 42
what's new in this version 5
Why are the Windows and Mac versions different? 31
Will Hot Potatoes read my old files? 30
-Z-
zip 15