root/trunk/max-javahotpot-tutorial/tutorial/eng/tutorial.2qn @ 35

<quandary-file><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <rdf:Description rdf:about="">
    <dc:creator>Martin Holmes</dc:creator>
    <dc:title>Hot Potatoes 6 Tutorial</dc:title>
  </rdf:Description>
</rdf:RDF><version>2</version>

<quandary><title>Hot Potatoes 6 Tutorial</title><assets><intro-text></intro-text></assets><qnodes><qnode><node-name>Welcome to Hot Potatoes!</node-name><node-contents>This browser-based presentation will introduce the main exercise-types produced by the programs, and take you through the basic steps involved in creating an interactive exercise. Choose one of the options below.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>2</target-id><qlink-text>What is Hot Potatoes?</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>3</target-id><qlink-text>What&apos;s new in version 6?</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>4</target-id><qlink-text>Getting started</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>18</target-id><qlink-text>The &lt;strong&gt;hotpotatoes.net&lt;/strong&gt; server</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>What is Hot Potatoes?</node-name><node-contents>The &lt;strong&gt;Hot Potatoes&lt;/strong&gt; suite is a set of six authoring tools, created by the Research and Development team at the University of Victoria &lt;a href=&quot;http://web.uvic.ca/hrd/hcmc/&quot;&gt;Humanities Computing and Media Centre&lt;/a&gt;. They enable you to create interactive Web-based exercises of several basic types. The exercises are standard Web pages using XHTML 1.1 code for display, and JavaScript (ECMAScript) for interactivity. These core W3C standards are supported by all good modern browsers, including Internet Explorer 6+, Mozilla 1.2+, Phoenix, Safari, and many others. The authoring tools will also handle Unicode, so you can create exercises in virtually any language, or in a mixture of languages.

You don&apos;t need to know anything about XHTML or JavaScript to use the programs. All you need to do is to enter your data -- texts, questions, answers etc. -- and the programs will create the Web pages for you. Then you can post them on your Web site. However, the programs are designed so that almost every aspect of the pages can be customized, so if you do know HTML or JavaScript code, you can make almost any change you want to the way the exercises work or to the format of the Web pages.

If you work in a non-profit-making educational institution or context, and you are prepared to share your exercises by placing them on a publicly-accessible Web server, then you may use the Hot Potatoes suite free of charge. If you are working for a company or in a commercial context, or if you password-protect your exercises or distribute them only on an intranet, you will need to buy a licence (contact &lt;a href=&quot;http://www.halfbakedsoftware.com/&quot;&gt;Half-Baked Software&lt;/a&gt; for information). However, whether you&apos;re commercial or otherwise, we do ask that you register the programs; all you have to do is to &lt;a href=&quot;http://web.uvic.ca/hrd/hotpot/register.htm&quot;&gt;fill in a form on our Website&lt;/a&gt;. This helps us to stay in touch with our users and get some idea of who is using our programs. See the help file for more information on registration.

Now go on to look at some examples of the kinds of exercises you can make using &lt;strong&gt;Hot Potatoes&lt;/strong&gt;. (Note that the data files for all of these exercises are available in the tutorial folder if you want to look at them inside the authoring programs later.)
</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>12</target-id><qlink-text>Example exercises</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>What&apos;s new in version 6?</node-name><node-contents>The Help file contains a more detailed list of new features and changes, but these are the primary differences between version 5.5 and version 6.0:

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Unicode support&lt;/strong&gt;, so you can create exercises in virtually any language or in a mixture of languages. Unicode support is only enabled on Windows 2000 or XP; earlier versions of Windows do not support it.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Mixed question types in a quiz.&lt;/strong&gt; The old JBC (multiple-choice) application has been combined with JQuiz, and the new application allows you to create a quiz with a mixture of multiple-choice, short-answer and multi-select questions, along with a new question type (&quot;hybrid&quot;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;More sophisticated scoring in JQuiz.&lt;/strong&gt; Questions can now be weighted, and individual answers can be given a &quot;percentage correct&quot; setting.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Simpler output format.&lt;/strong&gt; Instead of the old frames-based format, in which the content of exercise pages was written from JavaScript, the new XHTML-based pages are simpler and allow easier editing of the output pages in WYSIWYG editors such as DreamWeaver.&lt;/li&gt;
&lt;li&gt;A &lt;strong&gt;timer&lt;/strong&gt; can now be placed on exercises, rather than on associated reading texts as in previous versions.&lt;/li&gt;
&lt;li&gt;Exercises and all associated media files can be uploaded automatically to an account on the &lt;a href=&quot;http://www.hotpotatotes.net&quot;&gt;www.hotpotatotes.net&lt;/a&gt; server, so that your students can log on and have their results recorded.&lt;/li&gt;
&lt;/ul&gt;</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Back to the index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>4</target-id><qlink-text>Getting started</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>Getting started</node-name><node-contents>The best way to get started with Hot Potatoes is to work through the example exercises; these will show you the different types of exercise you can make, and at the same time teach you some of the basic concepts. Then you can go on to making your first exercise.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>12</target-id><qlink-text>Example exercises</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>13</target-id><qlink-text>The 2-minute challenge: Make your first exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>The Potatoes, one by one</node-name><node-contents>There are six Potatoes in version 6 of Hot Potatoes. Choose the one you want to learn about:</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>6</target-id><qlink-text>JQuiz (question-based exercises)</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>7</target-id><qlink-text>JCloze (gapfill exercises)</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>8</target-id><qlink-text>JMatch (matching exercises)</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>9</target-id><qlink-text>JMix (jumble exercises)</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>10</target-id><qlink-text>JCross (crosswords)</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>11</target-id><qlink-text>The Masher (buildling linked units of material)</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name> Introduction to JQuiz (question-based exercises)</node-name><node-contents>JQuiz is a tool for making question-based exercises. Each quiz can consist of an unlimited number of questions. There are four basic question types:

In &lt;strong&gt;multiple-choice questions&lt;/strong&gt;, 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&apos;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&apos;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 &quot;frozen&quot;, but the student can still click on buttons to see the feedback for other answers without penalty.

In &lt;strong&gt;short-answer questions&lt;/strong&gt;, the students has to type the answer into a text box on the page, and press a &lt;strong&gt;Check&lt;/strong&gt; button to see if it is correct. The page will try to match the student&apos;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 &lt;strong&gt;Hint&lt;/strong&gt; button, which will give the student one letter of the answer; using the Hint button incurs a penalty on the score.

A &lt;strong&gt;hybrid question&lt;/strong&gt; is a combination of a multiple-choice question and a short-answer question. In this type of question, the student is first presented with a text box and asked to type the answer. However, if the student fails to get the answer right after a specified number of tries (which you can configure in the configuration screen), the question changes to a multiple-choice question to make it easier.

Finally, a &lt;strong&gt;multi-select&lt;/strong&gt; 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 &quot;Which of the following are nouns?&quot;, 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 &lt;strong&gt;Check&lt;/strong&gt; 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 &lt;strong&gt;selected when it shouldn&apos;t be selected&lt;/strong&gt;, or &lt;strong&gt;not selected when it should be selected&lt;/strong&gt;.

To try out all these question types, go to this &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;jquiz2.htm&apos;); return false;&quot;&gt;example quiz&lt;/a&gt;.

For an example of how to make a quiz in JQuiz, check out the &quot;Three Steps&quot; link below. For more information on how JQuiz works, check out the &lt;strong&gt;Help file&lt;/strong&gt; -- just start JQuiz and press the &lt;strong&gt;F1&lt;/strong&gt; key.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name> Introduction to JCloze (gapfill exercises)</node-name><node-contents>JCloze is used to make gap-fill or cloze exercises. The idea of a gap-fill exercise is that the student completes all the answers before checking; in other words, it&apos;s a holistic exercise. When all the answers have been entered, the student presses the &lt;strong&gt;Check&lt;/strong&gt; button to mark the answers. Correct answers will be inserted into the text; any incorrect answers will be left in textboxes, so that they can be corrected. When the student checks an answer that is not completely correct, a penalty is incurred, so the score depends on the number of checks required before the answer is completely correct. 

In a JCloze exercise, you can include a &lt;strong&gt;Hint&lt;/strong&gt; button which will give the student one free letter of the answer he or she is currently working on (based on where the cursor is). You can also include a specific clue for each gap. Using the &lt;strong&gt;Hint&lt;/strong&gt; or &lt;strong&gt;Clue&lt;/strong&gt; buttons.

Making a gapfill is easy -- see the picture below for basic steps:

&lt;img src=&quot;jcloze1.png&quot; alt=&quot;Making a JCloze exercise.&quot; title=&quot;Making a JCloze exercise.&quot; width=&quot;600&quot; height=&quot;400&quot;&gt;&lt;/img&gt;

You can also look at this &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;jcloze1.htm&apos;); return false;&quot;&gt;example JCloze exercise&lt;/a&gt;. For more information on how JCloze works, check out the &lt;strong&gt;Help file&lt;/strong&gt; -- just start JCloze and press the &lt;strong&gt;F1&lt;/strong&gt; key.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name> Introduction to JMatch (matching exercises)</node-name><node-contents>JMatch is used to create matching exercises. Basically, this means that a list of items appears on one side, and each one must be matched up to an item on the other side.

JMatch output comes in two types: &lt;strong&gt;standard&lt;/strong&gt; and &lt;strong&gt;drag-drop&lt;/strong&gt;. The standard output (see an &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;jmatch1.htm&apos;); return false;&quot;&gt;example&lt;/a&gt;) uses a drop-down list of items on the right. This is the format to use when you have more than seven or eight items, and the items on the right are only text; if you have only a few items, and especially if the items are graphics, you may want to use the drag-drop format (see this &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;jmatch2.htm&apos;); return false;&quot;&gt;example&lt;/a&gt;). Don&apos;t use the drag-drop format if you have more than eight items, because scrolling on the page will make dragging and dropping difficult.

To make a JMatch exercise, enter each pair of items on the same line, as in the picture below. When you export to create the Web page, the program will shuffle the items on the right for you.

&lt;img src=&quot;jmatch1.png&quot; alt=&quot;Making a JMatch exercise&quot; title=&quot;Making a JMatch exercise&quot; width=&quot;663&quot; height=&quot;489&quot;&gt;&lt;/img&gt;

For more information on how JMatch works, check out the &lt;strong&gt;Help file&lt;/strong&gt; -- just start JMatch and press the &lt;strong&gt;F1&lt;/strong&gt; key.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name> Introduction to JMix (jumbled sentence or jumbled word exercises)</node-name><node-contents>JMix is used to make jumble exercises. You can jumble the words in a sentence, or the letters in a word. Like JMatch, JMix has two output formats: &lt;strong&gt;standard&lt;/strong&gt;, and &lt;strong&gt;drag-drop&lt;/strong&gt;. For examples, see this &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;jmix1.htm&apos;); return false;&quot;&gt;standard exercise&lt;/a&gt; and this &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;jmix2.htm&apos;); return false;&quot;&gt;drag-drop exercise&lt;/a&gt;.

To see detailed instructions for making a simple JMix exercise, go to the 2-Minute Challenge link below.

For more information on how JMix works, check out the &lt;strong&gt;Help file&lt;/strong&gt; -- just start JMix and press the &lt;strong&gt;F1&lt;/strong&gt; key.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name> Introduction to JCross (crosswords)</node-name><node-contents>JCross is used to make crossword exercises. There are two steps to making an exercise: first enter your letters in the grid, then add the clues. To enter letters in the grid, click on a square and type a letter. Try following the example in the picture below to get you started:

&lt;img src=&quot;jcross1.png&quot; alt=&quot;Creating a crossword grid.&quot; title=&quot;Creating a crossword grid.&quot; width=&quot;550&quot; height=&quot;470&quot;&gt;&lt;/img&gt;

When you&apos;ve created the grid, click on &lt;strong&gt;Add Clues&lt;/strong&gt;. Then, to add each clue, click on the word, type the clue, and press the OK button:

&lt;img src=&quot;jcross2.png&quot; alt=&quot;Adding clues.&quot; title=&quot;Adding clues.&quot; width=&quot;504&quot; height=&quot;337&quot;&gt;&lt;/img&gt;

Here is an &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;jcross1.htm&apos;); return false;&quot;&gt;example JCross crossword&lt;/a&gt;. For more information on how JCross works, check out the &lt;strong&gt;Help file&lt;/strong&gt; -- just start JCross and press the &lt;strong&gt;F1&lt;/strong&gt; key.

</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>The Masher (buildling linked units of material)</node-name><node-contents>The Masher is a different kind of application from the others in the Hot Potatoes suite. It&apos;s intended to help you make larger units of materials, linked together. The Masher requires a separate registration key, which you can only get if you buy a commercial licence for Hot Potatoes. Without the key, you can only make small units of exercises. The Masher is also used to upload files which are not Hot Potatoes exercises to the &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;http://www.hotpotatoes.net&apos;); return false;&quot;&gt;www.hotpotatoes.net&lt;/a&gt; server.

The Masher has its own tutorial (click on &lt;strong&gt;Help / Tutorial&lt;/strong&gt; in the Masher program, or &lt;a href=&quot;mashertutorial.htm&quot;&gt;go there now&lt;/a&gt;), and a detailed Help file with full instructions. To see the Help file, start the Masher program and press the &lt;strong&gt;F1&lt;/strong&gt; key.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>Example exercises</node-name><node-contents>Clicking on a link will make the exercise pop up in a new window (so that you don&apos;t lose your place in this tutorial). Once you have one exercise in your browser, you can move through them by clicking on the Next button at the top of the exercise. When you&apos;ve finished working through the exercises, close that browser window and you&apos;ll see this window again. Then you can go on to try making your first exercise.

&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jquiz1.htm&apos;); return false;&quot;&gt;JQuiz exercise&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jcloze1.htm&apos;); return false;&quot;&gt;JCloze exercise 1&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jcloze2.htm&apos;); return false;&quot;&gt;JCloze exercise 2&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jcross1.htm&apos;); return false;&quot;&gt;JCross exercise&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jmix1.htm&apos;); return false;&quot;&gt;JMix exercise 1&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jmix2.htm&apos;); return false;&quot;&gt;JMix exercise 2 (drag/drop)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jmatch1.htm&apos;); return false;&quot;&gt;JMatch exercise 1&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;&quot; style=&quot;cursor: pointer;&quot; onclick=&quot;window.open(&apos;jmatch2.htm&apos;); return false;&quot;&gt;JMatch exercise 2 (drag/drop)&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>13</target-id><qlink-text>The 2-minute challenge: Make your first exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>The 2-minute challenge: Make your first exercise</node-name><node-contents>Now that you&apos;ve seen all the exercises at work, it&apos;s time to try creating your own exercise. We&apos;re willing to bet that you can do it in two minutes flat, using &lt;strong&gt;JMix&lt;/strong&gt;. You might want to print this out first, so you can easily refer to it while working in JMix. Here&apos;s what you do:

Start the &lt;strong&gt;JMix&lt;/strong&gt; program, then
&lt;ol&gt;
   &lt;li&gt;Enter a &lt;strong&gt;title&lt;/strong&gt;.&lt;/li&gt;
   &lt;li&gt;Enter a &lt;strong&gt;sentence&lt;/strong&gt;. Break your sentence into segments, by putting each segment on a separate line.&lt;/li&gt;
   &lt;li&gt;Click on one of the two the Web buttons, or choose &quot;Create Web page&quot; from the File menu. There are two output formats to choose from, standard and drag/drop. For this exercise, it doesn&apos;t matter which one you choose.&lt;/li&gt;
   &lt;li&gt;Answer the question about &quot;This&quot; with &quot;no&quot;.&lt;/li&gt;
   &lt;li&gt;Choose a name for your Web page.&lt;/li&gt;
   &lt;li&gt;Answer &quot;Yes&quot; to view the exercise in your browser.&lt;/li&gt;
&lt;/ol&gt;
When you&apos;ve finished, come back here to continue the presentation! You might want to use the &lt;strong&gt;Bookmark&lt;/strong&gt; button above to create a bookmark in your browser, so that you don&apos;t have to search for this section again.

&lt;img src=&quot;jmix1.png&quot; alt=&quot;How to create an exercise in JMix&quot; width=&quot;550&quot; height=&quot;410&quot; title=&quot;How to create an exercise in JMix&quot;&gt;&lt;/img&gt;</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>14</target-id><qlink-text>Three steps in making an exercise</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>Three steps in making an exercise</node-name><node-contents>Although you probably found the 2-minute challenge very straightforward, you&apos;ll actually need to know more about how the programs work in order to take best advantage of them. This final section of the tutorial will take you step by step through the process of making an exercise using &lt;strong&gt;JQuiz&lt;/strong&gt;, in order to introduce some of the basic concepts you&apos;ll need to be familiar with.

There are three main steps in creating an exercise:

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Entering data&lt;/strong&gt; (questions, answers and so on)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Configuring the output&lt;/strong&gt; (preparing the button captions, instructions, and other features of your Web pages)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Creating Web pages&lt;/strong&gt; (compiling your exercise into HTML pages).&lt;/li&gt;
&lt;/ol&gt;</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>15</target-id><qlink-text>Step 1: Entering data</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>Step 1: Entering data</node-name><node-contents>In this part of the tutorial, we&apos;re going to make a multiple-choice exercise using &lt;strong&gt;JQuiz&lt;/strong&gt;. The first stage is to enter the questions and answers for your exercise. First, start the &lt;strong&gt;JQuiz&lt;/strong&gt; program. You should see an interface like the one below. If your interface looks more complicated than this, it&apos;s probably switched to &lt;strong&gt;advanced mode&lt;/strong&gt;; in that case, just click on &lt;strong&gt;Options / Mode / Beginner Mode&lt;/strong&gt;.

Look at the picture below, and type in the information:

&lt;ol&gt;
&lt;li&gt;Type the title in the title box.&lt;/li&gt;
&lt;li&gt;Type the question in the question box.&lt;/li&gt;
&lt;li&gt;Make sure that &quot;Multiple-choice&quot; is selected in the drop-down list box to the right of the question. This defines the type of question you want to make.&lt;/li&gt;
&lt;li&gt;Type the answers in the boxes on the left, and the feedback on the right. Note that each answer, right or wrong, has its own feedback.&lt;/li&gt;
&lt;li&gt;Check the &quot;Correct&quot; checkbox next to answer B.&lt;/li&gt;
&lt;/ol&gt;

&lt;img src=&quot;jquiz1.png&quot; alt=&quot;JQuiz main interface showing a multiple-choice question.&quot; width=&quot;760&quot; height=&quot;590&quot; title=&quot;JQuiz main interface showing a multiple-choice question.&quot;&gt;&lt;/img&gt;</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>16</target-id><qlink-text>Step 2: Configuring the output</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>Step 2: Configuring the output</node-name><node-contents>When a Hot Potatoes program creates Web pages, it does so by combining 3 resources:

&lt;ul&gt;
&lt;li&gt;The &lt;strong&gt;data&lt;/strong&gt; you entered&lt;/li&gt;
&lt;li&gt;The &lt;strong&gt;configuration&lt;/strong&gt; information&lt;/li&gt;
&lt;li&gt;A set of &quot;&lt;strong&gt;source files&lt;/strong&gt;&quot;, or templates, containing the page structure. &lt;/li&gt;
&lt;/ul&gt;

We have already looked at data; the next step is Configuration. The configuration information is a collection of pieces of text, including instructions for doing the exercise, button captions, and link URLs, which are unlikely to change much from one exercise to another. For example, some of the sample exercises you looked at earlier in this presentation included a button labelled &quot;Check&quot;, so that the student could check his or her answer. The caption &quot;Check&quot; is not likely to change from exercise to exercise, so it does not need to be stored with the data; however, you may need to change it (if you are creating quizzes in another language, for example).

When you looked at the example multiple-choice exercise, you might remember that the exercise had a title, a subtitle, and some instructions at the top of the page. The title of each exercise is likely to be unique, so that&apos;s part of the &lt;strong&gt;data&lt;/strong&gt;. However, the subtitle (e.g. &quot;Multiple-choice exercise&quot;) and the instructions (&quot;Choose the correct answer for each question&quot;) may be the same for most similar exercises, so these are part of the &lt;strong&gt;configuration&lt;/strong&gt;. In Step 2, we&apos;re going to change the configuration.

First, click on &lt;strong&gt;Options / Configure Output&lt;/strong&gt; to get to the configuration screen. The first tab, labelled &lt;strong&gt;Titles/Instructions&lt;/strong&gt;, holds the exercise subtitle and instructions. Type some text in, as in the example below, then press OK.

&lt;img src=&quot;jquiz_config.png&quot; alt=&quot;JQuiz configuration screen&quot; title=&quot;JQuiz configuration screen&quot; width=&quot;600&quot; height=&quot;366&quot;&gt;&lt;/img&gt;</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>17</target-id><qlink-text>Step 3: Creating a Web page</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>Step 3: Creating a Web page</node-name><node-contents>The final step is to create a Web page from your data. All you need to do is click on &lt;strong&gt;Create Web page / Web page for v6 browsers&lt;/strong&gt; from the File menu, then give your page a filename. Use the filename &quot;&lt;strong&gt;test.htm&lt;/strong&gt;&quot;:

&lt;img src=&quot;jquiz_output.png&quot; alt=&quot;Creating a Web page with JQuiz&quot; title=&quot;Creating a Web page with JQuiz&quot; width=&quot;402&quot; height=&quot;414&quot;&gt;&lt;/img&gt;

The program will tell you that it has produced a file, and let you view it in your Web browser. That&apos;s all there is to it!
</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink><qlink><target-id>5</target-id><qlink-text>The Potatoes, one by one</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode><qnode><node-name>The hotpotatoes.net server</node-name><node-contents>Whenever you create a Hot Potatoes exercise, you will see the following screen:

&lt;img src=&quot;hotpotnet1.png&quot; alt=&quot;Viewing or uploading an exercise.&quot; title=&quot;Viewing or uploading an exercise.&quot; width=&quot;455&quot; height=&quot;240&quot;&gt;&lt;/img&gt;

Generally, you will want to view the exercise in your browser to see if it works as you expect. However, the second option allows you to make use of the &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;http://www.hotpotatoes.net&apos;); return false;&quot;&gt;www.hotpotatoes.net&lt;/a&gt; hosting service. This is a Web server which can host your Hot Potatoes exercises, and allow you to password-protect them; your students can log on to the server and take the exercises, and you can check in later to find out their results. This service is not free, but it&apos;s fairly cheap, and you can test it out by creating a demo account and uploading a couple of exercises. To create a demo account, just click on &quot;&lt;strong&gt;Upload the file to the hotpotatoes.net Website&lt;/strong&gt;&quot;, then select the option &quot;&lt;strong&gt;Create a demo account for me on hotpotatoes.net&lt;/strong&gt;&quot;. 

For more information on the hotpotatoes.net service, see &lt;a style=&quot;cursor: pointer; text-decoration: underline;&quot; onclick=&quot;window.open(&apos;http://www.hotpotatoes.info&apos;); return false;&quot;&gt;www.hotpotatoes.info&lt;/a&gt;.</node-contents><entry><transactions></transactions></entry><exit><transactions></transactions></exit><qlinks><qlink><target-id>1</target-id><qlink-text>Index</qlink-text><hide-when-inaccessible>0</hide-when-inaccessible><transactions></transactions></qlink></qlinks></qnode></qnodes></quandary>

<quandary-config-file><welcome>Welcome to the Hot Potatoes tutorial. This tutorial runs in your Web browser. Click on the Start button to enter the tutorial.
</welcome><current-assets>You have: </current-assets><default-refusal-message>Sorry! You can&apos;t do that.</default-refusal-message><exercise-complete>You have reached the end of the exercise.</exercise-complete>
<start-caption>Start</start-caption>
<undo-caption>Go back</undo-caption>
<restart-caption>Restart</restart-caption>
<ok-caption>OK</ok-caption>
<link-caption>Go!</link-caption>
<bookmark-caption>Bookmark</bookmark-caption>
<bookmark-explanation>Your current position and settings have been encoded in 
the URL of the page. Now set a bookmark in your 
browser, so you can return here.
</bookmark-explanation>
<include-undo>1</include-undo>
<include-restart>1</include-restart>
<include-bookmark>1</include-bookmark>
<times-up>Your time has run out!</times-up><seconds>60</seconds><include-timer>0</include-timer>
<next-ex-caption>=&gt;</next-ex-caption>
<back-caption>&lt;=</back-caption>
<contents-caption>Index</contents-caption>
<include-next-ex>0</include-next-ex>
<include-contents>1</include-contents>
<include-back>0</include-back>
<contents-url>tutorial.htm?___q;0;</contents-url>
<next-ex-url>articles.htm</next-ex-url>
<graphic-url></graphic-url>
<font-face>Arial,sans-serif</font-face>
<page-bg-color>#d9d9d9</page-bg-color>
<title-color>#000000</title-color>
<ex-bg-color>#ffffff</ex-bg-color>
<text-color>#000000</text-color>
<link-color>#0060A4</link-color>
<vlink-color>#0000ff</vlink-color>
<nav-bar-color>#0060A4</nav-bar-color>
<remove-javascript-comments>0</remove-javascript-comments>
<user-string-1></user-string-1>
<user-string-2></user-string-2>
<user-string-3></user-string-3>
<header-code>&lt;style type=&quot;text/css&quot;&gt;
strong{background-color: #ffff00;color:inherited;}
&lt;/style&gt;</header-code></quandary-config-file></quandary-file>