Difference between revisions of "NamedAnswerRules"

From WeBWorK_wiki
Jump to navigation Jump to search
 
(13 intermediate revisions by the same user not shown)
Line 14: Line 14:
   
 
<tr valign="top">
 
<tr valign="top">
<th> PG problem file </th>
+
<th style="width:50%"> PG problem file </th>
 
<th> Explanation </th>
 
<th> Explanation </th>
 
</tr>
 
</tr>
Line 47: Line 47:
 
$ans = Compute(random(1, 5));
 
$ans = Compute(random(1, 5));
   
$ansName = NEW_ANS_NAME();
+
$ansName = NEW_ANS_NAME;
 
</pre>
 
</pre>
 
</td>
 
</td>
Line 53: Line 53:
 
<p>
 
<p>
 
<b>Setup:</b>
 
<b>Setup:</b>
We specify that the Context should be <code>......</code>, and define the answer to be a formula.
 
  +
Create the answers and do the usual setup.
 
</p>
 
</p>
 
<p>
 
<p>
Notes: on using this and related Contexts.
 
  +
Generate an answer name to use. This answer name can now be used via the variable $ansName as needed to do whatever it is that you needed the answer name for. It will be the id of the html input for the answer name, and so can be used to do things with the html input via javascript, etc.
  +
</p>
  +
<p>
  +
Many older problems just used a made up answer. That method will not work in gateway quizzes as it lacks the quiz prefix. The NEW_ANS_NAME method will give you an answer name that contains the quiz prefix if the problem is used in a gateway quiz.
 
</p>
 
</p>
 
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 67: Line 69:
 
<td style="background-color:#ffdddd;border:black 1px dashed;">
 
<td style="background-color:#ffdddd;border:black 1px dashed;">
 
<pre>
 
<pre>
  +
# PGML usage
 
BEGIN_PGML
 
BEGIN_PGML
Enter [$ans]: [_]{$ans}{
+
Enter [`[$ans]`]: [_]{$ans}{5}{$ansName}
 
END_PGML
 
END_PGML
</pre>
 
<td style="background-color:#ffcccc;padding:7px;">
 
<p>
 
<b>Main Text:</b>
 
The problem text section of the file is as we'd expect.
 
</p>
 
</td>
 
</tr>
 
   
<!-- Answer section -->
 
  +
# Basic PG usage (prefer PGML)
  +
BEGIN_TEXT
  +
Enter \($ans\): \{$ans->named_ans_rule($ansName, 5)\}
  +
END_TEXT
  +
LABELED_ANS($ansName, $ans->cmp);
   
<tr valign="top">
 
  +
# Add 'less than or equal' and 'greater than or equal' MathQuill toolbar buttons.
<td style="background-color:#eeddff;border:black 1px dashed;">
 
  +
TEXT(MODES(TeX => "", HTML => <<END_SCRIPT));
<pre>
 
  +
<script>
$showPartialCorrectAnswers = 1;
 
  +
window.addEventListener('DOMContentLoaded', function() {
 
  +
if (!window.answerQuills) return;
ANS( $expr->cmp() );
 
  +
answerQuills.$ansName.buttons.splice(-1, 0,
  +
{ id: 'leq', latex: '\\leq',
  +
tooltip: 'less than or equal (<=)',
  +
icon: '\\leq' },
  +
{ id: 'geq', latex: '\\geq',
  +
tooltip: 'greater than or equal (>=)',
  +
icon: '\\geq' });
  +
});
  +
</script>
  +
END_SCRIPT
   
 
ENDDOCUMENT();
 
ENDDOCUMENT();
 
</pre>
 
</pre>
<td style="background-color:#eeccff;padding:7px;">
+
<td style="background-color:#ffcccc;padding:7px;">
 
<p>
 
<p>
<b>Answer Evaluation:</b>
+
<b>Main Text:</b>
As is the answer.
+
Insert all of your problem text using $ansName for the answer name. Both the PGML and basic PG usage are demonstrated. Your problem should only use one of these. If you are not using PGML you should make the switch!
  +
</p>
  +
<p>
  +
An example of a possible usage of the named answer rule is shown. Here we add "greater than or equal to" and "less than or equal to" buttons to the MathQuill toolbar for the answer. This will only have effect if MathQuill is enabled for the course.
 
</p>
 
</p>
 
</td>
 
</td>
 
</tr>
 
</tr>
  +
 
</table>
 
</table>
   
Line 104: Line 113:
   
 
[[Category:Problem Techniques]]
 
[[Category:Problem Techniques]]
 
 
<ul>
 
<li>POD documentation: [https://webwork.maa.org/pod/pg/current/nameOfMacro.html nameOfMacro.pl]</li>
 
<li>PG macro: [https://github.com/openwebwork/pg/blob/master/macros/nameOfMacro.pl nameOfMacro.pl]</li>
 
</ul>
 

Latest revision as of 16:19, 6 May 2021

Name Answer Rules


This PG code shows how to used named answers in problems in such a way that the problem will work in both homework and gateway quizzes. Note that this is an insertion, not a complete PG file. This code will have to be incorporated into the problem file on which you are working.

Problem Techniques Index

PG problem file Explanation
DOCUMENT();
loadMacros(
"PGstandard.pl",
"MathObjects.pl",
"PGML.pl"
);
TEXT(beginproblem());

Initialization: The usual stuff here.

$ans = Compute(random(1, 5));

$ansName = NEW_ANS_NAME;

Setup: Create the answers and do the usual setup.

Generate an answer name to use. This answer name can now be used via the variable $ansName as needed to do whatever it is that you needed the answer name for. It will be the id of the html input for the answer name, and so can be used to do things with the html input via javascript, etc.

Many older problems just used a made up answer. That method will not work in gateway quizzes as it lacks the quiz prefix. The NEW_ANS_NAME method will give you an answer name that contains the quiz prefix if the problem is used in a gateway quiz.

# PGML usage
BEGIN_PGML
Enter [`[$ans]`]: [_]{$ans}{5}{$ansName}
END_PGML

# Basic PG usage (prefer PGML)
BEGIN_TEXT
Enter \($ans\): \{$ans->named_ans_rule($ansName, 5)\}
END_TEXT
LABELED_ANS($ansName, $ans->cmp);

# Add 'less than or equal' and 'greater than or equal' MathQuill toolbar buttons.
TEXT(MODES(TeX => "", HTML => <<END_SCRIPT));
<script>
window.addEventListener('DOMContentLoaded', function() {
    if (!window.answerQuills) return;
    answerQuills.$ansName.buttons.splice(-1, 0,
        { id: 'leq', latex: '\\leq',
            tooltip: 'less than or equal (<=)',
            icon: '\\leq' },
        { id: 'geq', latex: '\\geq',
            tooltip: 'greater than or equal (>=)',
            icon: '\\geq' });
});
</script>
END_SCRIPT

ENDDOCUMENT();

Main Text: Insert all of your problem text using $ansName for the answer name. Both the PGML and basic PG usage are demonstrated. Your problem should only use one of these. If you are not using PGML you should make the switch!

An example of a possible usage of the named answer rule is shown. Here we add "greater than or equal to" and "less than or equal to" buttons to the MathQuill toolbar for the answer. This will only have effect if MathQuill is enabled for the course.

Problem Techniques Index