--- modules/damieng/clean_xml/loncapa.xsd 2015/05/06 19:41:54 1.9 +++ modules/damieng/clean_xml/loncapa.xsd 2015/05/13 19:08:29 1.12 @@ -718,7 +718,7 @@ - Print options + Set to "nochoice" to avoid the display of the list of option values when printing. @@ -754,6 +754,36 @@ + + + + Set to "nochoice" to omit "Select all that are ... ". + + + + + + + + + + + + + + + + Minimum boxes required to check. + + + + + + + Maximum boxes permitted to check. + + + @@ -2126,6 +2156,17 @@ + + + Comma-separated list of options: + + - autoez: Auto E,Z stereochemistry + - multipart: Multipart Structures + - nostereo: No stereochemistry + - reaction: Is a reaction + - number: Able to number atoms + + @@ -2139,14 +2180,16 @@ - Starting Molecule + Starting Molecule. + Syntax: JME. - Correct Answer + Correct Answer. + Syntax: SMILES (Simplified Molecular Input Line Entry System). @@ -2504,7 +2547,12 @@ - The first part of the hint is the condition, which includes a specification of the foil(s) and foil answer(s) required to trigger the hint. The answers specified in the hint condition are compared with the user's submission, and if the condition is met, the hint action included in the conditional hint block will be executed (for example this could be the display of a block of text). You can set multiple hint conditions for a particular problem. Hint conditions are identified by a name. The corresponding hint action includes this hint condition name in the "on" parameter. When a hint condition evaluates to true, the corresponding hint action is triggered. Besides providing hint actions within <hintpart on="NAME"> </hintpart> tags for each named (NAME) hint condition, a hint can be designated for display if none of the conditional hints evaluate to true. The default hint is not displayed if the conditions were met for any of the conditional hints. The default hint action is included between <hintpart on="default"> </hintpart> tags. + This element can either contain a simple hint displayed when the submitted answer for the part is not correct, or a more complex structure to display different hints for different submitted answers. + + To display different hints based on the submitted answer, the hint group has to contain hint conditions (<*hint> elements) and conditional hints (<hintpart> elements). + A hint condition defines the foil(s) and foil answer(s) required to trigger a hint, and has a name attribute to identify it. + A conditional hint (<hintpart>) defines what will be displayed if a particular hint condition is met. It includes a reference to the hint condition in the "on" attribute. + A default conditional hint can be defined by using on="default" in a <hintpart>. The contents of this hint will be displayed if none of the other conditional hints is triggered. @@ -2535,7 +2583,7 @@ Conditional Hint - When a hint element named the same as the on attribute evaluates to be correct, the hintpart will show. + When a hint condition named the same as the on attribute evaluates to be correct, the contents of this element will be displayed. If no other hintpart is to show then all hintparts with an on value set to “default” will show. @@ -2603,11 +2651,11 @@ Radiobutton Hint Condition - The radiobutton hint element takes two parameters: answer and name. The name is the name of the hint condition, and the answer is an array. The first element of the array will be 'foil'; the remaining elements are the names of the foils that you require to have been checked by the student for the hint to be displayed. For example, if you create a radiobutton response problem with six foils named: granite, gabbro, gneiss, shale, sandstone and schist, and you want your hint named: igneous to be displayed when either granite or basalt had been checked your radiobutton hint would be as follows: + The radiobutton hint element takes two attributes: answer and name. The name is the name of the hint condition, and the answer is an array. The first element of the array will be 'foil'; the remaining elements are the names of the foils that you require to have been checked by the student for the hint to be displayed. For example, if you create a radiobutton response problem with six foils named: granite, gabbro, gneiss, shale, sandstone and schist, and you want your hint named: igneous to be displayed when either granite or basalt had been checked your radiobutton hint would be as follows: <radiobuttonhint answer="('foil','granite','gabbro')" name="igneous"></radiobuttonhint> - In order to trigger display of this hint you also need to create a <hintpart> </hintpart> block that will include a textblock that contains the text of the actual hint. + In order to trigger display of this hint you also need to create a hint condition (<hintpart>) that will include the text of the actual hint. @@ -2622,12 +2670,17 @@ - + should be at least a two element list: first the type (foil or concept) and then either the foil name(s) or the concept string(s), e.g., “(’foil’,’greaterthan’,’equal’)” if the condition should be triggered by the foils named “greaterthan” or “equal” + + + + + @@ -2636,7 +2689,10 @@ Option Response Hint Condition - There are two types of option response hint conditions: one for standalone foils and one for concept groups. In both cases the option hint element includes two parameters: answer and name for standalone foils, and concept and name for foils grouped together in a concept group. For the answer parameter, the names and submitted values for each of the foils that are being included in the hint condition are provided in a hash, i.e., in the format: ('Foil1'= > 'True','Foil2'= > 'False'). In the case of a conditional hint for a concept group, the format of the concept parameter is also a hash that links the name of each concept group included in the hint condition to either 'correct' or 'incorrect' - e.g., < optionhint concept="('buoyancy'= > 'correct','density'= > 'correct')" name="fluids" / > If 'correct' is specified for a named concept then when the conditional hint is evaluated answers for each of the foils selected by a student must be correct for the hint action to be triggered. If anything other than 'correct' is provided in the concept hash in the optionhint element then then students answers will be compared with the set answers for the foils in the concept group and as long as at least one answer is incorrect (i.e., the concept group was not correctly answered) then the corresponding hint action will be triggered. + There are two types of option response hint conditions: one for standalone foils and one for concept groups. In both cases the option hint element includes two parameters: answer and name for standalone foils, and concept and name for foils grouped together in a concept group. + For the answer parameter, the names and submitted values for each of the foils that are being included in the hint condition are provided in a hash, i.e., in the format: ('Foil1'=> 'True','Foil2'=> 'False'). + In the case of a conditional hint for a concept group, the format of the concept parameter is also a hash that links the name of each concept group included in the hint condition to either 'correct' or 'incorrect' - e.g., <optionhint concept="('buoyancy'=> 'correct','density'=> 'correct')" name="fluids" />. + If 'correct' is specified for a named concept then when the conditional hint is evaluated answers for each of the foils selected by a student must be correct for the hint action to be triggered. If anything other than 'correct' is provided in the concept hash in the optionhint element then then students answers will be compared with the set answers for the foils in the concept group and as long as at least one answer is incorrect (i.e., the concept group was not correctly answered) then the corresponding hint action will be triggered. @@ -2651,8 +2707,32 @@ - - + + + + Perl hash with foil names as keys and submitted values as values. + Example: ('foil1'=> 'true', 'foil2'=> 'false') + + + + + + + + + + + + Perl hash with concept names as keys and either 'correct' or 'incorrect' as values. + Example: ('buoyancy'=>'correct', 'density'=> 'correct') + + + + + + + + @@ -2806,7 +2886,7 @@ Custom Hint Condition - Define the hint condition within an answer block inside of the customhint block. The condition is defined like how an answer is defined in customresponse where you need to return EXACT ANS to indicate when customhint criteria are met. + Define the hint condition within an answer element inside the customhint element. The condition is defined in the same way an answer is defined in customresponse, where you need to return EXACT_ANS to indicate when the customhint criteria are met.