3.5 Gapped Lecture Notes

Some modules use gapped lecture notes. BookML does not support these gaps in any functional way. In this section, we give guidance for how this style of teaching can be adapted for accessibility.

3.5.1 Provide full notes

Your BookML notes should provide the full content of the lecture. These full lecture notes can be provided as supplementary material for the gapped notes.

3.5.2 Foldable Environments

With gapped notes, sometimes proofs and solutions are given in a gap, for the student to write down themself. While BookML does not natively replicate this (though may be possible using .html), the use of a drop-down (as seen in the figure) can replicate this.

Proof

…details of the proof…

Figure 3.6: Click the word "proof" to interact (HTML only)

The following code will produce a foldable environment in the html notes (stylised as above), and a gap in the pdf notes produced by BookML.

\iflatexml
\<DETAILS>
  \<SUMMARY>\textbf{Proof}\</SUMMARY>
  ...details of the proof...
\</DETAILS>
\else
 %LaTeX used to create gaps
\fi

Note: To change the style of the drop-down to be more visually appealing, you can use a .css file in the folder bmluser).

3.5.3 Input Environments

You may feel that providing an input environment (i.e. a textbox in which the user can type) is an appropriate equivalent to gapped notes.

Figure 3.7: An input environment in BookML

Note that input environments do not save when the student navigates away from the page (or when they navigate to another part of the document). To produce an input environment, we use the following code:

\iflatexml
    \<INPUT>  \</INPUT>
\else
    %LaTeX to produce gaps
\fi