Difference between revisions of "AnswerHints"
m |
Paultpearson (talk | contribs) (Add knowls as another way to implement hints.) |
||
Line 4: | Line 4: | ||
<div style="background-color:#eeeeee;border:black solid 1px;padding:3px;"> |
<div style="background-color:#eeeeee;border:black solid 1px;padding:3px;"> |
||
− | This PG code shows how to include |
+ | This PG code shows how to include three different kinds of answer hints: |
<ul type="square"> |
<ul type="square"> |
||
− | <li>General answer hints that help students get started on a problem and are |
+ | <li>General answer hints that help students get started on a problem and are always available via "Knowls".</li> |
− | <li> |
+ | <li>General answer hints that help students get started on a problem and are made available after a student has submitted an answer at least once (a "Show hints" checkbox appears near the "Submit Answers" button) via a <code>BEGIN_HINT / END_HINT</code> block of text.</li> |
+ | <li>Specific, customized answer hints that appear in the answer feedback messages box after a student submits a particular answer that activates a pre-programmed hint via the <code>answerHints.pl</code> macro and a post-filter with answer hints for the answer checker.</li> |
||
</ul> |
</ul> |
||
<br /> |
<br /> |
||
Line 75: | Line 75: | ||
BEGIN_TEXT |
BEGIN_TEXT |
||
If \( f(t) = $f \), then \( f(3u) \) = \{ ans_rule(10) \} |
If \( f(t) = $f \), then \( f(3u) \) = \{ ans_rule(10) \} |
||
+ | $BR |
||
+ | $BR |
||
+ | \{ |
||
+ | knowlLink("Click for a hint", |
||
+ | value=>'Substitute 3u wherever you see t in the formula for f.') |
||
+ | \} |
||
END_TEXT |
END_TEXT |
||
Line 91: | Line 97: | ||
<p> |
<p> |
||
<b>Main Text:</b> |
<b>Main Text:</b> |
||
− | We set <code>$showHint = 5;</code> and tell the students in the problem text that they will see a hint after 5 attempts. |
||
+ | Knowls (little bits of knowledge) provide an always present link to a hint that, when clicked on, expands to reveal the hint or, when clicked on again, retracts to hide the hint. No special macros are needed for Knowls. |
||
− | We include a general answer hint in the block of text between the commands <code>BEGIN_HINT</code> (which is <code>HINT(EV3(<<'END_HINT'));</code> in older versions of WeBWorK) and <code>END_HINT</code>, which must be on their own lines and at the start of a line. The hint will automatically generate the word <b>HINT:</b> before the block of text that is the hint, so you don't need to add it manually. The modification of the context from <code>texStrings</code> and back to <code>normalStrings</code> ensures that MathObjects (formulas, etc.) will be beautifully typset. |
||
+ | </p> |
||
+ | <p> |
||
+ | For hints that are revealed to students only after a certain number of submissions, we set <code>$showHint = 5;</code> and tell the students in the problem text that they will see a hint after 5 attempts. |
||
+ | We include a general answer hint in the block of text between the commands <code>BEGIN_HINT</code> (which is <code>HINT(EV3(<<'END_HINT'));</code> in older versions of WeBWorK) and <code>END_HINT</code>, which must be on their own lines and at the start of a line. The hint will automatically generate the word <b>HINT:</b> before the block of text that is the hint, so you don't need to add it manually. The modification of the context from <code>texStrings</code> and back to <code>normalStrings</code> ensures that MathObjects (formulas, etc.) will be beautifully typset. No special macros are needed for hints inside of <code>BEGIN_HINT</code> and <code>END_HINT</code> text blocks. |
||
</p> |
</p> |
||
</td> |
</td> |
Revision as of 21:07, 27 June 2014
Answer Hints
This PG code shows how to include three different kinds of answer hints:
- General answer hints that help students get started on a problem and are always available via "Knowls".
- General answer hints that help students get started on a problem and are made available after a student has submitted an answer at least once (a "Show hints" checkbox appears near the "Submit Answers" button) via a
BEGIN_HINT / END_HINT
block of text. - Specific, customized answer hints that appear in the answer feedback messages box after a student submits a particular answer that activates a pre-programmed hint via the
answerHints.pl
macro and a post-filter with answer hints for the answer checker.
You may also be interested in ErrorMessageCustomization
PG problem file | Explanation |
---|---|
DOCUMENT(); loadMacros( "PGstandard.pl", "MathObjects.pl", "answerHints.pl", ); TEXT(beginproblem()); |
Initialization:
We need to include the macros file |
Context("Numeric"); Context()->variables->are(t=>"Real",u=>"Real"); $f = Formula("2 t"); $answer = Formula("6 u"); |
Setup:
We restrict the variables to |
Context()->texStrings; BEGIN_TEXT If \( f(t) = $f \), then \( f(3u) \) = \{ ans_rule(10) \} $BR $BR \{ knowlLink("Click for a hint", value=>'Substitute 3u wherever you see t in the formula for f.') \} END_TEXT $showHint = 5; BEGIN_TEXT $PAR If you don't get this in $showHint tries, you can get a hint. END_TEXT BEGIN_HINT Substitute \( 3u \) wherever you see \( t \) in the formula for \( f(t) = $f \). END_HINT Context()->normalStrings; |
Main Text: Knowls (little bits of knowledge) provide an always present link to a hint that, when clicked on, expands to reveal the hint or, when clicked on again, retracts to hide the hint. No special macros are needed for Knowls.
For hints that are revealed to students only after a certain number of submissions, we set |
$showPartialCorrectAnswers = 1; ANS($answer->cmp()->withPostFilter(AnswerHints( Formula("6 t") => "Are you using the correct variable?", Formula("6 u") => "Good work!", ))); |
Answer Evaluation:
To generate specific, customized answer hints for particular answers, we use the If the same error message should be given for several different answers, you should make a square bracketed list of those answers. For example, if the variables x, t, and u were all in the context, we could use ANS($answer->cmp()->withPostFilter(AnswerHints( [Compute("6 t"),Compute("6 x")] => "Are you using the correct variable?", )));
If the MathObjects answer evaluator normally generates a message, the default is not to change a message that is already in place. To override a message generated by a MathObjects answer evaluator, you should set ANS($answer->cmp()->withPostFilter(AnswerHints( Compute("6 u") => ["Good work!",replaceMessage=>1], ))); |
- POD documentation: answerHints.pl.html
- PG macro code: answerHints.pl
- POD documentation: problemPanic.pl.html
- PG macro code: problemPanic.pl