--- modules/damieng/clean_xml/loncapa.xsd 2015/04/17 15:35:01 1.1 +++ modules/damieng/clean_xml/loncapa.xsd 2015/04/30 20:43:16 1.6 @@ -158,7 +158,7 @@ Root for .library documents. A LON-CAPA .library file can contain just a script block, or just response items, or both. - Library content is loaded into a problem statement by using an <import> tag. + Library content is loaded into a problem statement by using an <import> element. @@ -430,7 +430,7 @@ Query for a string. - An internal textline tag is necessary for the student’s response to go in. It can check the string for either case or order. + An internal textline element is necessary for the student’s response to go in. It can check the string for either case or order. @@ -734,14 +734,14 @@ - Two-option checkboxes for + When there are only 2 option values, set this attribute to one of them in order to display checkboxes. A foil checkbox will have to be checked when the foil has the chosen option value. - Checkbox options + Set to "nochoice" to avoid the display of the list of option values. @@ -791,7 +791,11 @@ - Draw Option List + + Draw Option List + + By default, the list of options is presented in front of the foils. Using the optional <drawoptionlist> element, the list of options can be embedded into a foil. + @@ -804,6 +808,7 @@ Query for matches betweens items from two lists. + It is also possible to query for matches with optionresponse, but optionresponse only accepts simple text for the matches. With matchresponse, it is possible to use anything as a match, such as equations, images, plots, or long styled texts. @@ -1230,7 +1235,10 @@ - Collection of Answers + + Collection of Answers. + This element can be used instead of the answer attribute on the response element when several answers are correct, or when the correct answer has several components. + @@ -1251,12 +1259,24 @@ - Correct list of values or vectors. + A correct list of values or vectors. - - + + + + A vector, part of a correct answer. + + + + + + + A value, part of a correct answer. + + + @@ -1291,7 +1311,12 @@ - Query for a formula. + + Formula Response asks the student to type in a formula as an answer. + + If the answer is 2x² + 4, the student is allowed to type “2*x*x+4”, “x*x + x*x + 4”, “2*xˆ2 + 14 - 10”, or any other equivalent expression. + Formula Response problems have many of the same characteristics of Numerical Response problems, including the ability to run scripts, dynamically generate answers, etc. + @@ -1304,7 +1329,13 @@ - + + + + The correct answer. It can use variables calculated/defined in the problem’s Perl script block, allowing the answer to be determined dynamically. + + + @@ -1337,7 +1368,8 @@ - Query for text that is evaluated with a script written in a computer algebra system language by the problem author. + Query for text that is evaluated with a script written in a Computer Algebra System (CAS) language. + The CAS script must be included in the response with an <answer> element. MathResponse is extremely powerful, as it tests answers for conditions rather than agreement with a particular correct answer. An unfortunate byproduct, however, is that it cannot be analyzed by several of the LON-CAPA statistics tools. @@ -1348,7 +1380,8 @@ - Maxima or R script using the arrays RESPONSE and LONCAPALIST. + Maxima or R script using the arrays RESPONSE (the student response) and LONCAPALIST (from the args attribute). + Returns a boolean in the last statement that will be true if the answer is correct. @@ -1364,7 +1397,10 @@ - String to display for answer + This attribute contains what is displayed when the problem is in "Show Answer" mode. + You will want to use it so that the students can see the correct answer after the "Show Answer Date" configured when the problem is assigned in the course space. + + This is usually the name of a Perl string variable (starting with '$') created in a Perl script before the response. @@ -1388,7 +1424,8 @@ - Argument Array + Perl array that will be passed to the CAS script as the LONCAPALIST variable. + This is usually the name of a Perl array variable (starting with '@') created in a Perl script before the response. @@ -1396,9 +1433,6 @@ - - Answer algorithm - @@ -2279,7 +2313,7 @@ Query for text or numbers. - Advanced type of response that implements a simple data storage and needs an input tag, such as textline, to work correctly. + Advanced type of response that implements a simple data storage and needs an input element, such as textline, to work correctly. @@ -2489,7 +2523,7 @@ Conditional Hint - When a hint tag named the same as the on attribute evaluates to be correct, the hintpart will show. + When a hint element named the same as the on attribute evaluates to be correct, the hintpart will show. If no other hintpart is to show then all hintparts with an on value set to “default” will show. @@ -2557,7 +2591,7 @@ Radiobutton Hint Condition - The radiobutton hint tag 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 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: <radiobuttonhint answer="('foil','granite','gabbro')" name="igneous"></radiobuttonhint> @@ -2590,7 +2624,7 @@ 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 tag 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 tag 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. @@ -2953,7 +2987,7 @@ - The gnuplot LON-CAPA tag allows an author to design a plot which will be created programatically at the time when it is requested for display by a student. This is intended for use in homework problems where a distinct plot should be rendered for each student. It can be used in conjunction with a script to generate curve data for random plots. + The gnuplot LON-CAPA element allows an author to design a plot which will be created programatically at the time when it is requested for display by a student. This is intended for use in homework problems where a distinct plot should be rendered for each student. It can be used in conjunction with a script to generate curve data for random plots. @@ -2964,7 +2998,7 @@ Brief description of the plot. - This text is used as the alt value of the img tag used to display the plot on a web page. + This text is used as the alt value of the img element used to display the plot on a web page. @@ -3339,29 +3373,29 @@ - The Plot Axes tag allows you to specify the domain and range of the data to display. It is closely tied with the Plot Ticks tags, which specify where the gridlines are drawn on the plot. + The Plot Axes element allows you to specify the domain and range of the data to display. It is closely tied with the Plot Ticks elements, which specify where the gridlines are drawn on the plot. - The curve tag is where you set the data to be plotted by gnuplot. + The curve element is where you set the data to be plotted by gnuplot. - The key tag causes a key to be drawn on the plot when it is generated. The key will contain an entry for each curve which has a name. - The key is the color of the foreground of the plot, specified in the gnuplot tag. + The key element causes a key to be drawn on the plot when it is generated. The key will contain an entry for each curve which has a name. + The key is the color of the foreground of the plot, specified in the gnuplot element. - The label tag allows the author to place text at any position on the plot. There may be many label tags on one plot and all the labels which fall within the plot will show. The color used will be to foreground color of the plot and the font will be the size specified for the plot, both of which are set in the gnuplot tag. + The label element allows the author to place text at any position on the plot. There may be many label elements on one plot and all the labels which fall within the plot will show. The color used will be to foreground color of the plot and the font will be the size specified for the plot, both of which are set in the gnuplot element. @@ -3727,7 +3761,7 @@ Causes a key to be drawn on the plot when it is generated. The key will contain an entry for each curve which has a name. - The key is the color of the foreground of the plot, specified in the gnuplot tag. + The key is the color of the foreground of the plot, specified in the gnuplot element. @@ -3818,7 +3852,7 @@ - The <tic> tag allows users to specify exact Tic positions and labels for each axis. + The <tic> element allows users to specify exact Tic positions and labels for each axis. In this version we only support level 0 tics (major tic). Each tic has associated with it a position and a label $current_tics is a reference to the current tick description hash. We add elements to an array in that has: ticspecs whose elements are 'pos' - the tick position and 'label' - the tic label. @@ -3886,7 +3920,7 @@ - For output devices that support it, this rotates the tic label by 90 degrees. This is most useful with large lables defined by the tic tag described below. + For output devices that support it, this rotates the tic label by 90 degrees. This is most useful with large lables defined by the tic element described below. @@ -3924,7 +3958,7 @@ Conditional Block - This has a required argument condition that is evaluated. If the condition is true, everything inside the tag is evaluated; otherwise, everything inside the block tag is skipped. + This has a required argument condition that is evaluated. If the condition is true, everything inside the element is evaluated; otherwise, everything inside the block element is skipped. When found inside the gnuplot element, a block can only have gnuplot children inside, with no text. @@ -4232,7 +4266,7 @@ Parameter for a part - parameter is exactly the same as responseparam, but should appear outside of a response tag. + parameter is exactly the same as responseparam, but should appear outside of a response element. @@ -4407,7 +4441,7 @@ Import a File - This causes the parse to read in the file named in the body of the tag and parse it as if the entire text of the file had existed at the location of the tag. + This causes the parse to read in the file named in the body of the element and parse it as if the entire text of the file had existed at the location of the element. @@ -4440,7 +4474,7 @@ Conditional Block - This has a required argument condition that is evaluated. If the condition is true, everything inside the tag is evaluated; otherwise, everything inside the block tag is skipped. + This has a required argument condition that is evaluated. If the condition is true, everything inside the element is evaluated; otherwise, everything inside the block element is skipped. @@ -4497,7 +4531,7 @@ While Loop Block - This implements a while loop. The required attribute condition is a Perl scriptlet that when evaluated results in a true or false value. If true, the entirety of the text between the whiles is parsed. The condition is tested again, etc. If false, it goes to the next tag. + This implements a while loop. The required attribute condition is a Perl scriptlet that when evaluated results in a true or false value. If true, the entirety of the text between the whiles is parsed. The condition is tested again, etc. If false, it goes to the next element. @@ -4641,7 +4675,7 @@ Randomly Parsed Block - The enclosed tags are parsed in a stable random order. The optional attribute show=“N” restricts the number of tags inside that are actually parsed to no more than N. N can equal the total tags inside. The randomlist tag can be used to randomize problem parts by wrapping the <part> tags with a randomlist tag. Note that when randomlist wraps <part> tags, that all students will work all parts only if show=“N” where N is the total number of parts wrapped. When N is less than the total number of parts wrapped, there will be gaps in the assessment chart, and also in the table of submissions for each student, corresponding to those parts which are never available to that particular student. + The enclosed elements are parsed in a stable random order. The optional attribute show=“N” restricts the number of elements inside that are actually parsed to no more than N. N can equal the total elements inside. The randomlist element can be used to randomize problem parts by wrapping the <part> elements with a randomlist element. Note that when randomlist wraps <part> elements, that all students will work all parts only if show=“N” where N is the total number of parts wrapped. When N is less than the total number of parts wrapped, there will be gaps in the assessment chart, and also in the table of submissions for each student, corresponding to those parts which are never available to that particular student. @@ -4791,7 +4825,7 @@ <translated> starts a block of a resource that has multiple translations. - See the <lang> tag as well. + See the <lang> element as well. When </translated> is encountered if there is a translation for the currently preferred language, that is rendered inthe web/tex/webgrade targets. Otherwise, the default text is rendered. Note that <lang> is only registered for the duration of the <translated>...</translated> block. @@ -4806,7 +4840,7 @@ - Specifies that the block contained within it is a translation for a specific language specified by the 'which' attribute. The 'other' attribute can be used by itself or in conjunction with which to specify this tag _may_ be used as a translation for some list of languages. e.g.: + Specifies that the block contained within it is a translation for a specific language specified by the 'which' attribute. The 'other' attribute can be used by itself or in conjunction with which to specify this element _may_ be used as a translation for some list of languages. e.g.: <lang which='senisoUS' other='senisoCA,senisoAU,seniso'> specifying that the block provides a translation for US (primary) Canadian, Australian and UK English. @@ -5095,7 +5129,7 @@ Display Script Result Block - The intervening Perl script is evaluated in the safe space and the return value of the script replaces the entire tag. + The intervening Perl script is evaluated in the safe space and the return value of the script replaces the entire element. @@ -5180,7 +5214,13 @@ - + + + + Option to force the math rendering for this element. + + + @@ -6560,28 +6600,28 @@ - Bold + The HTML <b> Element represents a span of text stylistically different from normal text, without conveying any special importance or relevance. It is typically used for keywords in a summary, product names in a review, or other spans of text whose typical presentation would be boldfaced. Another example of its use is to mark the lead sentence of each paragraph of an article. - Italic + The HTML <i> Element represents a range of text that is set off from the normal text for some reason, for example, technical terms, foreign language phrases, or fictional character thoughts. It is typically displayed in italic type. - Superscript + The HTML Superscript Element (<sup>) defines a span of text that should be displayed, for typographic reasons, higher, and often smaller, than the main span of text. - Subscript + The HTML Subscript Element (<sub>) defines a span of text that should be displayed, for typographic reasons, lower, and often smaller, than the main span of text.