Annotation of loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex, revision 1.3

1.1       bowersj2    1: \label{Authoring_Scripting_Tags}
                      2: 
                      3: \begin{itemize}
1.2       www         4: \item \textbf{display}\index{display}: The intervening Perl script is evaluated
1.1       bowersj2    5: in the safe space and the return value of the script replaces the
                      6: entire tag.
1.3     ! vandui11    7: \item \textbf{import}\index{import}: This causes the parse to read in the file
1.1       bowersj2    8: named in the body of the tag and parse it as if the entire text of
1.3     ! vandui11    9: the file had existed at the location of the tag.
        !            10: \item \textbf{parserlib}\index{parserlib}: The enclosed filename contains
1.1       bowersj2   11: definitions for new tags.
                     12: \item \textbf{script}\index{script}: If the attribute \textbf{type} is
1.2       www        13: set to {}``loncapa/perl'' the enclosed data is a Perl script which
1.3     ! vandui11   14: is evaluated inside the Perl safe space. The return value of the script
1.1       bowersj2   15: is ignored. 
                     16: \item \textbf{scriptlib}\index{scriptlib}: The enclosed filename contains
1.2       www        17: Perl code to run in the safe space.
1.3     ! vandui11   18: \item \textbf{block}\index{block}: This has a required argument \textbf{condition}
        !            19: that is evaluated. If the condition is true, everything inside the
        !            20: tag is evaluated; otherwise, everything inside the block tag is skipped.
1.1       bowersj2   21: \item \textbf{notsolved}\index{notsolved}: Everything inside the tag is
                     22: skipped if the problem is {}``solved''.
                     23: \item \textbf{postanswerdate}\index{postanswerdate}: Everything inside
                     24: the tag is skipped if the problem is before the answer date.
                     25: \item \textbf{preduedate}\index{preduedate}: Everything inside the tag
1.3     ! vandui11   26: is skipped if the problem is after the due date. 
1.1       bowersj2   27: \item \textbf{randomlist}\index{randomlist}: The enclosed tags are parsed
                     28: in a stable random order. The optional attribute \textbf{show} restricts
                     29: the number of tags inside that are actually parsed to no more than
                     30: \textbf{show}.
                     31: \item \textbf{solved}\index{solved}: Everything inside the tag is skipped
                     32: if the problem is {}``not solved''.
1.3     ! vandui11   33: \item \textbf{while}\index{while}: This implements a while loop. The required
1.2       www        34: attribute \textbf{condition} is a Perl scriptlet that when evaluated
1.3     ! vandui11   35: results in a true or false value. If true, the entirety of the text
1.1       bowersj2   36: between the whiles is parsed. The condition is tested again, etc.
1.3     ! vandui11   37: If false, it goes to the next tag.
1.1       bowersj2   38: \end{itemize}

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