<< Chapter < Page Chapter >> Page >

It also has an optional id attribute. If you are using more than one resource for a particular item and need to keep trackof which resource is which, you will want to include an id tag.

The resource tag is an empty tag, which means you must include a slash at the end of the tag.

Example

<resource uri="http://cnx.rice.edu/datasets/dataset1.csv" id="resource1" />

Answer, response, and feedback

How you construct the answer tag, including whether you include an answer tag at all, depends on your item-type. However, in allcases where you have an answer tag, the ID of the answer tag must not contain any commas, as the key tag refers to the answerIDs separated by commas.

Single-response, multiple-response, and ordered-response

To write answer tags for single-response, multiple-response, and ordered-response items:

You will want one answer tag for each response option. Each answer tag has an id, which is referenced by the key tag,below. Preferably, the id tags should have an obvious relation to the response option. For example, if yourresponse options are "London, England;" "Washington, DC;" and "Paris, France" your id attributes could be london,washington, and paris.

Each of your answer tags should contain a response tag and may contain a feedback tag if you wish to provide feedbackspecific to that response (general feedback goes in another tag). The response tag contains the response option, in textor markup, and has no attributes. Be aware that the stylesheets for the Connexions project currently only allowplain text and CNXML (with or without MathML) within response tags. If you use CNXML (with or without MathML) within a QMLtag, the first tag must be a section tag, which may contain any of the tags a CNXML section tag is allowed to contain.

The feedback tag contains feedback to be displayed to the user upon selection of that response option. The feedback may betext or markup. The feedback tag does not have attributes for single-response, multiple-response, or ordered-response items.

Example for a single-response question

<item id="item1" type="single-response"><question>Are bananas a fruit or a vegetable?</question><resource uri="http://bananas.com/banana_dataset1.csv" /><answer id="fruit"><response>A fruit.</response><feedback>Correct!</feedback></answer><answer id="vegetable"><response>A vegetable.</response><feedback>Incorrect.</feedback></answer><hint>Bananas grow on trees.</hint><feedback>Bananas are a fruit.</feedback><key answer="fruit" /></item>

Text-response items

To write answer tags for text-response items: Because text-response items do not have response options, you willhave either have no answer tag (if you are not providing response feedback) or only one answer tag which may containtwo response-specific feedback tags: one for a correct response, one for an incorrect response.

The feedback tag containing the correct feedback should have the attribute correct="yes", and the other should have theattribute correct="no". You may also include a general feedback tag; this is recommended as Connexions does not haveplans to provide response processing for text-response items and at the present time only shows the general feedback forthe user to compare his/her answer with. The content of the feedback tags may be text or markup; be aware that thestylesheets for the Connexions project currently only allow plain text and CNXML (with or without MathML) within questiontags. If you use CNXML (with or without MathML) within a QML tag, the first tag must be a section tag, which may contain any of the tags a CNXML section tag is allowed to contain.

Get Jobilize Job Search Mobile App in your pocket Now!

Get it on Google Play Download on the App Store Now




Source:  OpenStax, Cnxml tutorial. OpenStax CNX. Jul 08, 2009 Download for free at http://cnx.org/content/col10121/1.10
Google Play and the Google Play logo are trademarks of Google Inc.

Notification Switch

Would you like to follow the 'Cnxml tutorial' conversation and receive update notifications?

Ask