Chapter 3 Diagrams

Graphics done in TikZ are converted like this:

ABCD

In fact, does not properly convert this picture.

Another way to generate and include diagrams that works with BookML (only) is by surrounding the diagram in a bmlimage environment. It then gets converted into an SVG image with an ALT tag using \bmlDescription, which should read “Four shapes: the first shape is a grey circle labelled A, the second a grey square labelled B, the third a white circle labelled C, and the fourth a white square labelled D.”

Four shapes: the first shape is
a grey circle labelled A, the second a grey square labelled B, the
third a white circle labelled C, and the fourth a white square
labelled D.

We’ve chosen to just fix the TikZ code to make the diagram come out right, and display it as inline SVG:

BookML advertises that image descriptions can be added using the \blmDescription command, but that doesn’t seem to work. A solution is to wrap the figure in a div with aria-label set, which we’ve done.