File:  [LON-CAPA] / doc / homework / Attic / homework.html
Revision 1.1: download - view: text, annotated - select for diffs
Tue Jun 20 19:27:56 2000 UTC (24 years, 1 month ago) by albertel
Branches: MAIN
CVS tags: version_0_4, stable_2002_spring, stable_2002_july, stable_2002_april, stable_2001_fall, STABLE, HEAD
-adding homework documentation

    1: <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
    2: <html>
    3:   <head>
    4:     <title>LON-CAPA Homework System</title>
    5:   </head>
    6: 
    7:   <body>
    8:     <h1>LON-CAPA Homework System</h1>
    9: 
   10: <h2>Tags</h2>
   11:     <ul>
   12:       <li>Output Tags
   13: 	<p>     
   14: 	  This set of tags control how and when data gets sent to the
   15: 	  student, it also provides hints to the data's markup and when
   16: 	  it should be autoconverted, and when it should be ignored. All
   17: 	  of these tags except &lt;outtext&gt; are valid and parsed by  
   18: 	  &amp;parsed() inside a &lt;script&gt;.
   19: 	</p>
   20: 	<p>
   21: 	  Additionaly any perl style variables are replaced with the values
   22: 	  of the variable in the problem namespace.
   23: 	</p>
   24: 	<ul>
   25: 	  <li>
   26: 	    &lt;outtext&gt; all data inside is assumed to be valid
   27: 	    html, the handler will attempt to autoconvert to the output
   28: 	    type. The only thing tags allowed inside are the ones listed
   29: 	    below.
   30: 	  </li>
   31: 
   32: 	  <li>
   33: 	    &lt;target&gt; This tag specifies data that is not in HTMl
   34: 	    format inside an &lt;outtext&gt;. Takes a required
   35: 	    argument <arg>type</arg> and an optional argument
   36: 	    <arg>dest</arg>. <arg>type</arg> specifies a known valid
   37: 	    output target which is the format of the
   38: 	    data. <arg>dest</arg> specifies a list of possible output
   39: 	    targets that the data should be autoconverted for. The
   40: 	    \arg{type&gt; of the data is assumed to be a
   41: 	    \arg{dest&gt;. If the current target is not a
   42: 	    \arg{dest&gt; then the data is ignored.
   43: 	    </li>
   44: 	\item &lt;tex&gt; shorthand for $<$target type=``tex''$>$
   45: 	\arg{dest&gt; is a valid argument.
   46: 
   47: 	\item &lt;ascii&gt; shorthand for $<$target type=``ascii''$>$
   48: 	\arg{dest&gt; is a valid argument.
   49: 
   50: 	\item &lt;web&gt; shorthand for $<$target type=``web''$>$
   51: 	\arg{dest&gt; is a valid argument.
   52: 
   53: 	\item &lt;mathml&gt; shorthand for $<$target type=``mathml''$>$
   54: 	\arg{dest&gt; is a valid argument, mathml may be passed along
   55: 	unconverted in a web output target.
   56: 
   57: 	\end{itemize&gt;
   58: \item Form Elements:
   59: 
   60: 	This set of tags soley generate a representation of the proper
   61: 	form element on the output device. Need to look at what should
   62: 	be provided when an exam is wanted.
   63: 
   64: 	\begin{itemize&gt;
   65: 	\item &lt;radio&gt; 
   66: 	
   67: 	web - provides a single button to check on and off, when checked on
   68: 	all other radio buttons in the current &lt;answergroup&gt; level
   69: 	will be set to off.
   70: 	
   71: 	tex - generates a circle before the data inside
   72: 
   73: 	\item &lt;list&gt;
   74: 	
   75: 	web - provides a drop down box of all the possible options
   76: 
   77: 	tex - the list is displayed an students can select the correct option
   78: 
   79: 	\item &lt;textline&gt;
   80: 	
   81: 	web - a single line of reponse is provided to type into.
   82: 
   83: 	tex - a line is provided.
   84: 
   85: 	\item &lt;textarea&gt;
   86: 
   87: 	web - a textarea form is provided allowing multiples lines of response
   88: 
   89:  	tex - a configureable number of lines is provided, configured through 
   90: 	      the argument numlines, defaults to 10
   91: 
   92: 	\item &lt;check&gt;
   93: 	
   94: 	web - either a checkbutton, or two radio buttons are provided
   95: 
   96: 	tex - a small box that can be checked is provided.
   97: 
   98: 	\item &lt;button&gt; -  Not sure this is useful
   99: 
  100: 	\end{itemize&gt;
  101: \item Randomiztion
  102: 	\begin{itemize&gt;
  103: 	\item &lt;randomlist&gt; this tag will cause the parser to randomly select the order that it parses the next level of tags, tags another leveldown will be done in order though.Example
  104: &lt;randomlist&gt;\\
  105: \hspace5pt &lt;tag1&gt;\\
  106: 		&lt;subtag1&gt;\\
  107: 		&lt;/subtag1&gt;\\
  108: 		&lt;subtag2&gt;\\
  109: 		&lt;/subtag2&gt;\\
  110: 	&lt;/tag1&gt;\\
  111: 	&lt;tag2&gt;\\
  112: 		&lt;subtag1&gt;\\
  113: 		&lt;/subtag1&gt;\\
  114: 		&lt;subtag2&gt;\\
  115: 		&lt;/subtag2&gt;\\
  116: 	&lt;/tag2&gt;\\
  117: &lt;/randomlist&gt;\\
  118: In this example, &lt;tag1&gt; or &lt;tag2&gt; will be done first, but &lt;subtag1&gt; will always happen before &lt;subtag2&gt;.
  119: 
  120: 	\item &lt;foil&gt;
  121: 	\item &lt;showfoil&gt;
  122: 	\item &lt;showrandomfoil&gt;
  123: 	\end{itemize&gt;
  124: \item Answer Section
  125: 	\begin{itemize&gt;
  126: 	\item &lt;answergroup&gt;
  127: 	\item &lt;*response&gt;
  128: 	\end{itemize&gt;
  129: \item Problem Contruction
  130: 	\begin{itemize&gt;
  131: 	\item &lt;block&gt;
  132: 	\item &lt;part&gt;
  133: 	\item &lt;include&gt;
  134: 	\item &lt;script&gt;
  135: 	\item &lt;problem&gt;
  136: 	\item &lt;entryform&gt;
  137: 	\item &lt;survey&gt;
  138: 	\item &lt;graded&gt;
  139: 	\item &lt;while&gt;
  140: 	\end{itemize&gt;
  141: \item Libraries
  142: 	\begin{itemize&gt;
  143: 	\item &lt;scriptlib&gt;
  144: 	\item &lt;parserlib&gt;
  145: 	\end{itemize&gt;
  146: \end{itemize}
  147: 
  148: \section{CAPA compatability function Calls}
  149: \begin{itemize}
  150: \item random
  151: \item random\_normal
  152: \item random\_beta
  153: \item random\_gamma
  154: \item random\_poisson
  155: \item random\_exponential
  156: \item random\_chi
  157: \item random\_noncentral\_chi
  158: \item choose
  159: \item var\_in\_tex
  160: \item capa\_id
  161: \item class, section, set, problem, name, student\_number
  162: \item due\_date, open\_date, answer\_date
  163: \item to\_string
  164: \item sub\_string
  165: \item strlen
  166: \item get\_seed
  167: \item set\_seed
  168: \item init\_array
  169: \item array\_max, array\_min
  170: \item array\_moments
  171: \item to\_int
  172: \item format
  173: \item pick
  174: \item sin, cos, tan, asin, acos, atan, atan2
  175: \item sinh, cosh, tanh, asinh, acosh, atanh
  176: \item j0, j1, jn, y0, y1, yn
  177: \item log, log10
  178: \item exp, pow
  179: \item erf, erfc
  180: \item sqrt
  181: \item min, max
  182: \item abs, floor, ceil, sgn, mod, remainder
  183: \item factorial
  184: \item roundto
  185: \item eval\_formula
  186: \item capa\_id\_plus
  187: \item seat\_number
  188: \item duration
  189: \item is\_open, is\_due, is\_answer
  190: \item managermode
  191: \end{itemize}
  192: \end{document}
  193: 
  194: 
  195:     <hr>
  196:     <address><a href="mailto:albertel@marvin.lite.msu.edu">Guy Albertelli</a></address>
  197: <!-- Created: Mon Mar 27 16:14:28 EST 2000 -->
  198: <!-- hhmts start -->
  199: Last modified: Mon Mar 27 16:44:40 EST 2000
  200: <!-- hhmts end -->
  201:   </body>
  202: </html>

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