# AnswerFormatHelp

Jump to: navigation, search

## Answer Format Help Links

This PG code shows how to add answer format help links to problems.

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

Initialization: We need to include the macros file `AnswerFormatHelp.pl`.

```Context("ImplicitPlane")->variables->are(x=>"Real",y=>"Real");

\$answer = ImplicitPlane("x+y=2");
```

Setup: By declaring there are only two variables, `ImplicitPlane` will address objects as lines rather than planes.

```BEGIN_TEXT
Enter an equation for a line through the points
\( (0,2) \) and \( (2,0) \).
\$BR
\$BR
\{ ans_rule(20) \}
\{ AnswerFormatHelp("equations") \}
END_TEXT
```

Main Text: We use `AnswerFormatHelp("equations")` to generate a link to an html help file with link text `help (equations)`. The html help files are specifically designed to help students figure out the correct syntax for their answer, as well as common mistakes to avoid. We recommend placing a help link immediately after each answer blank in a problem, especially if there are different types of answers. Currently, help files are available for

• angles
• decimals
• exponents
• formulas
• fractions
• inequalities
• intervals
• logarithms
• limits
• numbers
• points
• syntax
• units
• vectors

It is possible to change the link text to `help entering equations` by including a second argument to the routine:

```\{ AnswerFormatHelp("equations","help entering equations") \}
```

It is possible to provide a link to an external help file using `\{ htmlLink("http://someplace.edu/help.html") \}`. We do not recommend this as it requires external files be maintained and links not become broken (especially when the server changes or moves). Instead of using a link to an external help file, use the method described at the bottom of this page.

```\$showPartialCorrectAnswers = 1;

ANS( \$answer->cmp() );

ENDDOCUMENT();
```

Answer Evaluation:

Instead of using a link to an external file, use the following:

```HEADER_TEXT(<<END_HEADER_TEXT);
<script type="text/javascript">
<!--
function openhelpCustom1() {
OpenWindow=window.open("","answer_format_help","width=550,height=550,status=0,toolbar=0,location=0,menubar=0,directories=0,resizeable=1,scrollbars=1");
OpenWindow.document.write("<title>Help With Something</title>")
OpenWindow.document.write("<body bgcolor='#ffffff'>")
OpenWindow.document.write("<center><h2>Help With Something</h2></center>")
OpenWindow.document.write("<ul>")
OpenWindow.document.write("<li><font color='#222255'>Header:</font><blockquote>Explanation   <code>pi/3</code></blockquote></li>")
OpenWindow.document.write("<li><font color='#222255'>Header:</font><blockquote>Explanation   <code>pi/3</code></blockquote></li>")
OpenWindow.document.write("</ul>")
OpenWindow.document.write("</body>")
OpenWindow.document.write("</html>")
OpenWindow.document.close()
self.name="main"
if (window.focus) {OpenWindow.focus()}
return false;
}
-->
</script>
END_HEADER_TEXT

BEGIN_TEXT

\{ htmlLink("#","help (something)","onClick='openhelpCustom1()';") \}
END_TEXT
```