Skip to main content

Section 15.2 Example-Like Elements

PreTeXt provides three closely-related tags for things that are examples or similar. They are <example>, <problem>, and <question>. They all have the same syntax. The <title> element is optional, but encouraged as discussed in Best Practice 3.5.1. You may either use a freeform example, as shown in Listing 15.2.1, or an example structured with a <statement> and zero or more <hint>s, <answer>s, and <solution>s (in that order). This is illustrated in Listing 15.2.3. Note that for HTML output, if your <example> has a <solution>, the solution will be hidden in a knowl, and the publisher does not (as of summer 2021) have the option of not knowling the solution.

<example>
  <title>Differentiating a polynomial</title>
  <p>
    The derivative of the function
    <m>f(x) = 3x^5-7x+5</m> is <m>f'(x) = 15x^4-7</m>.
  </p>
</example>
Listing 15.2.1. A simple example

The code in Listing 15.2.1 produces the following output:

The derivative of the function \(f(x) = 3x^5-7x+5\) is \(f'(x) = 15x^4-7\text{.}\)

If you are reading this in HTML with the default processing options applied, the example above will be knowled. This is the PreTeXt default only so that authors know that knowls exist. See Section 27.2 for information on changing this behavior.

<example>
  <title>Differentiating a polynomial</title>
  <statement>
    <p>
      Differentiate the function <m>f(x) = 3x^5-7x+5</m>.
    </p>
  </statement>
  <answer>
    <p>
      <m>f'(x) = 15x^4-7</m>
    </p>
  </answer>
  <solution>
    <p>
      We use the power, sum,
      and constant multiple rules and find that the derivative is <m>f'(x) = 15x^4-7</m>.
    </p>
  </solution>
</example>
Listing 15.2.3. A structured example

The code in Listing 15.2.3 produces the following output:

Differentiate the function \(f(x) = 3x^5-7x+5\text{.}\)

Answer.

\(f'(x) = 15x^4-7\)

Solution.

We use the power, sum, and constant multiple rules and find that the derivative is \(f'(x) = 15x^4-7\text{.}\)