134
p33
© Half-Baked Software, Inc., 1998-2004
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
s
r
c
="mygraphi
c
.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 Potato
es
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-
Can
I
in
se
rt
s
ound and vid
e
o?
Adding sound or video to
Hot Potato
es
pages is basically just like linking to any other file. See Adding links
for general information on how to link in external files, then read Adding sound and video and Inserting an
object for more detail on this topic.
-o-
Do
I
n
ee
d to run th
e
front
e
nd program all th
e
tim
e
?
There's no need to run the main "Hot Potato
es
" screen (the one with the picture of all the different
potatoes) if you don't want to. This interface is provided simply to give you easy access to all the different
programs and the help and tutorial information without adding lots of icons to your Start menu.
All of the
Hot Potato
es
programs (in the Windows version) are standalone applications, and you can run
them individually by double-clicking any of the icons in the
Hot Potato
es
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-
Why ar
e
th
e
Window
s
and Ma
c
v
e
r
s
ion
s
diff
e
r
e
nt?
The Window
s
programs were written using Borland D
e
lphi 2, and were ported to D
e
lphi 5 for version 4.1
through 6. The
Ma
c
suite up to version 5.3 was written with
Sup
e
r
c
ard 3.6
, and version 6 and above are
written in Java using Borland JBuild
e
r. All of these development environments have their own strengths
and weaknesses, as do the two operating systems. In developing parallel suites, we were faced with a
choice between limiting ourselves to the subset of controls and functions available in both environments,
and hence producing similar interfaces with limited functionality, or taking advantage of the full range of
options each environment offers. We chose the latter course. This means that moving from one version of
the suite to the other will probably be a little confusing for most users, but we feel that it does allow us to
create better applications for each environment. Since most users work primarily with one operating
system, and only a minority are likely to want to use both versions of the suite, we doubt that many people
will be inconvenienced by this.
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-
How do
es
th
e
sc
oring work in JQuiz?
Many users have asked how the percentage score is calculated in JQuiz, and whether it is possible to
change this system. Here is a brief explanation:
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
C# Imaging - Scan Barcode Image in C#.NET C# Barcode Image Reader - Barcode Types. You can get free sample C# codes for barcodes scanning in .NET Recognize PDF-417 2D barcode in .NET WinForms & ASP.NET
fill in pdf form reader; how to make a pdf form fillable in reader
84
p34
© Half-Baked Software, Inc., 1998-2004
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-
How do
es
th
e
sc
oring work in JCloz
e
?
JCloz
e
scoring works like this:
1. Each gap is of equal value in the total score.
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-
How do
es
th
e
sc
oring work in th
e
oth
e
r appli
c
ation
s
?
As the programs have evolved, we have created rather more sophisticated scoring systems for each of the
applications. The basic principles in all cases are these:
1. You lose points for asking for a hint or a clue.
2. You lose points if you check your answers and some of them are wrong.
3. Your final score includes all penalties previously incurred. Here's an example from JMatch:
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-
Can
I
g
e
t my
s
tud
e
nt
s
' r
es
ult
s
by
e
-mail?
We've had many queries about sending the results from a Hot Potato page to the instructor by email. In
response, we have built in a basic submission functionality. You can configure this using the CGI panel of
the configuration screen. Please note that we do not provide support for this feature; you and your system
administrator will have to set up a CGI script on your server in order to make this work. Click on the
I
nformation button in the configuration screen for more on this.
173
p35
© Half-Baked Software, Inc., 1998-2004
For proper tracking of student access and scores, you should set up an account with hotpotatoes.net.
-o-
Support and credits
T
ec
hni
c
al
s
upport
Hot Potato
es
version 6.3 is free for anyone to use, but we do NOT provide any technical support at all. If
you need help, the best thing to do is to post questions 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://t
ec
h.group
s
.yahoo.
c
om/group/hotpotato
es
u
se
r
s
/
Please do not send us email. We will simply ignore it. We are busy working on the next version of Hot
Potato
es
.
-o-
I
nt
e
rn
e
t h
e
lp
W
e
no long
e
r provid
e
t
ec
hni
c
al
s
upport for Hot Potato
es
v
e
r
s
ion 6.
On the Hot Potato
es
Web site, there is a page of Fr
e
qu
e
ntly A
s
k
e
d Qu
es
tion
s
along with old bug
reports and update information. In addition, there is a
bull
e
tin board
where you can post questions and
get help from other users.
-o-
About th
e
author
s
Half-Bak
e
d Softwar
e
is the nom-de-plume of the Research and Development team at the University of
Victoria Humanities Computing and Media Centre. The parties guilty of
Hot Potato
es
are:
St
e
wart Arn
e
il
(HTML, JavaScript and Macintosh programming)
Martin Holm
es
(HTML, JavaScript and Windows programming) (http://www.mholm
es
.
c
om)
Hilary Str
ee
t
(Graphics. Hilary has his own company, Interdesign Media.)
The HCMC home page is at:
http://w
e
b.uvi
c
.
c
a/h
c
m
c
/
Half-Bak
e
d Softwar
e
I
n
c
. is now a legal corporation, which handles the commercial aspects of Hot
Potato
es
. The
Half-Bak
e
d Softwar
e
home page is at:
http://www.halfbak
e
d
s
oftwar
e
.
c
om
This version of
Hot Potato
es
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-Bak
e
d Softwar
e
and the University of Victoria
Humanities Computing and Media Centre, 1997-2009.
-o-
A
c
knowl
e
dg
e
m
e
nt
s
C# Word - Word Conversion in C#.NET Various image forms can be converted from Word document, including Jpeg control enable users to convert PDF to Word ODT file also can be converted to Word with
filling out pdf forms with reader; how to type into a pdf form in reader
260
p36
© Half-Baked Software, Inc., 1998-2004
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 of Hot Potatoes.
The following people have helped with beta-testing and translation of this version:
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)
L
i
d
ija
Kr
alj
(Cro
a
t
ia
n conf
i
gur
a
t
i
on f
ile
)
Dzm
i
try Sok
al
(Ru
ssia
n tr
a
n
sla
t
i
on)
M
a
r
i
n
a
A
al
to (Ru
ssia
n conf
i
gur
a
t
i
on f
ile
)
Du
sa
n K
le
m
e
nc
i
c (S
l
ov
e
n
ia
n tr
a
n
sla
t
i
on)
And
e
r
s
B
e
rggr
e
n (Sw
e
d
is
h tr
a
n
sla
t
i
on)
Paolo Cutini (Italian resources and translations)
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)
L
a
r
s
Acou (Dutch tr
a
n
sla
t
i
on)
D
a
n
iel
S
e
d
l
b
a
u
e
r (Fr
e
nch tr
a
n
sla
t
i
on)
Gu
i
d
a
Qu
e
r
i
do
(Portuguese translation)
Richard Nisius (German translation)
Henny Jellema
St
e
f
a
n Eb
e
rh
a
rd
F
e
rn
a
nd
a
Rodr
i
gu
es
M
a
r
ia
Kyung Ov
e
rg
aa
rd (h
el
p
e
d on t
es
t
i
ng Ar
a
b
i
c)
R
a
ndy L
a
w
s
J
ørg
e
n Br
e
nt
i
ng
G
le
ny
s
H
a
n
s
on
Chr
is
B
e
y
Je
n
s
Ø
s
t
e
rg
aa
rd P
e
t
e
r
se
n
These people have helped with previous versions:
Pål Eggen (Norwegian translation)
Richard Zaiser
Yunus Aliaz (Turkish translation)
Ferenc Tavasz (Hungarian Translation)
Andrey V. Kozlov, Volha L. Zholudz, Olga Leonidovna (Russian translation)
Sagra Crespo (Basque configuration file)
Ernest Prats Garcia (Catalan translation and configuration file)
Marc Dubois (French translation and configuration file)
John Tait (German translation)
Heinz-Willi Jansen (German translation)
Raffaele Nardella (Italian translation)
Antonio Portaluri (Italian translation)
Alfredo Colluci (Italian translation)
Alberto J. Villena (European Spanish translation)
64
p37
© Half-Baked Software, Inc., 1998-2004
Carlos Pravisani (Latin American Spanish translation)
Louis Simard (French translation)
Niek van Os (Dutch translation)
Wim Daemen (Dutch translation)
Hanne Leervad
Erin Tancock
Henk Verdru
Giulio Picciolini
Claudio Collabianchi
Ismail Ali Gago
Fabien Olivry (2nd French translation)
Rüdiger Klampfl
Heikki Honkola
Peter Wolfgang
Adalberto Nascimento
Mohamed Salam
Francois Cloete
Edgar Pereira dos Santos
Aitor Esteban
Claus Zedlitz
Guy Migneron
Roberto Yunes
Enrico Tafelli
Fabio Girelli-Carasi
Herman Vermulen
Marten Douma
Martin van der Knijff
Susan Pojer
Bruno Trinkenreich
Karmin Fansuri
Mike Gordon
Al Noor
Malini Sivasubramaniam
Scott Gerrity
Greg Newton
Leah Stella
Lucy Bell
James Chisholm
Steve Slavik
Alfredo Colucci
John Taylor-Johnston
Peter Gölz
Judson Tunnell
Kat Tancock
Ilpo Halonen
Elek Mathe
Lilliam Hurst
Nik Holmes
Duncan Mason
Mary Sanseverino
Jan Brown
Ruth Vilmi
Joe Greenman
Musnarti Dickinson
Geraint Jennings
Hot Potatoes uses freeware code from TSM Inc. (http://www.crypto-central.com/index.html).
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.
95
p38
© Half-Baked Software, Inc., 1998-2004
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 few years.
-o-
Th
e
futur
e
of Hot Potato
es
We have released version 6.3 of Hot Potatoes as freeware, without technical support, in order to free up
some of our own time to work on the next version, without being distracted by the need to provide support
and help to users, or process licence sales. We hope that this strategy, although it means that we have no
income, willl allow us to make more progress with Hot Potatoes 7 than would otherwise have been possible.
-o-
For power-users
Cu
s
tom
c
onfiguration (u
se
r
s
tring
s
)
The Cu
s
tom 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:
[
s
trU
se
rD
e
fin
e
d1]
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, [
s
trU
se
rD
e
fin
e
d1] 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 <h
e
ad> 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).
-o-
W3C
s
tandard
s
s
upport
Like most Web and software developers, we believe very strongly that the future of distributed software
and e-learning will be most effectively secured by rigorous support for non-partisan cross-platform
standards such as those promulgated by the
W3C
(
http://www.w3
c
.org
). We have always tried to make
Hot Potato
es
as standards-compliant as possible, consistent with the practicalities of making sophisticated
interactive pages work across a range of browsers. This latest release of Hot Potato
es
takes our
standards-compliance one stage further:
All version 6 output is now XHTML 1.1 compliant. This means that they are also valid XML files, and you
can also include metadata in Dublin Core format. We have included the appropriate XHTML document type
declaration at the top of the pages.
In addition, Hot Potato
es
data files are standard XML files that can be used in any other application
79
p39
© Half-Baked Software, Inc., 1998-2004
capable of parsing XML.
-o-
Dublin Cor
e
M
e
tadata
Metadata is descriptive information about your exercise. Including this information in your data files and V6
output files enables other people (and computers) to find and use your exercise more easily. In order for
this to happen, of course, the data has to be in a format which can be read and understood. The most
commonly-used standard for metadata is the Dublin Core metadata standard (http://www.dublin
c
or
e
.org
).
If you click on Fil
e
/ Add M
e
tadata (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-
SCORM 1.2
s
upport
SCORM is a collection of standards brought together by Advanced Distributed Learning to enable the use
of learning objects across a variety of learning management systems. Beginning with version 6.2, Hot
Potatoes is able to provide support for SCORM 1.2 by creating a SCORM redistributable package which
can be imported into a learning management system which supports SCORM 1.2. The package is in the
form of a zip file containing the exercise Web page, any associated media files, and some metadata and
schema files. You can create a SCORM package by choosing Cr
e
at
e
SCORM 1.2 Pa
c
kag
e
from the File
Menu. Be patient: creating a SCORM package may take a long time.
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
and punctuation in filenames are OK on a Windows or Macintosh computer, but they aren't allowed on the
WWW, so when you put your exercise on the Web you'll most likely encounter difficulties.
If you like to create your own SCORM packages, you can take another approach. In the Configuration
screen, on the Oth
e
r 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.adln
e
t.gov/
sc
orm/
-o-
Documents you may be interested
Documents you may be interested
