[LON-CAPA-cvs] cvs: doc /homework homework5.html
albertel
lon-capa-cvs@mail.lon-capa.org
Thu, 06 Jun 2002 07:13:23 -0000
This is a MIME encoded message
--albertel1023347603
Content-Type: text/plain
albertel Thu Jun 6 03:13:23 2002 EDT
Modified files:
/doc/homework homework5.html
Log:
-add tags <externalresponse> <randomlabel> <standalone>
-added script function prettyprint()
--albertel1023347603
Content-Type: text/plain
Content-Disposition: attachment; filename="albertel-20020606031323.txt"
Index: doc/homework/homework5.html
diff -u doc/homework/homework5.html:1.14 doc/homework/homework5.html:1.15
--- doc/homework/homework5.html:1.14 Fri May 3 14:34:20 2002
+++ doc/homework/homework5.html Thu Jun 6 03:13:23 2002
@@ -142,7 +142,59 @@
the field when interfacing with humans
</li>
</ul>
+ </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>
<li>
<a name="foil">Foil Structure Tags</a>
@@ -224,6 +276,11 @@
</p>
<ul>
<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
duedate if one is set into the document. It is generated
to be inside a table of 1x1 elements
@@ -242,15 +299,123 @@
<i>eval</i> is set to "on" the intervening text will have
a perl var expansion done to it before being converted.
</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>
</li>
<li>
Scripting
- <p>
- These tags allow the document to behave programatically
- </p>
- <ul>
- <li>
+ <p>
+ These tags allow the document to behave programatically
+ </p>
+ <ul>
+ <li>
<b><display></b> the intervening perl script is
evaluated in the safe space and the return value of the
script replaces the entire tag
@@ -373,7 +538,7 @@
<li>open_date(), due_date(), answer_date()</li>
<li>sub_string()</li>
<li>array_moments(array)</li>
- <li>format(x,y)</li>
+ <li>format(x,y),prettyprint(x,y)</li>
<li>map(...)</li>
<li>caparesponse_check</li>
<li>caparesponse_check_list</li>
@@ -500,6 +665,13 @@
</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">Rounds a real number to n decimal points. $x and
@@ -970,7 +1142,7 @@
<address><a href="mailto:albertel@marvin.lite.msu.edu">Guy Albertelli</a></address>
<!-- Created: Thu May 17 15:05:35 EDT 2001 -->
<!-- hhmts start -->
-Last modified: Fri May 3 14:24:52 EDT 2002
+Last modified: Thu Jun 6 03:15:56 EDT 2002
<!-- hhmts end -->
</body>
</html>
--albertel1023347603--