diff options
Diffstat (limited to 'macros/latex/contrib/acrotex/doc/aeb_man.tex')
-rw-r--r-- | macros/latex/contrib/acrotex/doc/aeb_man.tex | 69 |
1 files changed, 56 insertions, 13 deletions
diff --git a/macros/latex/contrib/acrotex/doc/aeb_man.tex b/macros/latex/contrib/acrotex/doc/aeb_man.tex index 29337b17a0..93c348abb9 100644 --- a/macros/latex/contrib/acrotex/doc/aeb_man.tex +++ b/macros/latex/contrib/acrotex/doc/aeb_man.tex @@ -17,7 +17,7 @@ %%\usepackage{times} %\usepackage{timesNRMT} -% \previewOn\pmpvOn +%\previewOn\pmpvOn \usepackage{aeb_mlink} \usepackage{longtable,colortbl} @@ -243,10 +243,10 @@ \university{{\AcroT} Software Development Team} \email{dpstory@acrotex.net} \versionLabel{Dated:} -\version{2021/06/19} +\version{2021/10/03} \copyrightyears{1999-\the\year} \nocopyright -\prepared{2021/06/19} +\prepared{2021/10/03} \revisionLabel{Distribution Dated:} \copyrightStatus{True} @@ -4153,7 +4153,7 @@ this topic. \subsection{The \texttt{userbmintrvl} Option}\label{eq:userbmintrvl} -The \opt{userbmintrvl} option defines \cs{rbmIntrvl} command, the syntax of which is, +The \opt{userbmintrvl} option defines the \cs{rbmIntrvl} command, the syntax of which is, \bVerb\takeMeasure{\cs{rbmIntrvl\darg{[a,b]}\ameta{\textsf{arguments of \cs{RespBoxMath}}}}}% \begin{dCmd}[commandchars=!()]{\bxSize} \rbmIntrvl{[a,b]}!ameta(!textsf(arguments of !cs(RespBoxMath))) @@ -5284,7 +5284,7 @@ Which of the following are prime numbers? \Ans0 1 & \Ans1 2 & \Ans1 3 & - \Ans0 4 \\ + \Ans0 4 \\[3bp] \Ans1 5 & \Ans0 6 & \Ans1 7 & @@ -5305,6 +5305,40 @@ You'll note that the \env{shortquiz} environment is used, yet form fields (check boxes) are used; this is by design. Links are not available for MS questions, only for MC questions. +\subsubsection{The rollover display of choice fields}\label{ss:ChoiceTT} + +In recent versions of \textsf{AA/AR DC}, the rollover display for choice +fields (radio fields and checkboxes) has changed. Previously when the mouse +rolls over a choice field, the tool tip is displayed. For quizzes, the choice +fields have no tool tip, so nothing was displayed. Now, \textsf{AA/AR DC} +displays \texttt{\ameta{tool-tip}:\,\ameta{export-value}}, which reveals +information not intended for the student taking that quiz. The \pkg{exerquiz} +package is modified to reflect this change. The rollover of radio buttons and +check boxes now displays as \texttt{Choice:\,a}, \texttt{Choice:\,b}, \dots. The word +`Choice' is the tool tip and lower case letter is the export value. The tool tip for +all choice fields of a quizzes can be changed with \cs{TUChoice}: +\begin{Verbatim}[xleftmargin=\amtIndent,commandchars=!()] +\TUChoice{!ameta(text)} +\end{Verbatim} +The default is \verb~\TUChoice{Choice}~. + +The tool tip may be localized to other languages as follows: +\begin{Verbatim}[xleftmargin=\amtIndent,commandchars=!()] +\TUChoice{Ellecci\'{o}n} +\end{Verbatim} +to obtain the Spanish word Ellecci\'{o}n for choice. More obscure localization +can be done using unicode, for example, +\begin{Verbatim}[xleftmargin=\amtIndent,commandchars=!()] +\defUniStr{Choice}{Ellecci\u00F3n} +\TUChoice{\unicodeStr(Choice)} +\end{Verbatim} +However, for this form to be valid, the preamble must use the package \pkg{forms16be}: +\begin{Verbatim} +\usepackage{exerquiz} +\usepackage{forms16be} +\end{Verbatim} + + \subsubsection{Other supported question types} In addition to MC and MS questions, any other supported types can be used @@ -5356,9 +5390,9 @@ Was it in Xanadu did Kubla Kahn a stately pleasure dome decree? short-quiz to change response feedback; \cs{sqTurnOffAlerts} turns off the (annoying) alerts. -\redpoint The \cs{sqTurnOffAlerts} command only apply to a short-quiz that -uses radio buttons. You can reverse the effect of this command by expanding -\cs{sqTurnOnAlerts}. The default is \cs{sqTurnOnAlerts}. +\redpoint The \cs{sqTurnOffAlerts} command only apply to a short-quiz. +Reverse the effect of this command by expanding \cs{sqTurnOnAlerts}. The +default is \cs{sqTurnOnAlerts}. \subsubsection{\texttt{shortquiz} with solutions}\label{ss:QuizS} @@ -6037,7 +6071,7 @@ levels are set through the optional argument of \cs{sqTallyTotal}. \begin{aebQuote} \begin{description} -\item[Weak passing level] Syntax: \cs{sqTallyTotal[\cs{weakpassing\darg{\ameta{n}}}]}\\[3pt] +\item[Weak passing level] Syntax: \cs{sqTallyTotal[\cs{weakpass\darg{\ameta{n}}}]}\\[3pt] \textbf{User Experience.} As soon as the student makes more than \ameta{n} errors, the following message appears in an alert dialog box: \begin{Verbatim} @@ -6048,7 +6082,7 @@ with fewer errors and greater understanding.} The student is allowed to continue the quiz, but with the knowledge the performance is below the expected standard, as set by the instructor. -\item[Strong passing level] Syntax: \cs{sqTallyTotal[\cs{strongpassing\darg{\ameta{n}}}]}\\[3pt] +\item[Strong passing level] Syntax: \cs{sqTallyTotal[\cs{strongpass\darg{\ameta{n}}}]}\\[3pt] \textbf{User Experience.} As soon as the student makes more than \ameta{n} errors, the following message appears in an alert dialog box: \begin{Verbatim} @@ -6580,6 +6614,12 @@ argument to pass partial points rewarded for a wrong answer. \texttt{manswers} environment, \Nameref{manswersQuiz}, for posting questions with multiple correct answers. +\subsubsection{The rollover display choice fields} + +Refer to the comments in the subsection titled \Nameref{ss:ChoiceTT}. + + + \subsection{Basic Usage} In this section we discuss the two \texttt{quiz} styles: @@ -6799,8 +6839,8 @@ Prior to your quiz, use the following code, if desired. \useBeginQuizButton \useEndQuizButton \end{Verbatim} -Clicking the \uif{Begin Quiz} button clears all fields in the quiz and initializes it for the user -to respond to each question. Shift-clicking the \uif{Begin Quiz} button clears all fields, but does not +Clicking the \FmtMP{Click \uif{Begin Quiz} action}\uif{Begin Quiz} button clears all fields in the quiz and initializes it for the user +to respond to each question. Shift-clicking the \FmtMP{Shift-click \uif{Begin Quiz} action}\uif{Begin Quiz} button clears all fields, but does not initialize the quiz. \useBeginQuizButton\useEndQuizButton @@ -7241,6 +7281,9 @@ parameter is a unique name for the solution to the quiz. Notice as well that the \texttt{solution} environment follows, and is not nested within the \texttt{answers} environment. +\subsubsection{The rollover display choice fields} + +Refer to the comments in the subsection titled \Nameref{ss:ChoiceTT}. \subsection{How to Modify the \texttt{quiz} Environment} @@ -12020,7 +12063,7 @@ features of the \pkg{web} and \textsf{exerquiz} packages. \item Documented the use of form check boxes with the \texttt{shortquiz} environment and introduced the commands \begin{Verbatim}[xleftmargin=\amtIndent] - \sqTurnOffAlerts,\sqTurnOnAlerts,\sqNoCorrections,\sqNoCorrections + \sqTurnOffAlerts,\sqTurnOnAlerts,\sqCorrections,\sqNoCorrections \end{Verbatim} to control response feedback. \item Added language \texttt{finnish} Options. Translation due |