Diff for /doc/homework/homework5.html between versions 1.14 and 1.15

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>&lt;externalresponse&gt;</b> implements the ability to have
         an external program grade a response, expects either a
         &lt;textline&gt; or &lt;textfield&gt; 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>
   &lt;loncapagrade&gt;
       &lt;awardetail&gt;
   CORRECT
       &lt;/awardetail&gt;
       &lt;message&gt;
   A message to be shown to the students
       &lt;/message&gt;
   &lt;/loncapagrade&gt;
       </pre>
       <ul>
         <li>
    <b>&lt;loncapagrade&gt;</b> no arguments but must
    surround the response.
         </li>
         <li>
    <b>&lt;awardetail&gt;</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>&lt;message&gt;</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>&lt;standalone&gt;</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>&lt;displayduedate&gt;</b> this will insert the current      <b>&lt;displayduedate&gt;</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>&lt;randomlabel&gt;</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>
    &lt;randomlabel bgimg=&quot;URL&quot; width=&quot;12&quot; height=&quot;45&quot; texwidth=&quot;50&quot;&gt;
       &lt;labelgroup name=&quot;GroupOne&quot; type=&quot;image&quot;&gt;
         &lt;location x=&quot;123&quot; y=&quot;456&quot; value=&quot;10&quot; /&gt;
         &lt;location x=&quot;321&quot; y=&quot;654&quot; value=&quot;20&quot; /&gt;
         &lt;location x=&quot;213&quot; y=&quot;546&quot; value=&quot;13&quot; /&gt;
         &lt;label description=&quot;TEXT-1&quot;&gt;IMG-URL&lt;/label&gt;
         &lt;label description=&quot;TEXT-2&quot;&gt;IMG-URL&lt;/label&gt;
         &lt;label description=&quot;TEXT-3&quot;&gt;IMG-URL&lt;/label&gt;
       &lt;/labelgroup&gt;
       &lt;labelgroup name=&quot;GroupTwo&quot; type=&quot;text&quot;&gt;
         &lt;location x=&quot;12&quot; y=&quot;45&quot; /&gt;
         &lt;location x=&quot;32&quot; y=&quot;65&quot; /&gt;
         &lt;location x=&quot;21&quot; y=&quot;54&quot; /&gt;
         &lt;label&gt;TEXT-1&lt;/label&gt;
         &lt;label&gt;TEXT-2&lt;/label&gt;
         &lt;label&gt;TEXT-3&lt;/label&gt;
       &lt;/labelgroup&gt;
      &lt;/randomlabel&gt;
       </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>&lt;labelgroup&gt;</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>&lt;location&gt;</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>&lt;label&gt;</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>&lt;display&gt;</b> the intervening perl script is      <b>&lt;display&gt;</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">&amp;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">&nbsp;</td>
       </tr>
   
       <tr>
              <td valign="top">roundto(x,n)</td>               <td valign="top">roundto(x,n)</td>
              <td valign="top">&amp;roundto($x,$n)</td>               <td valign="top">&amp;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>

Removed from v.1.14  
changed lines
  Added in v.1.15


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>