version 1.14, 2002/05/03 18:34:20
|
version 1.15, 2002/06/06 07:13:23
|
Line 142
|
Line 142
|
the field when interfacing with humans |
the field when interfacing with humans |
</li> |
</li> |
</ul> |
</ul> |
|
</li> |
<li> |
<li> |
|
<p> |
|
<b><externalresponse></b> implements the ability to have |
|
an external program grade a response, expects either a |
|
<textline> or <textfield> inside the tag. <br /> |
|
</p> |
|
Arguments: |
|
<ul> |
|
<li> |
|
<i>url</i> the url to submit the answer and form to, |
|
does not need to be a LON-CAPA machine. |
|
</li> |
|
<li> |
|
<i>answer</i> a string or scalar variable that can |
|
encode something that should encode the correct |
|
answer, in some cases this may be nothing. |
|
</li> |
|
<li> |
|
<i>form</i> a hash variable name that will be |
|
submitted to the remote site as a HTTP form. |
|
</li> |
|
</ul> |
|
<p> |
|
The response of the remote server needs to be in XML as follows. |
|
</p> |
|
<pre> |
|
<loncapagrade> |
|
<awardetail> |
|
CORRECT |
|
</awardetail> |
|
<message> |
|
A message to be shown to the students |
|
</message> |
|
</loncapagrade> |
|
</pre> |
|
<ul> |
|
<li> |
|
<b><loncapagrade></b> no arguments but must |
|
surround the response. |
|
</li> |
|
<li> |
|
<b><awardetail></b> required inner tag, the |
|
response inside must be one of the detailed responses |
|
that appears in the data storage documentation |
|
(CVS:loncapa/doce/homework/datastorage) |
|
</li> |
|
<li> |
|
<b><message></b> optional message to have shown |
|
to the student |
|
</li> |
|
</ul> |
|
</li> |
</ul> |
</ul> |
<li> |
<li> |
<a name="foil">Foil Structure Tags</a> |
<a name="foil">Foil Structure Tags</a> |
Line 224
|
Line 276
|
</p> |
</p> |
<ul> |
<ul> |
<li> |
<li> |
|
<b><standalone></b> everything in between the start |
|
and end tag is shown only on the web, and only if the |
|
resource is not part of a course. |
|
</li> |
|
<li> |
<b><displayduedate></b> this will insert the current |
<b><displayduedate></b> this will insert the current |
duedate if one is set into the document. It is generated |
duedate if one is set into the document. It is generated |
to be inside a table of 1x1 elements |
to be inside a table of 1x1 elements |
Line 242
|
Line 299
|
<i>eval</i> is set to "on" the intervening text will have |
<i>eval</i> is set to "on" the intervening text will have |
a perl var expansion done to it before being converted. |
a perl var expansion done to it before being converted. |
</li> |
</li> |
|
<li> |
|
<b><randomlabel></b> shows a specified image with |
|
images or text labels randomly assigned to a set of |
|
specific locations, those locations may also have values |
|
assigned to them. There is a hash generated conating the |
|
mapping of labels to locations, labels to values, and |
|
locations to values. Example: |
|
<pre> |
|
<randomlabel bgimg="URL" width="12" height="45" texwidth="50"> |
|
<labelgroup name="GroupOne" type="image"> |
|
<location x="123" y="456" value="10" /> |
|
<location x="321" y="654" value="20" /> |
|
<location x="213" y="546" value="13" /> |
|
<label description="TEXT-1">IMG-URL</label> |
|
<label description="TEXT-2">IMG-URL</label> |
|
<label description="TEXT-3">IMG-URL</label> |
|
</labelgroup> |
|
<labelgroup name="GroupTwo" type="text"> |
|
<location x="12" y="45" /> |
|
<location x="32" y="65" /> |
|
<location x="21" y="54" /> |
|
<label>TEXT-1</label> |
|
<label>TEXT-2</label> |
|
<label>TEXT-3</label> |
|
</labelgroup> |
|
</randomlabel> |
|
</pre> |
|
Arguments: |
|
<ul> |
|
<li> |
|
<i>bgimg</i> either a fully qualified URL for an |
|
external image, or a loncapa resource, it supports |
|
relative references (../images/apicture.gif), the |
|
image must either be a GIF or JPEG |
|
</li> |
|
<li> |
|
<i>width</i> the width of the image in pixels |
|
</li> |
|
<li> |
|
<i>height</i> the height of the image in pixels |
|
</li> |
|
<li> |
|
<i>texwidth</i> the width of the image in millimeters |
|
</li> |
|
</ul> |
|
Internal tags: |
|
<ul> |
|
<li> |
|
<b><labelgroup></b> 1 required, multiple |
|
allowed. Declares a group of locations and labels |
|
associated with them. <br />Arguments: |
|
<ul> |
|
<li> |
|
<i>name</i> this is the name of the group, a hash |
|
with this name will be generated holding the |
|
mappings for later use in the problem. For each |
|
location a value will be set for which label is |
|
there, (EX. $hash{'1'}="TEXT-2"). For locations |
|
with values the hash will contain 2 items, a |
|
location to value mapping ($hash{'value_1'}=10), |
|
and a label to value mapping |
|
($hash{'labelvalue_2'}=10). For all image style of |
|
labels there will also be a label description to |
|
label URL mapping ($hash{'image_2'}=IMG-URL). Also |
|
the entry 'numlocations will be set to the total |
|
number of locations that exist. |
|
(Note that locations and labels start counting from 1.) |
|
</li> |
|
<li> |
|
<i>type</i> the type of labels in this group, |
|
either 'image' or 'text' |
|
</li> |
|
</ul> |
|
</li> |
|
<li> |
|
<b><location></b> declares a location on the |
|
image that a label should appear at <br />Arguments: |
|
<ul> |
|
<li> |
|
<i>x</i> the x value of the location in pixels |
|
</li> |
|
<li> |
|
<i>y</i> the y value of the location in pixels |
|
</li> |
|
<li> |
|
<i>value</i> a scalar value to associate at this |
|
location (optional) |
|
</li> |
|
</ul> |
|
</li> |
|
<li> |
|
<b><label></b> declaration of a label, if this |
|
is a text type labelgroup the internal text should be |
|
the text of the label (HTML is not currently |
|
supported), if this is an image type of label the |
|
internal text must be a LON-CAPA resource |
|
specification, and the description filed must be set. |
|
<br />Arguments: |
|
<ul> |
|
<li> |
|
<i>description</i> a required field for image |
|
labels, it will be used when setting values in the |
|
hash. |
|
</li> |
|
</ul> |
|
</li> |
|
</ul> |
|
</li> |
</ul> |
</ul> |
</li> |
</li> |
<li> |
<li> |
Scripting |
Scripting |
<p> |
<p> |
These tags allow the document to behave programatically |
These tags allow the document to behave programatically |
</p> |
</p> |
<ul> |
<ul> |
<li> |
<li> |
<b><display></b> the intervening perl script is |
<b><display></b> the intervening perl script is |
evaluated in the safe space and the return value of the |
evaluated in the safe space and the return value of the |
script replaces the entire tag |
script replaces the entire tag |
Line 373
|
Line 538
|
<li>open_date(), due_date(), answer_date()</li> |
<li>open_date(), due_date(), answer_date()</li> |
<li>sub_string()</li> |
<li>sub_string()</li> |
<li>array_moments(array)</li> |
<li>array_moments(array)</li> |
<li>format(x,y)</li> |
<li>format(x,y),prettyprint(x,y)</li> |
<li>map(...)</li> |
<li>map(...)</li> |
<li>caparesponse_check</li> |
<li>caparesponse_check</li> |
<li>caparesponse_check_list</li> |
<li>caparesponse_check_list</li> |
Line 500
|
Line 665
|
</tr> |
</tr> |
|
|
<tr> |
<tr> |
|
<td valign="top">Not in CAPA</td> |
|
<td valign="top">&prettyprint($x,"nn")</td> |
|
<td valign="top">Display or format $x as nn where nn is nF or nE and n is an integer. In E mode it will attempt to generate a pretty x10^3 rather than a E3 following the number</td> |
|
<td valign="top"> </td> |
|
</tr> |
|
|
|
<tr> |
<td valign="top">roundto(x,n)</td> |
<td valign="top">roundto(x,n)</td> |
<td valign="top">&roundto($x,$n)</td> |
<td valign="top">&roundto($x,$n)</td> |
<td valign="top">Rounds a real number to n decimal points. $x and |
<td valign="top">Rounds a real number to n decimal points. $x and |
Line 970
|
Line 1142
|
<address><a href="mailto:albertel@marvin.lite.msu.edu">Guy Albertelli</a></address> |
<address><a href="mailto:albertel@marvin.lite.msu.edu">Guy Albertelli</a></address> |
<!-- Created: Thu May 17 15:05:35 EDT 2001 --> |
<!-- Created: Thu May 17 15:05:35 EDT 2001 --> |
<!-- hhmts start --> |
<!-- hhmts start --> |
Last modified: Fri May 3 14:24:52 EDT 2002 |
Last modified: Thu Jun 6 03:15:56 EDT 2002 |
<!-- hhmts end --> |
<!-- hhmts end --> |
</body> |
</body> |
</html> |
</html> |