3 Exercises

Use the class option british, english, french, etc, and load the babel package. Unfortunately, passing the language as an option to the babel package itself can crash LaTeXMLLaTeXML. Make sure to use class options for the time being, just as in the template.

After loading the hyperref package, add:

This type of change goes into GNUmakefile. If you do not have one, fish it out of the bookml folder. Add the following line somewhere (normally before include bookml/bookml.mk):

or, to avoid splitting altogether,

LaTeXMLLaTeXML splits by either section or chapter by default, depending on the document class.

Wrap the block within

This generates a ‘BookML image’, i.e. an image compiled via LaTeXLaTeX and converted to SVG without LaTeXMLLaTeXML seeing what it is. To divert all TikZ pictures, add the following to your preamble, after loading TikZ.

You may as well hide TikZ completely from LaTeXMLLaTeXML to save about 30 seconds using

When using \includegraphics, add the alt={} key:

For TikZ pictures, and any other picture, use:

This also works for BookML images. There must be no other content between the picture and \bmlDescription (sometime even an empty space can cause issues).

BookML supports adding HTML tags by roughly typing them as is.

The rules are:

• •
  ​

  the initial <> must be preceded by a backslash \<;

• •
  ​

  each tag MUST be closed, so <br> must be written as \<br/> (or \<br>\</br>, but let people see that);

• •
  ​

  attributes must have quoted values, so allowfullscreen must become allowfullscreen="";

• •
  ​

  TeXTeX special characters like &, %, # must be prefixed with a backslash too.

This mechanism is a little fragile, due to the mismatch between LaTeXMLLaTeXML internal model and HTML, so use it only when LaTeXLaTeX cannot help: foldable environments and videos.

In the preamble, add

In the document,

You should probably create an environment that does all of that for you, and possibly add some custom styling (either using supported LaTeXLaTeX packages like framed, or by adding your own CSS to the bmluser folder).

Adopt the same strategy you normally use. My tip for working with BookML is that you create two files. For instance, create a secondary file exercises-without-solutions.tex like the following:

In exercises-with-solutions.tex, check if \withoutSolutions is defined to decide if solutions must be included or not. Then BookML will compile both files to separate SCORM packages. For instance:

You need to ingredients: \iflatexml allows you to run different code for PDF and HTML outputs, but you also need to access \iflatexml before even calling \documentclass! Do as follows:

I’ll just post an example here taken from the BookML tests:

The functionality comes from the latexml.sty package, which is automatically available when running BookML.

Here, neither LaTeXMLLaTeXML nor MathJax can definitely guess that $\phi$ is a function as opposed to a number being multiplied. LaTeXMLLaTeXML usually infers that this is a multiplication. Looking at ‘Show Math As > MathML Code’, you can see that there are different ‘invisible operators’, all of which were guessed by LaTeXMLLaTeXML.

To ensure that LaTeXMLLaTeXML treats a symbol as a function, wrap it in \lxFcn:

Creating your own macros is recommended:

LaTeXMLLaTeXML allows you to customise its maths parsing more deeply, and for instance declare that the command \phi itself is a function. However, it requires some pretty good knowledge of how LaTeXMLLaTeXML parses mathematical content.