%TITLE		Interactive Questions
%IMAGES		../images/
%HOME		http://www.med.ufl.edu/medinfo/mtx/
%PARENT		Table of Contents index.html
%INDEX		View MTX File quest.mtx
%PREV		tables.html
%NEXT		quizcgi.html
%AUTHOR		Richard Rathe / rrathe@dean.med.ufl.edu
%VERSION	MTX 2.0 User's Manual
%COPYRIGHT	1996-97 by Richard Rathe
%PATH		http://www.med.ufl.edu/medinfo/mtx/docs/
%CREATED	June 1, 1996
%MTX		2.0

#Introduction

Instructional Web pages are much more engaging when you present or reiterate
major teaching points in the form of questions. Questions force the student to
interact with the material and reinforce key concepts. MTX currently supports
two different question formats:

	{#Simple##SIMPLE#} - single correct answer only
	{#Multiple Answer##MULTI#} - more than one correct answer

Both of these formats can be used for formal {#on-line testing#quizcgi.html#}.

#Basic Question Format

The question mark (?) tag is used to begin each question. The tag is followed by
the question stem. Questions can include images and hypertext. Here is an example illustrating these elements:

=  ?¾=picture=„ This is the text of the question?

Questions will be automatically numbered 1, 2, 3, etc. for each document.

Each answer begins with an at sign (@) tag. Each choice is treated as a separate
paragraph. The letters A, B, C, etc. are added automatically. Optional feedback
is provided as a series of indented lines.

=  @Red
=     Feedback for Red
=  @Green
=     Feedback for Green
=  @Blue*
=     Feedback for Blue

There can be as few as 2 choices and as many as 26 (A-Z). Correct answer(s) are indicated by stars (*).

#Examples

##Simple Questions#=SIMPLE

This is an example of a simple question with progressive feedback.

?What color is the sky?
@Red
	The sky is sometimes red but more often another color.
@Green
	The sky is not green.
@Blue*
	The sky is blue.
	Use this question type when you want to deliver progressive feedback with
each wrong answer.

##Multiple Answer Questions#=MULTI

This is an example of a question with two right answers.

?Which of the following are even numbers?
@One
	The number 1 is odd.
@Two*
	The number 2 is even.
@Three
	The number 3 is odd.
@Four*
	The number 4 is even.
@Five
	The number 5 is odd.

##Questions with Images

You can use {#pictures#images.html#} or {#hypertext links#hyper.html#} in any
part of a question. Providing feedback with counter example images is one useful
technique.

?{=picture=} This is a picture of:
@The Moon
	The moon looks like this:
	{=moon=}
@A Flower*
	This is a picture of a water lily.
@Some Trees
	Trees look like this:
	{=trees=}

#Files and File Names

The questions on this page produce twelve extra HTML files, one for each
feedback element. The names for these files are assigned automatically when the
MTX file is processed. For greatest {#compatibility#compat.html#}, you should
limit the length of these file names to eight characters as follows:

	The main page file name
	The question number (1, 2, 3...)
	The answer letter (A, B, C...)

For example, the feedback file for the first answer to question 3 is
{#quest3A.html##}.

Note that these file names are arbitrary and will change as you add, move, or
eliminate questions from the original MTX file. Be sure to update any hypertext
links you make to these files when you edit them.