--- modules/damieng/clean_xml/loncapa.xsd 2015/04/27 20:39:01 1.3
+++ modules/damieng/clean_xml/loncapa.xsd 2015/05/13 19:08:29 1.12
@@ -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.
@@ -718,7 +718,7 @@
- Print options
+ Set to "nochoice" to avoid the display of the list of option values when printing.
@@ -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.
@@ -754,6 +754,36 @@
+
+
+
+ Set to "nochoice" to omit "Select all that are ... ".
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Minimum boxes required to check.
+
+
+
+
+
+
+ Maximum boxes permitted to check.
+
+
+
@@ -1057,7 +1087,9 @@
- Query for the selection of an image in a list.
+ Query for positions on images.
+
+ Each foil must contain a reference to an image, at least one rectangle or polygon specifying the correct region, and a text describing what should be selected. Students have to click on the foil image, and their answer is correct if they clicked inside the correct region.
@@ -1347,6 +1379,8 @@
3. followed by any number of the following two things, separated by semi-colons:
(a) a comma-separated list of as many numbers as there are variables, which specifies one sampling point, OR
(b) a comma-separated list of as many numbers as there are variables, followed by a colon, followed by another list of as many numbers as there are variables, followed by a #, followed by an integer.
+
+ a) specifies one point to sample. b) specifies a range for each variable, and the system will take as many random samples from that range as the number after the #.
@@ -1398,11 +1432,9 @@
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.
+ 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.
+ This is usually the name of a Perl string variable (starting with '$') created in a Perl script before the response.
@@ -2124,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
+
+
@@ -2137,14 +2180,16 @@
- Starting Molecule
+ Starting Molecule.
+ Syntax: JME.
- Correct Answer
+ Correct Answer.
+ Syntax: SMILES (Simplified Molecular Input Line Entry System).
@@ -2274,6 +2319,7 @@
+
@@ -2315,7 +2361,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.
@@ -2401,7 +2447,8 @@
- Spellcheck for
+ If this attribute is present, the text the user types is spellchecked when focus leaves the input field.
+ The value specifies the language in which the spellcheck is performed.
@@ -2447,6 +2494,12 @@
+
+
+ If this attribute is present, the text the user types is spellchecked when focus leaves the input field.
+ The value specifies the language in which the spellcheck is performed.
+
+
@@ -2494,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.
@@ -2525,7 +2583,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 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.
@@ -2593,11 +2651,11 @@
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 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.
@@ -2612,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”
+
+
+
+
+
@@ -2626,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 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.
@@ -2641,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')
+
+
+
+
+
+
+
+
@@ -2796,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.
@@ -2989,7 +3079,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.
@@ -3000,7 +3090,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.
@@ -3375,29 +3465,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.
@@ -3763,7 +3853,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.
@@ -3854,7 +3944,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.
@@ -3922,7 +4012,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.
@@ -3960,7 +4050,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.
@@ -4268,7 +4358,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.
@@ -4443,7 +4533,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.
@@ -4476,7 +4566,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.
@@ -4533,7 +4623,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.
@@ -4677,7 +4767,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.
@@ -4796,19 +4886,6 @@
-
-
-
- Perl Script Block
-
- If the attribute type is set to “loncapa/perl” the enclosed data is a Perl script which is evaluated inside the Perl safe space. The return value of the script is ignored.
-
-
-
-
-
-
-
@@ -4827,7 +4904,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.
@@ -4842,7 +4919,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.
@@ -5131,7 +5208,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.
@@ -5216,7 +5293,13 @@
-
+
+
+
+ Option to force the math rendering for this element.
+
+
+
@@ -5373,7 +5456,7 @@
-
+
@@ -5582,64 +5665,72 @@
-
+
+ Perl Script Block or Javascript
+
+ If the attribute type is set to “loncapa/perl” the enclosed data is a Perl script which is evaluated inside the Perl safe space. The return value of the script is ignored.
+
The HTML <script> element is used to embed or reference an executable script within an HTML or XHTML document.
Scripts without async or defer attributes, as well as inline scripts, are fetched and executed immediately, before the browser continues to parse the page.
-
-
-
-
-
- This attribute specifies the URI of an external script; this can be used as an alternative to embedding a script directly within a document. script elements with an src attribute specified should not have a script embedded within its tags.
-
-
-
-
-
-
- This attribute identifies the scripting language of code embedded within a script element or referenced via the element’s src attribute. This is specified as a MIME type; examples of supported MIME types include text/javascript, text/ecmascript, application/javascript, and application/ecmascript.
-
-
-
-
-
-
- Like the type attribute, this attribute identifies the scripting language in use. Unlike the type attribute, however, this attribute’s possible values were never standardized. The type attribute should be used instead.
-
-
-
-
-
-
- This Boolean attribute is set to indicate to a browser that the script is meant to be executed after the document has been parsed. Since this feature hasn't yet been implemented by all other major browsers, authors should not assume that the script’s execution will actually be deferred. The defer attribute shouldn't be used on scripts that don't have the src attribute. Since Gecko 1.9.2, the defer attribute is ignored on scripts that don't have the src attribute. However, in Gecko 1.9.1 even inline scripts are deferred if the defer attribute is set.
-
-
-
-
-
-
-
-
-
-
-
- HTML5 only.
- Set this Boolean attribute to indicate that the browser should, if possible, execute the script asynchronously. It has no effect on inline scripts (i.e., scripts that don't have the src attribute).
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+ This attribute specifies the URI of an external script; this can be used as an alternative to embedding a script directly within a document. script elements with an src attribute specified should not have a script embedded within its tags.
+
+
+
+
+
+
+ This attribute identifies the scripting language of code embedded within a script element or referenced via the element’s src attribute. This is specified as a MIME type; examples of supported MIME types include text/javascript, text/ecmascript, application/javascript, and application/ecmascript.
+
+ If the attribute type is set to “loncapa/perl” the enclosed data is a Perl script which is evaluated inside the Perl safe space. The return value of the script is ignored.
+
+
+
+
+
+
+ Like the type attribute, this attribute identifies the scripting language in use. Unlike the type attribute, however, this attribute’s possible values were never standardized. The type attribute should be used instead.
+
+
+
+
+
+
+ This Boolean attribute is set to indicate to a browser that the script is meant to be executed after the document has been parsed. Since this feature hasn't yet been implemented by all other major browsers, authors should not assume that the script’s execution will actually be deferred. The defer attribute shouldn't be used on scripts that don't have the src attribute. Since Gecko 1.9.2, the defer attribute is ignored on scripts that don't have the src attribute. However, in Gecko 1.9.1 even inline scripts are deferred if the defer attribute is set.
+
+
+
+
+
+
+
+
+
+
+
+ HTML5 only.
+ Set this Boolean attribute to indicate that the browser should, if possible, execute the script asynchronously. It has no effect on inline scripts (i.e., scripts that don't have the src attribute).
+
+
+
+
+
+
+
+
+
+
+
@@ -6552,14 +6643,60 @@
-
-
-
-
-
-
-
+
+
+
+ HTML 4 only, Obsolete since HTML5.
+
+ This attribute is required in an anchor defining a target location within a page. A value for name is similar to a value for the id core attribute and should be an alphanumeric identifier unique to the document. Under the HTML 4.01 specification, id and name both can be used with the <a> element as long as they have identical values.
+
+ Usage note: This attribute is obsolete in HTML5, use global attribute id instead.
+
+
+
+
+
+
+ This was the single required attribute for anchors defining a hypertext source link, but is no longer required in HTML5. Omitting this attribute creates a placeholder link. The href attribute indicates the link target, either a URL or a URL fragment. A URL fragment is a name preceded by a hash mark (#), which specifies an internal target location (an ID) within the current document. URLs are not restricted to Web (HTTP)-based documents. URLs might use any protocol supported by the browser. For example, file, ftp, and mailto work in most user agents.
+
+ Note: You can use the special fragment "top" to create a link back to the top of the page; for example <a href="#top">Return to top</a>. This behavior is specified by HTML5.
+
+
+
+
+
+
+ This attribute specifies where to display the linked resource. In HTML4, this is the name of, or a keyword for, a frame. In HTML5, it is a name of, or keyword for, a browsing context (for example, tab, window, or inline frame). The following keywords have special meanings:
+
+ * _self: Load the response into the same HTML4 frame (or HTML5 browsing context) as the current one. This value is the default if the attribute is not specified.
+ * _blank: Load the response into a new unnamed HTML4 window or HTML5 browsing context.
+ * _parent: Load the response into the HTML4 frameset parent of the current frame or HTML5 parent browsing context of the current one. If there is no parent, this option behaves the same way as _self.
+ * _top: In HTML4: Load the response into the full, original window, canceling all other frames. In HTML5: Load the response into the top-level browsing context (that is, the browsing context that is an ancestor of the current one, and has no parent). If there is no parent, this option behaves the same way as _self.
+
+ Use this attribute only if the href attribute is present.
+
+
+
+
+
+
+ Contains a text representing advisory information related to the element it belongs to. Such information can typically, but not necessarily, be presented to the user as a tooltip.
+
+
+
+
+
+
+ For anchors containing the href attribute, this attribute specifies the relationship of the target object to the link object. The value is a comma-separated list of link types values. The values and their semantics will be registered by some authority that might have meaning to the document author. The default relationship, if no other is given, is void. Use this attribute only if the href attribute is present.
+
+
+
+
+
+ Provides a hint for generating a keyboard shortcut for the current element. This attribute consists of a space-separated list of characters. The browser should use the first one that exists on the computer keyboard layout.
+
+
@@ -6577,6 +6714,38 @@
+
+
+
+ Attribute specific to LON-CAPA.
+ Display the href attribute when printing.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Attribute specific to LON-CAPA.
+ Display the name attribute when printing.
+
+
+
+
+
+
+
+
+
+
+
@@ -6596,28 +6765,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.