%TITLE Interactive Questions
%IMAGES ../images/
%HOMEURL http://www.med.ufl.edu/medinfo/
%PARENT Table of Contents
%PARENTURL index.html
%INDEX View MTX File
%INDEXURL quest.mtx
%PREVURL tables.html
%NEXTURL slides.html
%AUTHOR Richard Rathe / rrathe@dean.med.ufl.edu
%AUTHURL rrathe@dean.med.ufl.edu
%VERSION MTX 1.4 User's Manual / Copyright 1996 by the University of Florida
%PATH http://www.med.ufl.edu/medinfo/mtx/docs14/
%MTX 1.4

#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
three different question formats:

	{#Simple##SIMPLE#} - feedback is given all at once with any right or
wrong answer
	{#Progressive##PROG#} - feedback is progressively disclosed with wrong
answers
	{#Multiple Answer##MULTI#} - more than one correct answer is available

#Basic Question Format

The question mark (?) tag is used to begin each question. The tag is followed by
letters indicating the correct answer (the letter "c" indicates the third choice,
etc.). The text of the question follows on a subsequent line. Questions can
include images. Here is an example of these elements:

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

Questions will be automatically numbered from 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).

#Examples

##Simple Questions#=SIMPLE

This is an example of a simple question.

?c
What color is the sky?

@Red
	Use this question type when you want to deliver feedback all at once. 
@Green
	The sky is not green.
@Blue
	The sky is blue.

##Progressive Questions#=PROG

This is an example of a progressive question. Add a second question mark (?) tag
to add progressive disclosure to a question:

=  ?c?

?c?
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.

%%###Progressive Questions with Custom Prompts
%%
%%This is an example of a progressive question with a custom prompt. Text for the
%%prompt follows the second question mark (?):
%%
%%=  ?c?Get Real!!
%%
%%?c?Get Real!!
%%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.

=  ?bd

?bd
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.

?b?
{=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=}

#Suppressing Feedback

It is sometimes desireable withhold feedback for individual questions or an
entire page. For example, you might want to selectively hide the feedback from
certain questions as part of a formal evaluation. Students would be required to
turn in their answers on a paper grading form. Once the forms had been collected
you could release the feedback for review.

Add the "none" switch to suppress feedback for an individual question:

=  ?c?none

Here is one of the questions shown above with the feedback turned off:

?c?none
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.

Notice that the identity of the correct answer and the feedback text has not been
removed from the original MTX file. All you have to do to bring it back is remove
the "none" switch. Feedback is also affected by certain layout switches:

=  %LAYOUT feedback

Overrides "none" switches for questions on the page and forces all
{#feedback#quest.html#} to be turned on.

=  %LAYOUT nofeedback

Suppresses all {#feedback#quest.html#} for the page. Has the same effect as
adding the "none" switch to every question.

=  %LAYOUT print

Suppresses question feedback, navigation links, counter, and the table of
contents for the page. This is useful when you want to "{#pretty
print#otherpp.html#}" the page on paper.

#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#}, the length of
these file names is limited to eight characters as follows:

	The first four characters of the main page file name
	The letter "Q"
	The question number (1, 2, 3...)
	The answer letter (A, B, C...)
	The ".html" extension

For example, the feedback file for the first answer to question 2 is:

=  quesQ2A.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.