?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
This is an example of a simple question.
Question 1
What color is the sky?
C) Blue
Progressive Questions
This is an example of a progressive question. Add a second question mark (?) tag to add progressive disclosure to a question:
?c?
Question 2
What color is the sky?
C) Blue
Multiple Answer Questions
This is an example of a question with two right answers.
?bd
Question 3
Which of the following are even numbers?
E) Five
Questions with Images
You can use pictures or hypertext links in any part of a question. Providing feedback with counter example images is one useful technique.
Question 4
This is a picture of:
C) Some 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:
Question 5
What color is the sky?
A) Red
B) Green
C) Blue
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 to be turned on.
%LAYOUT nofeedback
Suppresses all feedback 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" 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, the length of these file names is limited to eight characters as follows:
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.